Skip to main content

​
Visão Geral

O webhook de Nova Mensagem é enviado pela Morada.ai para o endpoint configurado pelo parceiro sempre que uma nova mensagem é registrada em uma conversa ativa.
Este webhook é enviado para uma URL configurada pelo parceiro. Você deve implementar um endpoint POST para recebê-lo.

​
Payload

{
  "event": "new_message",
  "dealId": "string",
  "message": {
    "from": "string",
    "to": "string",
    "body": "string",
    "timestamp": "string",
    "type": "text | image | document | audio | video"
  },
  "metadata": {
    "partnerId": "string",
    "channel": "whatsapp | webchat | instagram"
  }
}

​
Campos

CampoTipoDescrição
eventstringTipo do evento — sempre new_message
dealIdstringID do deal associado à conversa
message.fromstringRemetente da mensagem
message.tostringDestinatário da mensagem
message.bodystringConteúdo textual da mensagem
message.timestampstringData/hora do envio (ISO 8601)
message.typestringTipo da mídia: text, image, document, audio, video
metadata.partnerIdstringID do parceiro
metadata.channelstringCanal de origem: whatsapp, webchat, instagram

​
Resposta Esperada

Retorne um status HTTP 200 para confirmar o recebimento: 
{
  "received": true
}
Se o endpoint retornar um status diferente de 2xx, a Morada.ai tentará reenviar o webhook até 3 vezes com intervalo exponencial.