Criar Webhook
- Vá para Configurações → APIs & Webhooks → Webhooks
- Clique em + Criar webhook
- Insira a URL do seu webhook (deve ser publicamente acessível)
- Clique em Salvar
Gerenciar Webhooks
Editar: Clique no webhook → Atualizar URL → Salvar Excluir: Clique no webhook → Excluir → ConfirmarEventos
O Twenty envia webhooks para estes tipos de eventos:
Todos os tipos de evento são enviados para a URL do seu webhook. A filtragem de eventos pode ser adicionada em versões futuras.
Formato do payload
Cada webhook envia um HTTP POST com um corpo JSON:Responda com um status HTTP 2xx (200-299) para confirmar o recebimento. Respostas não 2xx são registradas como falhas de entrega.
Validação de Webhook
O Twenty assina cada solicitação de webhook por segurança. Valide as assinaturas para garantir que as solicitações sejam autênticas.Cabeçalhos
Etapas de validação
- Obtenha o timestamp de
X-Twenty-Webhook-Timestamp - Crie a string:
{timestamp}:{JSON payload} - Calcule o HMAC SHA256 usando o segredo do seu webhook
- Compare com
X-Twenty-Webhook-Signature
Exemplo (Node.js)
Webhooks vs Fluxos de trabalho
Para receber dados externos, consulte Configurar um gatilho de Webhook.