Templates da API oficial do WhatsApp: como criar e enviar para aprovação

Só para linhas em API Oficial (Cloud). Um template é uma mensagem pré-aprovada pela Meta — é o que permite iniciar conversa ou escrever fora da janela de 24h (disparos, lembretes, reativação). Você cria e envia os templates para aprovação direto no painel.

💸 O custo da Meta

Desde 01/10/2026 a Meta cobra cada mensagem pela categoria — e também as respostas (serviço) acima de 1.000 por mês por número, sejam da equipe ou da IA. As mensagens dentro de uma conversa vinda de anúncio são grátis. No ⚙️ API da linha oficial (e na aba 📋 Templates dos supervisores), o quadro 💸 Custo da Meta neste mês mostra:

• Respostas grátis do mês: quantas das 1.000 já foram usadas, com aviso quando faltam poucas e quando acabam.
• Grátis × cobradas por categoria (serviço, utilidade, marketing, autenticação, vindas de anúncio) — contadas pelo aviso de entrega de cada mensagem.
• O custo que a própria Meta calcula, na moeda da conta, e o do mês passado — só para o Proprietário. É lido de 6 em 6 horas; o botão ↻ Atualizar custo lê na hora. Exige o WABA ID da linha preenchido; se a conta é paga por um parceiro, a Meta não devolve o valor e ficam só as contagens.

Criar e submeter (no painel)

1. Abra 📡 Canais → 📱 Linhas → na linha cloud, ⚙️ API

   Role até 📋 Templates aprovados e clique em ➕ Criar template novo.

2. Preencha os campos

   Nome (só minúsculas, números e _), Categoria, Idioma (pt_BR) e o Corpo com variáveis {{1}}, {{2}}…

3. Dê um exemplo por variável

   Um valor real por linha, na ordem {{1}} → {{N}} — a Meta exige.

4. (Opcional) Cabeçalho, rodapé e botões

   No mesmo formulário você pode juntar um cabeçalho de texto ou imagem, um rodapé e até 3 botões (resposta rápida, link/URL ou ligar). O cabeçalho de imagem exige o App ID da linha preenchido (no mesmo ⚙️ API). Dica: a imagem que você envia aqui é só o exemplo para a Meta aprovar — no envio em massa dá para usar uma imagem diferente em cada campanha, sem aprovar de novo. Você aprova o template com imagem uma vez e reutiliza à vontade.

5. Enviar para a Meta

   Fica PENDING. A Meta revisa (de minutos a ~24h); clique em 🔄 Sincronizar da Meta para ver quando ficar APPROVED.

As regras da Meta (siga e o template é aprovado)

Usar o template aprovado

• Disparos automáticos (agendados, envio em massa, reativação) fora das 24h usam o template de fallback da linha — escolha-o no mesmo ⚙️ API.
• No chat, fora das 24h, aparece o botão 📋 Template para reabrir a conversa com um aprovado.
• Botões interativos no chat: dentro das 24h, numa linha oficial, o botão 🔘 Botões envia até 3 opções clicáveis ao cliente.
• 🕐 Contador da janela de 24h: no compositor da conversa oficial há um chip com o tempo restante da janela (renova a cada mensagem do cliente; fica âmbar a <3h e vermelho a <1h). Quando expira, vira ⛔ Janela fechada — usa 📋 Template (clicável) — assim o atendente vê antes que o envio falhe, em vez de descobrir no erro.

📞 Chamadas de voz (linha oficial)

Linhas oficiais com limite de pelo menos 2.000 conversas por dia podem receber chamadas de voz do WhatsApp. No ⚙️ API da linha, o bloco 📞 Chamadas de voz (só o proprietário) liga e desliga as chamadas e escolhe:

• Botão de ligar: visível para todos os clientes, ou escondido — aí só liga quem receber um link ou botão de chamada.
• Quando: a qualquer hora, ou só no horário de atendimento (o mesmo do aviso fora do horário da linha). Fora dele o cliente não consegue ligar.

A chamada toca no painel de quem atende as conversas da linha, com Atender e Recusar; no fim fica uma nota na conversa. Em Relatórios, a seção 📞 Chamadas de voz recebidas mostra atendidas, perdidas, duração média e quem atendeu. Em Últimas chamadas, o botão Abrir conversa leva direto à conversa do cliente.

Ligar para o cliente

1. Peça autorização

   No topo da conversa, o botão 📞? manda ao cliente o pedido oficial do WhatsApp para receber chamadas da empresa. Só funciona até 24h depois da última mensagem dele.

2. O cliente responde

   Ele autoriza por 7 dias ou sem prazo (ou recusa). A resposta aparece na conversa e o botão muda sozinho.

3. Ligue

   Com a autorização, clique em 📞: o navegador usa o seu microfone e o cartão mostra Chamando…, Tocando no celular do cliente… e o tempo da chamada. No fim fica a nota "Chamada feita por…" na conversa.

🎙️ Gravação, transcrição e resumo

No mesmo bloco 📞 Chamadas de voz, marque Gravar e transcrever as chamadas. Antes de gravar, o WhatsApp avisa em voz alta os dois lados e lê a finalidade que você escreveu (por exemplo, "qualidade do atendimento"). Uns segundos depois de desligar, aparecem na conversa, como notas internas: 🎙️ Gravação da chamada (o áudio para ouvir), 📝 Transcrição da chamada (com o nome do atendente e do cliente em cada fala) e, se Resumir cada chamada com a IA estiver marcado, 🧠 Resumo da chamada com o motivo, o que se combinou e o próximo passo.

👥 Chamar um colega, transferir e escutar

Com a chamada no ar, o cartão de quem atendeu tem mais dois botões:

• 👥 Chamar colega — escolha alguém da equipe com o painel aberto. A chamada toca no painel dele; quando atende, os três conversam.
• ↪️ Transferir — o colega entra e você sai do áudio. Ele passa a poder desligar a chamada. Se ele sair, você volta à chamada sozinho; o botão Voltar à chamada também traz você de volta.

O supervisor e o proprietário veem o botão 🎧 no topo da conversa enquanto a chamada está no ar: clicando, passam a escutar a chamada, sem microfone. Quem atendeu vê no cartão quem está escutando. Cada entrada fica registrada na conversa (👥 entrou, ↪️ transferida, 🎧 escutou).

🏢 Perfil da empresa (linha oficial)

Na linha oficial dá para editar o perfil do número — o que o cliente vê ao abrir a conversa — direto no painel, sem abrir o WhatsApp Manager da Meta. Em 📡 Canais → 📱 Linhas → na linha cloud ⚙️ API, abra 👤 Perfil da empresa.

• Foto de perfil (imagem quadrada, JPG — precisa do App ID da linha preenchido, no mesmo ⚙️ API).
• Recado (a linha curta embaixo do nome), descrição, endereço, email, até 2 sites e a categoria do negócio.