Webhooks

O MIX CRM dispara eventos HTTPS para a URL que você configurar quando algo importante acontece: deal ganho, pessoa criada, mensagem nova no inbox. Sem polling, latência típica abaixo de 2 segundos.

Como funciona

1. Você cria um endpoint público HTTPS no seu servidor que aceite POST com JSON.
2. No MIX, vá em Configurações → Webhooks → Saída e adicione esse endpoint, escolhendo quais eventos quer receber.
3. O MIX envia POST para sua URL toda vez que esses eventos acontecem, com header X-Manu-Signature assinado em HMAC-SHA256.
4. Você verifica a assinatura, processa o evento, retorna 200.

Envelope do payload

Todo evento chega no mesmo formato, um envelope com metadata mais um data específico do tipo:

{
  "id": "evt_2qXJk8AbCdEf...",
  "type": "deal.won",
  "tenantId": "1f0c87e8-...",
  "occurredAt": "2026-05-03T14:30:00Z",
  "data": {
    "dealId": "ad8e3f9b-..."
  }
}

• id: ID único do evento. Use pra deduplicar (mesmo evento pode chegar mais de uma vez em retries).
• type: nome canônico do evento. Veja catálogo.
• tenantId: workspace que disparou. Útil se você tem um servidor recebendo de múltiplos workspaces.
• occurredAt: momento real do evento (não da entrega). ISO 8601 UTC.
• data: payload específico. Cada evento documenta seu shape no catálogo.

Retry e ordering

• Retries: se sua URL retorna não-2xx ou demora mais que 10s, o MIX tenta de novo em 1s, 5s, 30s, 5min, 30min (5 tentativas no total).
• Após 5 falhas: o webhook é desativado e você recebe um e-mail. Reativar manualmente em Configurações.
• Ordem não garantida: múltiplos eventos podem chegar fora de ordem (especialmente em retries). Use occurredAt se a ordem importa.
• At-least-once: mesmo evento pode chegar duas vezes. Sempre dedupe por id.

Próximos passos