Pular para o conteúdo principal

WhatsApp

O WhatsApp é o canal com mais regras do provedor — e o mais usado. Vale entender três conceitos: templates, janela de 24 horas e modo de conexão.

Templates​

Toda conversa iniciada pela empresa — e toda mensagem fora da janela de 24 h — precisa de um template aprovado. Templates são criados e aprovados no provedor e sincronizados no agents2.me em Templates.

Um template tem corpo (com variáveis {{1}}, {{2}}…), cabeçalho (texto ou mídia) e, quando traz imagem, ela aparece no compositor antes do envio.

Janela de 24 horas​

SituaçãoO que você pode enviar
Cliente escreveu nas últimas 24 hTexto livre, mídia, respostas rápidas, reações
Sem interação nas últimas 24 hSomente template aprovado

O bloqueio é do provedor. O agents2.me apenas reflete a regra: o compositor desabilita o texto livre e oferece os templates do canal (session_expired_template_required).

Modos de conexão​

  • API oficial — número dedicado ao agents2.me. É o modo recomendado para operação.
  • Coexistência (coexistence) — o celular continua sendo usado pela equipe. A sessão pode expirar e o canal precisa ser reconectado; o cartão do canal mostra esse estado.

O que o canal suporta​

RecursoSuporte
Texto, emoji e formataçãoSim
Imagem, vídeo, áudio, documentoSim, com limites de tamanho do provedor
Localização e contato (vCard)Sim
Reações e resposta citandoSim
Botões e listas interativasSim, conforme o template aprovado
Templates agendadosSim (mínimo de 5 minutos à frente)
Link de pagamentoSim, conforme o provedor disponível

Limites operacionais​

  1. Um número ativo em um workspace por vez.
  2. Envio em massa apenas por Campanhas, com template aprovado.
  3. Textos com template não aprovado são recusados com template_not_approved.

Problemas comuns​

SintomaCausa provável
Canvas não envia textoJanela de 24 h fechada — envie um template
Sessão expirada no cartão do canalModo coexistência: reconecte o canal
Template listado mas não enviávelTemplate pendente de aprovação no provedor
Mensagens recebidas mas fora da filaFila padrão do canal alterada

Veja Solução de problemas para o roteiro de diagnóstico.