Cada mensagem e status do WhatsApp batendo no seu servidor

Enviar mensagem é metade do trabalho. A outra metade é reagir: responder o que o cliente mandou, marcar a mensagem como entregue no seu CRM, avisar quando a sessão caiu. No Loce Zap isso chega por webhook: você configura uma URL por sessão e os eventos batem no seu servidor em tempo real.

Os eventos que você recebe

• ▸MESSAGE-RECEIVED: mensagem recebida (texto, mídia, reação a caminho de você).
• ▸MESSAGE-SENT, MESSAGE-DELIVERED, MESSAGE-READ: o ciclo de status de cada envio.
• ▸MESSAGE-EDITED, MESSAGE-DELETED, REACTION-MESSAGE: edições, exclusões e reações.
• ▸SESSION-CONNECTED e SESSION-DISCONNECTED: o estado da conexão do número, pra você reagir na hora.

O corpo é sempre o mesmo formato: você roteia pelo type.

{
  "apiKey": "sua-api-key",
  "sessionId": "minha-sessao",
  "type": "MESSAGE-RECEIVED",
  "payload": { /* dados do evento */ }
}

Assinatura: saiba que fomos nós

Cada requisição vai com os headers x-locezap-signature (formato t=timestamp,v1=hash, no mesmo estilo do Stripe) e x-locezap-timestamp. O hash é um HMAC SHA-256 de timestamp.corpo com o seu secret: dá pra validar que o evento veio da gente e não é replay.

Entrega resiliente por padrão

• ▸Fila dedicada (RabbitMQ): pico de mensagens não vira webhook perdido.
• ▸Falha transitória (rede, timeout, 5xx, 429): re-tentamos até 10 vezes.
• ▸Seu endpoint respondeu 4xx? Descartamos e registramos no log, sem martelar seu servidor.
• ▸Todo evento vira log consultável no painel: status, resposta do seu endpoint e payload.
• ▸Perdeu um evento? Reenvio manual com um clique (ou via POST /v1/webhook-logs/:id/resend).

Por plano

Ou seja: dá pra montar um bot de resposta inteiro no plano grátis. Preços em /precos.