Enviar mensagem

Enfileira uma mensagem para envio pelo canal especificado. A requisição é processada de forma assíncrona — o requestId retornado pode ser usado para rastrear o status do envio.

POST /v1/messages

Enviar mensagem

cURL

curl --request POST \
  --url https://api.hadem.io/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "channelId": "ch_01abc123def456",
  "contact": {
    "value": "5511999999999",
    "type": "phone",
    "name": "João Silva"
  },
  "message": {
    "type": "text"
  },
  "flowId": "flow_01xyz789",
  "closeConversation": false
}
'

202

{
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

channelId · string · required

ID do canal pelo qual a mensagem será enviada

Example:

"ch_01abc123def456"

contact · object · required

Destinatário da mensagem

Show child attributes

message · object · required

Conteúdo da mensagem a ser enviada

Show child attributes

flowId · string

ID do fluxo de automação a ser iniciado após o envio

Example:

"flow_01xyz789"

closeConversation · boolean · default: false

Se verdadeiro, encerra a conversa após o envio

Example:

false

Response

202

application/json

Mensagem enfileirada com sucesso.

requestId · string<uuid>

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"