Skip to main content
POST
https://api.enviaai.app
/
v1
/
messages
/
template
Enviar Template
curl --request POST \
  --url https://api.enviaai.app/v1/messages/template \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "instanceId": "<string>",
  "to": "<string>",
  "template": {},
  "template.name": "<string>",
  "template.language": "<string>",
  "template.components": [
    {}
  ]
}
'
{
  "success": true,
  "messageId": "msg_template123",
  "status": "queued"
}

​
Visão Geral

Templates são mensagens pré-aprovadas pela Meta. São obrigatórios na API Oficial para iniciar conversas ou enviar após 24h sem resposta do cliente.
Templates só funcionam com a API Oficial (Meta). Conexões via QR Code não suportam templates.

​
Request Body

​
instanceId
string
required
ID da instância (deve ser API Oficial)
​
to
string
required
Número do destinatário
​
template
object
required
Configuração do template
​
template.name
string
required
Nome do template aprovado
​
template.language
string
required
Código do idioma (ex: pt_BR)
​
template.components
array
Variáveis do template

​
Exemplo

await client.messages.sendTemplate({
  instanceId: 'inst_abc123',
  to: '5511999999999',
  template: {
    name: 'order_confirmation',
    language: 'pt_BR',
    components: [
      {
        type: 'body',
        parameters: [
          { type: 'text', text: 'João' },
          { type: 'text', text: '#12345' },
          { type: 'text', text: 'R$ 199,90' }
        ]
      }
    ]
  }
});

{
  "success": true,
  "messageId": "msg_template123",
  "status": "queued"
}

​
Tipos de Componentes

{
  "type": "header",
  "parameters": [
    { "type": "image", "image": { "link": "https://..." } }
  ]
}

​
Body

{
  "type": "body",
  "parameters": [
    { "type": "text", "text": "João" },
    { "type": "currency", "currency": { "code": "BRL", "amount_1000": 19990 } }
  ]
}

​
Button

{
  "type": "button",
  "sub_type": "url",
  "index": 0,
  "parameters": [
    { "type": "text", "text": "ORDER123" }
  ]
}

​
Criar Templates

Templates são criados no Meta Business Manager:
  1. Acesse Configurações do WhatsApp
  2. Vá em “Modelos de mensagem”
  3. Clique em “Criar modelo”
  4. Aguarde aprovação (geralmente 24h)

​
Erros Comuns

CódigoDescrição
template_not_foundTemplate não existe
template_not_approvedTemplate não aprovado
invalid_template_paramsParâmetros incorretos
official_api_requiredApenas API Oficial