Os webhooks permitem que o Scribe notifique seus próprios sistemas no momento em que algo acontece no seu espaço de trabalho: uma conversão é registrada, uma assinatura é publicada, um membro da equipe entra ou sai, uma campanha é lançada. Em vez de suas ferramentas pedirem atualizações ao Scribe, o Scribe as envia — instantaneamente.
É assim que as equipes sincronizam conversões geradas por assinatura com o CRM, alertam o TI quando uma assinatura falha ao ser instalada em uma caixa de correio ou espelham alterações de membros da equipe em sistemas internos.
Os webhooks fazem parte da API do Scribe e exigem um plano com acesso à API. Apenas proprietários e administradores do espaço de trabalho podem gerenciá-los.
Como gerenciar seus webhooks
Abra Configurações → Webhooks (na seção Técnico). A página lista todos os endpoints configurados no seu espaço de trabalho, com os eventos aos quais cada um está inscrito e seu status atual.
Clique em Gerenciar webhooks para abrir o portal de webhooks do seu espaço de trabalho, onde você pode:
- Adicionar endpoints — registre qualquer URL HTTPS que seus sistemas exponham ou a URL de uma ferramenta de automação.
- Escolher eventos — inscreva um endpoint em tipos específicos de evento ou em todos.
- Inspecionar entregas — veja cada tentativa de entrega, sua resposta e reenvie as que falharam.
- Gerenciar segredos — cada endpoint tem um segredo de assinatura para que seus sistemas verifiquem que as notificações realmente vêm do Scribe.
As entregas com falha são repetidas automaticamente com intervalos crescentes por cerca de um dia, então uma breve indisponibilidade do seu lado não perde nada.
Para desenvolvedores
Está desenvolvendo o lado receptor? A documentação de webhooks para desenvolvedores cobre a verificação de assinaturas, a semântica de entrega e o catálogo completo de eventos com exemplos de payload.