O que é um webhook?

É um aviso automático enviado pelo Atentus ao seu sistema. Em vez de o CRM perguntar repetidamente se uma mensagem foi entregue, o Atentus avisa quando o status muda.

Exemplo prático

Você envia uma cobrança. Quando o WhatsApp confirmar a leitura, o Atentus faz um POST para a URL cadastrada e o CRM pode marcar “cliente leu a mensagem”.

{
  "event": "message.read",
  "timestamp": "2026-08-05T12:00:00.000Z",
  "data": {
    "messageId": "ID_DA_MENSAGEM",
    "instance": "atendimento",
    "status": "READ"
  }
}

Como confiar no aviso?

O cabeçalho X-Atentus-Signature contém uma assinatura HMAC-SHA256. Seu sistema calcula a mesma assinatura usando o segredo mostrado ao cadastrar o webhook. Se os valores forem iguais, o conteúdo é autêntico.

Como evitar processamento duplicado?

Guarde o valor de X-Atentus-Delivery. Se o mesmo identificador chegar novamente, responda HTTP 200 sem executar a ação uma segunda vez.

Exemplo de endpoint no seu sistema

Neste exemplo em Node.js/Express, o CRM recebe o aviso e confirma com HTTP 200. Em produção, o desenvolvedor também deve calcular e comparar a assinatura recebida.

app.post('/webhooks/atentus', express.json(), async (req, res) => {
  const evento = req.body;
  const entregaId = req.get('X-Atentus-Delivery');
  const assinatura = req.get('X-Atentus-Signature');

  // Validar assinatura, impedir duplicidade e atualizar o CRM.
  if (evento.event === 'message.read') {
    await crm.marcarMensagemComoLida(evento.data.messageId);
  }

  res.sendStatus(200);
});

Como testar sem esperar uma mensagem?

Depois de cadastrar o webhook, clique em Testar. O Atentus enviará um evento de teste para a URL e mostrará o resultado em “Entregas de webhook”.

Quando o Atentus tenta novamente?

Se sua URL estiver indisponível ou não responder com sucesso, a entrega entra no histórico com o erro e é tentada novamente conforme a política configurada.