Enviar mensagem livre

POST

/api/send/message

Envia uma mensagem de texto livre para um contato do WhatsApp. Se o contato não existir, ele será criado automaticamente.

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": "+5511999990000",
    "message": "Olá! Como posso ajudar?",
    "from": "5511988887777",
    "type": "text",
    "first_name": "João",
    "last_name": "Silva",
    "header": "Confirmação",
    "footer": "Responda abaixo",
    "buttons": [
        {
            "type": "reply",
            "reply": {
                "id": "sim",
                "title": "Sim"
            }
        },
        {
            "type": "reply",
            "reply": {
                "id": "nao",
                "title": "Não"
            }
        }
    ]
}

Exemplos de Requisição

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://titov.com.br/api/send/message' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "phone": "+5511999990000",
    "message": "Olá! Como posso ajudar?",
    "from": "5511988887777",
    "type": "text",
    "first_name": "João",
    "last_name": "Silva",
    "header": "Confirmação",
    "footer": "Responda abaixo",
    "buttons": [
        {
            "type": "reply",
            "reply": {
                "id": "sim",
                "title": "Sim"
            }
        },
        {
            "type": "reply",
            "reply": {
                "id": "nao",
                "title": "Não"
            }
        }
    ]
}'

Respostas

🟢200Success

application/json

Mensagem enviada com sucesso

Body

Exemplo

{
    "statusCode": 200,
    "data": {
        "uuid": "abc123",
        "type": "outbound",
        "status": "delivered",
        "wam_id": "wamid.xxx"
    }
}

🟠400

Modificado em 2026-03-09 16:16:13