Webhooks de saída e histórico de entregas
Envia eventos da plataforma para um servidor externo, com assinatura e histórico de tentativas. Serve para integrar sistemas próprios sem consultar a plataforma continuamente.
Abra Configurações > Webhooks com perfil autorizado.
- Abra Configurações > Webhooks com perfil autorizado.
O guia em texto
Mesmo conteúdo do player, para ler no seu ritmo.
Passo 1: Abra Configurações > Webhooks com perfil autorizado.
- Abra Configurações > Webhooks com perfil autorizado.
Passo 2: Cadastre um endpoint HTTPS público controlado pela sua empresa.
- Cadastre um endpoint HTTPS público controlado pela sua empresa.
Passo 3: Escolha os eventos e filtros de canal
- Escolha os eventos e filtros de canal. Eventos sem canal, como alguns eventos de CRM/campanha, têm comportamento próprio descrito na tela.
Passo 4: Configure cabeçalhos necessários sem compartilhar segredos em mensagens de atendimento.
- Configure cabeçalhos necessários sem compartilhar segredos em mensagens de atendimento.
Passo 5: Copie o segredo de assinatura para o responsável técnico configurar a validação de X-Webhook-Signature.
- Copie o segredo de assinatura para o responsável técnico configurar a validação de X-Webhook-Signature.
Passo 6: Salve/ative e use a ação de teste disponível.
- Salve/ative e use a ação de teste disponível.
Passo 7: Confira a entrega e a resposta do servidor antes de depender da integração.
- Confira a entrega e a resposta do servidor antes de depender da integração.
Passo 8: Como acompanhar
- Abra o histórico e filtre os resultados. Consulte tentativas e resposta do destino. Reentregar volta o evento para a fila; o sistema receptor deve tratar repetição corretamente. Se o endpoint for desativado automaticamente por falhas, corrija o destino antes de reativar.
Webhooks de saída e histórico de entregas
Disponibilidade: Perfis admin, master ou god.
Acesso de referência: /webhooks.
O que faz e quando usar
Envia eventos da plataforma para um servidor externo, com assinatura e histórico de tentativas. Serve para integrar sistemas próprios sem consultar a plataforma continuamente.
Como configurar
- Abra Configurações > Webhooks com perfil autorizado.
- Cadastre um endpoint HTTPS público controlado pela sua empresa.
- Escolha os eventos e filtros de canal. Eventos sem canal, como alguns eventos de CRM/campanha, têm comportamento próprio descrito na tela.
- Configure cabeçalhos necessários sem compartilhar segredos em mensagens de atendimento.
- Copie o segredo de assinatura para o responsável técnico configurar a validação de X-Webhook-Signature.
- Salve/ative e use a ação de teste disponível.
- Confira a entrega e a resposta do servidor antes de depender da integração.
Como acompanhar
Abra o histórico e filtre os resultados. Consulte tentativas e resposta do destino. Reentregar volta o evento para a fila; o sistema receptor deve tratar repetição corretamente. Se o endpoint for desativado automaticamente por falhas, corrija o destino antes de reativar.
Resultado esperado
O destino recebe e valida o evento, e a entrega tem resultado verificável no histórico.
Dúvidas frequentes
Assinei “todos os eventos”. Novos também entram? A interface informa que essa opção inclui eventos futuros automaticamente. Prefira seleção específica se o destino só deve receber alguns.
Rotacionei o segredo e parou. O segredo anterior deixa de valer; atualize o receptor para o novo.
Posso excluir e recriar para limpar um erro? Excluir remove endpoint e histórico segundo a confirmação. Primeiro corrija o destino e consulte as tentativas.
Limitações
Webhook de saída é diferente do gatilho de webhook que inicia um fluxo no Builder. A confirmação de fila não é confirmação de processamento pelo sistema externo.