curl --request POST \
--url https://api.blu.direct/v1/chats/{chat}/messages \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "text",
"text": {
"body": "Olá! Seu pedido saiu para entrega."
}
}
'{
"type": "text",
"text": {
"body": "<string>",
"preview_url": false
},
"id": "msg_Zt4b",
"object": "message",
"chat": "<string>",
"direction": "inbound",
"status": "accepted",
"errors": [
{
"code": "not_on_whatsapp",
"message": "<string>"
}
],
"context": {
"message_id": "<string>"
},
"broadcast": "<string>",
"pricing": {
"billable": true,
"category": "marketing"
},
"whatsapp_message_id": "<string>",
"created": 1760190012,
"metadata": {}
}{
"error": {
"type": "invalid_request_error",
"message": "<string>",
"request_id": "<string>",
"code": "outside_service_window",
"param": "text.body",
"doc_url": "<string>"
}
}{
"error": {
"type": "invalid_request_error",
"message": "<string>",
"request_id": "<string>",
"code": "outside_service_window",
"param": "text.body",
"doc_url": "<string>"
}
}Enviar uma mensagem
Envia uma mensagem na conversa. O corpo segue a API do WhatsApp Cloud:
defina type e o objeto de mesmo nome.
A mensagem é devolvida com status accepted e passa por sent,
delivered e read, informados pelos eventos message.updated.
Mensagens livres só podem ser enviadas até 24
horas depois da última mensagem do contato (service_window_expires_at
na conversa). Fora desse prazo, envie type: template ou a requisição
falha com outside_service_window.
curl --request POST \
--url https://api.blu.direct/v1/chats/{chat}/messages \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "text",
"text": {
"body": "Olá! Seu pedido saiu para entrega."
}
}
'{
"type": "text",
"text": {
"body": "<string>",
"preview_url": false
},
"id": "msg_Zt4b",
"object": "message",
"chat": "<string>",
"direction": "inbound",
"status": "accepted",
"errors": [
{
"code": "not_on_whatsapp",
"message": "<string>"
}
],
"context": {
"message_id": "<string>"
},
"broadcast": "<string>",
"pricing": {
"billable": true,
"category": "marketing"
},
"whatsapp_message_id": "<string>",
"created": 1760190012,
"metadata": {}
}{
"error": {
"type": "invalid_request_error",
"message": "<string>",
"request_id": "<string>",
"code": "outside_service_window",
"param": "text.body",
"doc_url": "<string>"
}
}{
"error": {
"type": "invalid_request_error",
"message": "<string>",
"request_id": "<string>",
"code": "outside_service_window",
"param": "text.body",
"doc_url": "<string>"
}
}Autorizações
Autentique com uma chave secreta (sk_live_…) ou uma chave restrita
(rk_live_…) criada no painel. Chaves restritas só têm as permissões
escolhidas na criação, como messages:send, chats:read ou
broadcasts:send.
Cabeçalhos
Uma chave única, como um UUID, que torna seguro repetir esta requisição por 24 horas.
255A versão da API a usar. Por padrão, é a versão fixada na sua conta.
"2026-10-11"
Parâmetros de caminho
^chat_Corpo
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
- Option 8
- Option 9
- Option 10
- Option 11
- Option 12
O conteúdo da mensagem. type indica o objeto que guarda o conteúdo, como na API do WhatsApp Cloud.
Resposta
A mensagem aceita.
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
- Option 8
- Option 9
- Option 10
- Option 11
- Option 12
O conteúdo da mensagem. type indica o objeto que guarda o conteúdo, como na API do WhatsApp Cloud.
"text"Show child attributes
Show child attributes
^msg_"msg_Zt4b"
"message"Expansível.
^chat_inbound, outbound Mensagens enviadas passam de accepted para sent, delivered e
read, ou terminam como failed. Mensagens recebidas ficam como received.
accepted, sent, delivered, read, failed, received Por que a mensagem ficou como failed. Vazio nos outros casos.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
A campanha que enviou esta mensagem, se houver. Expansível.
^bcast_Como a Meta cobra a mensagem. Preenchido em mensagens enviadas; nulo nas recebidas.
Show child attributes
Show child attributes
O id da mensagem no próprio WhatsApp.
Horário Unix em segundos.
1760190012
Até 50 pares de chave e valor seus. Chaves com até 40 caracteres e valores com até 500.
Show child attributes
Show child attributes