Pular para o conteúdo
apiwpp
Termo

O que é template de mensagem

Template de mensagem é um texto salvo com variáveis, como {{nome}} e {{pedido}}, que o sistema reutiliza em cada envio preenchendo os valores. Na Cloud API da Meta, o template precisa de aprovação; na apiwpp, é uma mensagem salva, sem aprovação.

Atualizado em

Um template de mensagem é um texto salvo com lacunas, as variáveis, que o sistema preenche a cada envio. Em vez de escrever "Olá Maria, recebemos o seu pedido #1234" no código, você salva uma vez Olá {{nome}}, recebemos o seu pedido {{pedido}}. e, em cada envio, informa só o nome do template e os valores de nome e pedido.

O ganho é organização: o texto fica num lugar só, e ajustar uma palavra não exige mudar o código de cada sistema que envia aquela mensagem.

Dois significados de template no WhatsApp

A palavra aparece em dois contextos bem diferentes, e vale separar:

Na API oficial (a Cloud API da Meta), template é um modelo de mensagem cadastrado e aprovado pela Meta antes do uso. É por ele que a empresa inicia uma conversa ou fala com o cliente fora da janela de atendimento aberta pela última mensagem dele. Alterar o texto significa submeter de novo.

Na apiwpp, que conecta o número pelo protocolo do WhatsApp Web e é uma API não oficial, template é só uma mensagem salva com variáveis, uma conveniência para o seu sistema. Não há aprovação: o template vale assim que é criado e pode ser alterado a qualquer momento.

Template da apiwppTemplate da Cloud API
AprovaçãoNão precisaAprovado pela Meta antes do uso
Alterar o textoA qualquer momentoNova submissão para aprovação
Obrigatório para iniciar conversaNãoSim, fora da janela de atendimento
Onde ficaNa conexão (no número)Na conta do WhatsApp Business

Sem aprovação não quer dizer sem regras: mensagem é para quem espera recebê-la, e um template não muda o ritmo da fila nem o limite de destinatários novos por dia.

Exemplo na apiwpp

Crie o template uma vez na conexão com POST /connections/{id}/templates:

{ "name": "lembrete_consulta", "body": "Olá {{nome}}, lembrando do seu horário amanhã às {{hora}}. Responda se precisar remarcar." }

Depois, envie pelo nome no mesmo POST /connections/{id}/send de qualquer mensagem, com os valores em variables:

{ "to": "5511988887777", "template": "lembrete_consulta", "variables": { "nome": "Maria", "hora": "10h" } }

Se faltar alguma variável, a resposta é 400 com a lista em missingVariables, e nada entra na fila. Assim, nenhum cliente recebe um Olá {{nome}} pela metade. Outros usos comuns são a confirmação de pagamento de um pedido, o aviso de envio com o código de rastreio e o lembrete de vencimento para quem já é cliente.

Um template também pode levar uma mídia por URL https, como um PDF ou uma imagem, junto com o texto. A criação, a listagem, a alteração e a exclusão, com os escopos de cada chamada, estão em templates de mensagem com variáveis.

Perguntas frequentes

Preciso de aprovação da Meta para usar templates na apiwpp?

Não. Os templates da apiwpp são mensagens salvas com variáveis, sem relação com o processo de aprovação da Cloud API. Eles valem assim que são criados.

Posso usar um template aprovado na Cloud API dentro da apiwpp?

Não diretamente: são sistemas diferentes. Você pode criar na apiwpp um template com o mesmo texto e as mesmas variáveis e enviar por ele.

Os templates têm custo extra?

Não. Templates fazem parte dos planos LITE e PRO, sem cobrança por template nem por mensagem; o preço é por número conectado. Veja os preços.

WhatsApp Cloud API é a API oficial do WhatsApp para empresas, hospedada pela Meta como parte da WhatsApp Business Platform. Exige conta comercial, usa modelos de mensagem aprovados para iniciar conversas e é cobrada pela Meta por mensagem.

API não oficial do WhatsApp é um serviço que conecta um número comum pelo protocolo do WhatsApp Web, como um aparelho conectado, e expõe envio e recebimento de mensagens por HTTP. Não passa pela Meta: não exige aprovação, mas o número pode ser restringido.

Uma operação é idempotente quando repeti-la tem o mesmo efeito que fazê-la uma vez. Em APIs, isso se consegue com uma chave de idempotência: o cliente manda o mesmo identificador em cada tentativa e o servidor reconhece a repetição em vez de executar de novo.

Conecte seu primeiro número hoje.

7 dias grátis, sem cartão de crédito.