Enviar template HSM

POST

/api/send/template

Enfileira o envio de um template aprovado pela Meta. É o único caminho para iniciar
conversa fora da janela de 24h.

Responde 202, não 200. Aprovação/rejeição do template pela Meta não é verificada
aqui — falhas aparecem só no processamento do job.

Use GET /api/templates-by-phone para descobrir templateId, name e os
placeholders (vars) de cada template disponível.

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",
    "templateId": "string",
    "name": "confirmacao_pedido",
    "from": "string",
    "vars": [
        "João",
        "12345"
    ],
    "type": "string",
    "link": "http://example.com"
}

Exemplos de Requisição

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://titov.com.br/api/send/template' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "phone": "+5511999999999",
    "templateId": "string",
    "name": "confirmacao_pedido",
    "from": "string",
    "vars": [
        "João",
        "12345"
    ],
    "type": "string",
    "link": "http://example.com"
}'

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

Próxima página

Enviar mensagem livre