01
Mapa de eventos que saem do WhatsApp para o CRM
O primeiro passo é decidir quais sinais do WhatsApp viram eventos de negócio no CRM. Nem tudo precisa ir: o que importa é o que move o funil ou aciona uma automação. Cada evento carrega um payload mínimo, suficiente para o CRM atualizar o contato, o deal e os campos customizados sem depender do histórico bruto de conversa.
| Evento | Quando dispara | Payload essencial |
|---|---|---|
| lead.created | Primeiro contato de um número ainda desconhecido | phone, name, source, first_message, timestamp |
| message.received | Mensagem do lead que muda o estado (não todas) | phone, intent, deal_id, channel, timestamp |
| lead.qualified | Lead respondeu critérios mínimos (orçamento, fit) | deal_id, score, budget, segment, owner |
| meeting.scheduled | Agendamento confirmado de call ou visita | deal_id, meeting_at, owner, calendar_link |
| deal.closed | Fechamento ganho ou perdido | deal_id, status, amount, reason, owner |
Repare que message.received aparece com filtro: só vira evento quando muda o estado do lead (uma intenção de compra, um pedido de orçamento, um aceite). Espelhar cada mensagem trocada no CRM é o caminho mais rápido para uma base impossível de ler.