Skip to main content
Twenty envia um HTTP POST para sua URL sempre que um registro é criado, atualizado ou excluído. Todos os tipos de objeto estão cobertos, incluindo objetos personalizados.

Criar Webhook

  1. Vá para Configurações → APIs & Webhooks → Webhooks
  2. Clique em + Criar webhook
  3. Insira a URL do seu webhook (deve ser publicamente acessível)
  4. Clique em Salvar
O webhook é ativado imediatamente e começa a enviar notificações.

Gerenciar Webhooks

Editar: Clique no webhook → Atualizar URL → Salvar Excluir: Clique no webhook → Excluir → Confirmar

Eventos

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

  1. Obtenha o timestamp de X-Twenty-Webhook-Timestamp
  2. Crie a string: {timestamp}:{JSON payload}
  3. Calcule o HMAC SHA256 usando o segredo do seu webhook
  4. Compare com X-Twenty-Webhook-Signature

Exemplo (Node.js)

Webhooks vs Fluxos de trabalho

Para receber dados externos, consulte Configurar um gatilho de Webhook.