Skip to content
Para o administrador da conta › Para quem integra
Para quem integra

Template API

Disparar um template aprovado pela Meta a partir do seu sistema — inclusive fora da janela de 24 horas.

3 min de vídeo 11 imagens Painel do administrador
Aula gravada na plataforma real. O cursor, as legendas e o destaque existem só no vídeo.

A Template API dispara um template já aprovado pela Meta a partir do seu sistema. É a única forma de falar com quem não escreveu para você nas últimas 24 horas — e por isso é ela que carrega pedido enviado, código de confirmação e lembrete de consulta.

Tela da Template API
Desenvolvedor › Template API.
Pré-requisito
Exige template aprovado e chave de API.
API Key
A chave que autentica a chamada.

Nome e destino

Nome do template
O nome exato do template aprovado na Meta.
O nome é literalpedido_enviado e pedido-enviado são templates diferentes. Uma letra ou um traço fora do lugar e a Meta responde que o template não existe — o erro mais comum dessa integração.
Número de destino
Formato E.164: +5511999999999.

As variáveis

Variáveis
Os buracos do template, preenchidos em ordem.
Lista de variáveis
A primeira variável do texto é a primeira da lista.
A ordem é tudoSe o template diz Olá {{1}}, seu pedido {{2}} saiu para entrega e você inverte, o cliente recebe Olá 1234, seu pedido Maria saiu para entrega. Confira a ordem no próprio template antes de programar.
URL da mídia
URL da mídia, para templates com cabeçalho de imagem ou documento.
A URL precisa ser públicaQuem baixa o arquivo é a Meta, do servidor dela. Um link que só funciona dentro da sua rede, ou que exige login, resulta em template enviado sem a imagem.

Registrar e testar

Registrar nos logs
Registrar nos logs (enableLog) guarda a chamada.
Resposta da Meta
A resposta da Meta: aceita ou o motivo da recusa.
Fora da Heyoo
  1. Aprove o template no Gerenciador do WhatsApp Business.
  2. Abra Desenvolvedor › Template API.
  3. Cole o nome exato do template.
  4. Informe o número de destino em E.164.
  5. Preencha as variáveis na ordem.
  6. Se houver cabeçalho de mídia, informe a URL pública.
  7. Ligue Registrar nos logs e clique em Testar envio.
  8. Leia a resposta da Meta antes de levar para produção.