Como configurar webhooks de saída

Permite Slack, Monday, sistema interno seu, etc., receberem eventos do Lefia em tempo real.

Configurar

No detalhe da empresa (/admin/empresa/[id]), seção Webhooks:

1. + Novo webhook
2. Preenche:

- Nome (ex: "Slack #integracoes")
- URL (HTTPS obrigatório)
- Eventos (toggle): message.received, message.sent, message.error, integration.test_success, integration.test_failure

1. Clica Criar

Secret

No momento da criação, o secret é mostrado uma única vez — copie e guarde. É usado pra você verificar autenticidade dos webhooks via header X-Lefia-Signature: sha256=<hmac> (o header legado X-Nexio-Signature segue sendo enviado em paralelo, com o mesmo valor, para integrações que ainda o verificam).

Verificação HMAC (Node.js exemplo)

import { createHmac, timingSafeEqual } from "node:crypto";

function verify(secret, body, signatureHeader) {
  const expected = createHmac("sha256", secret).update(body).digest("hex");
  const got = signatureHeader.replace(/^sha256=/, "");
  return timingSafeEqual(Buffer.from(expected), Buffer.from(got));
}

Painel

Lista mostra: deliveries, falhas, taxa de erro, última entrega, último erro inline.