Mapeamento de webhook genérico
Converta qualquer payload de CRM para o formato universal do HumanReply AI sem trocar o sistema de atendimento da empresa.
Campos esperados
Obrigatórios
external_conversation_idcustomer.namemessages[0].textmessages[0].sent_at
Opcionais
customer.phonecustomer.emailagent.emailmetadata.statusmetadata.prioritymetadata.tagsmetadata.department
Regras de mapeamento
| Origem no payload | Destino universal | Obrigatório | Exemplo | Ações |
|---|---|---|---|---|
| payload.ticket.id | external_conversation_id | Sim | ticket_987 | |
| payload.customer.name | customer.name | Sim | João Silva | |
| payload.message.body | messages[0].text | Sim | Boa tarde, ainda não tive retorno. | |
| payload.agent.email | agent.email | Não | amanda@empresa.com | |
| payload.ticket.status | metadata.status | Não | open | |
| payload.ticket.tags | metadata.tags | Não | cliente_ativo,suporte |
Payload recebido do CRM
{
"event": "message.received",
"provider": "generic_webhook",
"payload": {
"ticket": {
"id": "ticket_987",
"status": "open",
"priority": "high",
"tags": ["cliente_ativo", "suporte"]
},
"customer": {
"name": "João Silva",
"phone": "+5511999999999"
},
"message": {
"body": "Boa tarde, ainda não tive retorno.",
"sent_at": "2026-06-19T14:20:00-03:00"
}
}
}Formato universal gerado
{
"source": "generic_webhook",
"external_conversation_id": "ticket_987",
"channel": "whatsapp",
"customer": {
"name": "João Silva",
"phone": "+5511999999999"
},
"messages": [{
"sender_type": "customer",
"text": "Boa tarde, ainda não tive retorno.",
"sent_at": "2026-06-19T14:20:00-03:00"
}],
"metadata": {
"status": "open",
"priority": "high",
"tags": ["cliente_ativo", "suporte"]
}
}