Enviar template

Envia um template aprovado pela Meta para um número de WhatsApp.

POSThttps://external-api.lip7.com.br/api/external/whatsapp/templates/send

Escopowhatsapp:sendAssíncrono — responde 202 com requestId

Por ser um envio, é assíncrono: responde 202 com requestId. Acompanhe em /usage/status/{requestId} ou por webhook.

Suporta o header Idempotency-Key — veja Idempotência.

Body

tostringobrigatório

Número do destinatário (DDI 55).

templateNamestringobrigatório

Nome do template aprovado.

languagestringopcionalpadrão pt_BR

Idioma do template. A Meta exige idioma no envio; se omitido, usamos pt_BR.

templateParamsobjectopcional

Variáveis do corpo do template. Os valores são enviados na ordem das chaves — use chaves numéricas em string ("1", "2", "3") para garantir a ordem.

templateButtonParamsarrayopcional

Preenche botões do tipo url ou quick_reply. Para botão url, o text é obrigatório; index segue o índice configurado no template.

Só templates aprovados

A Meta exige que o template esteja com status APPROVED para ser enviado. Consulte o status em Listar templates.

Requisição

curl -X POST "https://external-api.lip7.com.br/api/external/whatsapp/templates/send" \
  -H "Content-Type: application/json" \
  -H "x-api-key: lip_SUA_CHAVE" \
  -d '{
    "to": "5511999999999",
    "templateName": "boas_vindas",
    "language": "pt_BR",
    "templateParams": {
      "1": "Maria",
      "2": "LIP"
    },
    "templateButtonParams": [
      { "subType": "url", "index": 0, "text": "123456" }
    ]
  }'

const response = await fetch(
  'https://external-api.lip7.com.br/api/external/whatsapp/templates/send',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'lip_SUA_CHAVE',
    },
    body: JSON.stringify({
      to: '5511999999999',
      templateName: 'boas_vindas',
      language: 'pt_BR',
      templateParams: { 1: 'Maria', 2: 'LIP' },
      templateButtonParams: [{ subType: 'url', index: 0, text: '123456' }],
    }),
  }
);

const data = await response.json();

import requests

response = requests.post(
    "https://external-api.lip7.com.br/api/external/whatsapp/templates/send",
    headers={
        "Content-Type": "application/json",
        "x-api-key": "lip_SUA_CHAVE",
    },
    json={
        "to": "5511999999999",
        "templateName": "boas_vindas",
        "language": "pt_BR",
        "templateParams": {"1": "Maria", "2": "LIP"},
    },
)

data = response.json()

Resposta

{
  "success": true,
  "data": {
    "requestId": "req_..."
  }
}