Pular para o conteúdo principal
Os webhooks embedded notificam o seu servidor quando ocorre atividade de qualquer usuário final do seu projeto de parceiro. Cada payload identifica o usuário final afetado para que você possa direcioná-lo ao cliente correto.

Criar uma assinatura

Os endpoints de webhook devem usar HTTPS e ser acessíveis publicamente.
Omita events, ou passe um array vazio, para receber todos os eventos reconhecidos que ocorrerem para os seus usuários finais embedded.
Eventos úteis para uma integração de publicação embedded incluem:

Verificar a assinatura

O Social media studio assina o corpo exato da requisição HTTP bruta com HMAC-SHA256. Leia o corpo como texto ou bytes e verifique-o antes de interpretar o JSON.
A assinatura pode ser enviada como um digest hexadecimal ou com o prefixo v1=; o SDK aceita as duas formas.

Formato do payload

As requisições de entrega também incluem:

Comportamento da entrega

  • Retorne uma resposta 2xx assim que o evento for aceito de forma durável.
  • Processe os eventos de forma assíncrona quando o trabalho puder levar mais de alguns segundos.
  • Deduplique as entregas usando o id do payload ou X-Webhook-Delivery-Id.
  • Respostas diferentes de 2xx, falhas de rede e tempos limite são repetidos com espera exponencial.
  • Assinaturas que falham repetidamente são desativadas automaticamente.
A entrega de webhooks é “pelo menos uma vez”, portanto os handlers devem ser idempotentes.