Templates de marketing
Todo template WhatsApp pertence a uma das três categorias da Meta: authentication, utility ou marketing. Marketing é a categoria promocional e é a única que a Meta roteia por uma segunda API. Envios de marketing vão para a Marketing Messages API da Meta e todas as outras categorias vão para a Cloud API, pelo mesmo número de telefone.
A categoria também define o preço. Um template de marketing custa a tarifa de marketing do país do destinatário, independentemente de qual das duas APIs o transporta. As tarifas estão na página de preços WhatsApp, e Custo e faturamento explica quando cada parte de um envio é cobrada.
O que você precisa para enviar um
Nosso catálogo gerenciado contém apenas templates de autenticação e utilitários, então um envio de marketing sempre usa um template criado pelo seu espaço de trabalho:
- Conecte uma WhatsApp Business Account própria, já que um template criado por você é registrado na sua conta, não na nossa. Consulte Configuração de número de telefone.
- Crie um template com a categoria marketing e envie para revisão. A Meta revisa a categoria junto com o conteúdo e recategoriza um template que seja promocional na essência. Diretrizes de templates explica o que passa na revisão.
- Envie a partir de um número na conta que contém o template. Um template pertence a uma única WhatsApp Business Account, então um envio que indica um número em uma conta diferente é rejeitado antes de chegar à Meta.
Marketing Messages API na conta comercial
Abra Numbers, escolha um número e abra sua conta comercial para ver o que a Meta reporta sobre a conta sob a qual o número envia. A linha Marketing Messages API é o estado de onboarding dessa conta:
| Valor | Significado |
|---|---|
| Eligible | A Meta aceitaria uma solicitação de onboarding para esta conta |
| Onboarded | A conta está integrada e seus envios de marketing estão otimizados |
A linha fica ausente até a Meta reportar um valor. É uma leitura armazenada do provedor, não uma verificação de elegibilidade em tempo real. Bird atualiza os metadados de contas conectadas periodicamente; atrasos e falhas podem deixar campos individuais mais antigos do que a última leitura bem-sucedida. Confirme o onboarding no WhatsApp Manager quando um envio depender disso.
A Meta aceita os termos uma vez para todo o portfólio comercial, então o painel também exibe um segundo estado, no nível do portfólio: not_started, request_sent ou term_of_service_signed. A Meta dá a ambos os campos o mesmo nome e dois vocabulários diferentes. Leia a linha da conta para elegibilidade e a linha do portfólio para o progresso nos termos.
O onboarding acontece na Meta, não no painel Bird. Alguém com controle total do portfólio comercial aceita os termos da Marketing Messages API no WhatsApp Manager, em Overview > Accept terms to get started. O guia de onboarding da Meta contém os passos atuais.
Envio antes da conta estar integrada
O caminho de envio inclui o product_policy de CLOUD_API_FALLBACK da Meta, permitindo que mensagens de marketing elegíveis usem a Cloud API enquanto o onboarding da Marketing Messages API estiver incompleto. A categoria de marketing ainda determina a tarifa aplicável. Esse fallback não contorna restrições de destinatário, conta ou conteúdo e não garante a entrega. Formatos que exigem a Marketing Messages API, incluindo cabeçalhos GIF, ainda exigem onboarding.
Recursos adicionais e configurações de envio
A Meta oferece recursos adicionais de otimização e mensuração de marketing para contas e mercados elegíveis. Confirme os recursos disponíveis para sua conta na comparação de recursos da Meta antes de fazer um lançamento depender deles. O onboarding por si só não comprova que todo recurso de otimização ou relatório esteja habilitado para todos os destinatários.
O caminho de envio atual de Bird seleciona a Marketing Messages API para templates de marketing e inclui CLOUD_API_FALLBACK. Ele não fornece limites de otimização por envio, substituições de recursos criativos de template, configuração de mensuração de conversão ou configuração de deep link Android. Não assuma que essas configurações estão definidas porque um template foi aprovado.
Quando a Meta reporta a categoria de preço marketing_lite, Bird a mapeia para a categoria de tarifa de marketing. Consulte o custo reportado da mensagem e os registros de faturamento para a cobrança real; uma mensagem enviada e uma mensagem entregue têm gatilhos de cobrança diferentes.
Verifique restrições de destino e destinatário
A elegibilidade de marketing pode variar por país do destinatário, conta, formato e limites por destinatário da Meta. Confirme as restrições atuais na documentação da Meta e no WhatsApp Manager para os destinos da sua campanha. O país de um número comercial não garante que todos os destinatários pretendidos possam receber templates de marketing.
O erro 131049 da Meta é reportado por Bird como rate_limited. Investigue os detalhes do provedor, a elegibilidade do destino e os limites do destinatário antes de tentar novamente. Não trate um envio aceito ou um template aprovado como prova de que o destinatário é elegível e não reenvie repetidamente uma mensagem restrita.
Quando um destinatário bloqueia mensagens de marketing
WhatsApp dá a cada destinatário um controle Offers and announcements no perfil da sua empresa. Escolher Not interested alimenta os limites por usuário da Meta, e interromper a entrega por completo bloqueia seus templates de marketing sem afetar mensagens de utilitário e autenticação.
Uma recusa do provedor pode reportar o erro 131050 da Meta. Leia o código do provedor em last_error.meta_error_code junto com o erro normalizado de Bird e o log de mensagens. Quando Bird já tem uma preferência de opt-out aplicável, pode rejeitar a mensagem antes da entrega pelo provedor. Investigue a escolha registrada do destinatário antes de tentar novamente.
Quando Bird recebe um evento de parada válido da Meta, registra uma preferência de origem do destinatário, não transacional, vinculada à WhatsApp Business Account. Ela pertence à aba Preferences, não à lista Suppressions. Um evento de retomada atualiza essa preferência; bloqueios independentes continuam valendo. Verifique ambas as abas e o histórico de eventos antes de adicionar uma supressão separada para todas as mensagens. Uma recusa do provedor pode chegar antes da preferência correspondente ser registrada. Consulte Opt-outs para escopo e cobertura.
Próximos passos
- Diretrizes de templates: as regras contra as quais a Meta revisa um template de marketing
- Templates WhatsApp: navegação, status e leitura do conteúdo de um template pela API
- Enviando mensagens WhatsApp: indicando um template e um remetente em um envio
- Qualidade do número e limite de mensagens: o que o volume de marketing faz com a classificação de um número
Recursos relacionados
Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.
Assista ao guiaConnecting WhatsApp to Bird: from buying a number to a live channelEntenda o conceitoWhat is the 24-hour customer service window on WhatsApp?Use a ferramentaWhatsApp message builderExplore a funcionalidadeWhatsApp
Experimente na prática e obtenha um resumo de implementação