ChatSense
Integrações webhooks eventos payload hmac

Webhooks: eventos, payload JSON e verificação HMAC

Webhooks

Configurar

  1. Admin → Integrações → Webhooks → Novo Webhook
  2. URL de destino (deve responder POST com HTTP 200)
  3. Selecione os eventos
  4. Copie o Webhook Secret para validar assinaturas

Eventos disponíveis

EventoQuando dispara
message.createdNova mensagem recebida ou enviada
conversation.createdNova conversa iniciada
conversation.resolvedConversa resolvida
conversation.assignedConversa atribuída
contact.createdNovo contato criado
contact.updatedContato atualizado

Verificação HMAC-SHA256

Header enviado: X-ChatSense-Signature: sha256=HASH

const sig = crypto.createHmac('sha256', secret).update(rawBody).digest('hex');
const valid = `sha256=${sig}` === req.headers['x-chatsense-signature'];

Política de retry

Em caso de erro (não-2xx) ou timeout (>10s): 3 retentativas com backoff exponencial — 1min, 5min, 30min.