Enviar mensagem livre

POST

/api/send/message

Enfileira uma mensagem de texto (ou interativa com botões) para um número de WhatsApp.
Se o contato não existir, é criado automaticamente pelo job.

Responde 202, não 200 — a mensagem é enfileirada, não enviada de imediato.

O campo type é inferido quando omitido: interactive se buttons for enviado,
caso contrário text.

Requer uma janela de atendimento de 24h aberta com o contato. Fora dela, o WhatsApp
recusa a mensagem — mas isso ocorre no processamento do job, depois do 202 desta
resposta. Para iniciar conversa fora da janela, use POST /api/send/template.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Bodyapplication/jsonNecessário

Exemplo

{
    "phone": "+5511999999999",
    "message": "Olá! Seu pedido foi enviado.",
    "from": "string",
    "type": "text",
    "buttons": [
        "Sim",
        "Não"
    ],
    "header": "string",
    "footer": "string",
    "first_name": "string",
    "last_name": "string",
    "email": "string"
}

Exemplos de Requisição

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://titov.com.br/api/send/message' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "phone": "+5511999999999",
    "message": "Olá! Seu pedido foi enviado.",
    "from": "string",
    "type": "text",
    "buttons": [
        "Sim",
        "Não"
    ],
    "header": "string",
    "footer": "string",
    "first_name": "string",
    "last_name": "string",
    "email": "string"
}'

Respostas

🟢202Aceite

application/json

Aceito e enfileirado. Não confirma entrega — apenas que a mensagem entrou na fila.

Bodyapplication/json

Exemplo

{
    "status": "queued",
    "message_id": "e7c1a2b4-9d3f-4a5e-8b6c-0f1d2e3a4b5c"
}

🟠400Requisição Inválida

🟠401Não Autorizado

🟠429

🔴500Erro do Servidor

Modificado em 2026-07-17 11:51:13