Pular para o conteúdo principal
Os webhooks permitem criar ou configurar integrações que assinam eventos em tempo real do Social media studio. Quando um evento é disparado, enviamos um payload HTTP POST para a URL que você configurou, permitindo que o seu aplicativo reaja instantaneamente, sem precisar consultar a API repetidamente.

Noções básicas de configuração

Você pode configurar webhooks diretamente pelo painel, em Configurações > Webhooks, ou usando a nossa API. Cada webhook exige:
  • Uma URL de endpoint válida (HTTPS é fortemente recomendado).
  • Uma ou mais categorias de eventos que você deseja assinar.
O seu plano determina quantas assinaturas de webhook ativas você pode manter simultaneamente.

Exemplos de template de payload

Use payloadTemplate para personalizar o corpo JSON enviado ao seu endpoint. As variáveis de template disponíveis são:
  • {{event}}
  • {{category}}
  • {{timestamp}}
  • {{data}}
  • {{data.any_field}} (para campos aninhados específicos do evento)

1) Envelope JSON genérico

2) Payload adequado para o Discord

3) Payload no estilo Slack Block Kit

Se uma variável não existir nos dados do evento, o marcador permanece inalterado (por exemplo, {{data.postId}}).

Limites e retenção de webhooks

Dependendo do seu plano de assinatura, a retenção dos logs de entrega dos webhooks e o número de endpoints de webhook que você pode criar variam:

Eventos disponíveis

Oferecemos suporte a 162 eventos em 26 categorias. Ao assinar uma categoria, você recebe todos os eventos relacionados. Você também pode assinar eventos individuais para um controle mais fino.

Precisa inspecionar os payloads?

Os webhooks sempre entregam eventos mapeados para o nosso esquema oficial. Aprenda a verificar assinaturas e veja exemplos de payload de cada categoria de evento.