Templates de marketing

Todo template do WhatsApp pertence a uma das três categorias da Meta: authentication, utility ou marketing. Marketing é a categoria promocional e a única que a Meta encaminha por uma segunda API. Os envios de marketing vão para a API Marketing Messages da Meta, e todas as outras categorias vão para a API Cloud, usando o mesmo número de telefone.

A categoria também define o preço padrão. Com o preço padrão, um template de marketing custa a tarifa de marketing do país do destinatário, independentemente de qual das duas APIs faz o envio. As tarifas estão na página de preços do WhatsApp, e Custos e cobrança explica quando cada parte de um envio é cobrada. Contas elegíveis podem definir um preço máximo.

O que você precisa para enviar um template

Nosso catálogo gerenciado contém apenas templates de autenticação e utilidade, então um envio de marketing sempre usa um template criado pelo seu espaço de trabalho:

1. Conecte uma conta do WhatsApp Business própria, porque um template criado por você é registrado na sua conta, e não na nossa. Consulte Configuração de número de telefone.
2. Crie um template de marketing e envie-o para revisão. A Meta revisa a categoria junto com o conteúdo e recategoriza um template que, na prática, seja promocional. As Diretrizes de templates explicam o que é aprovado na revisão.
3. Envie a partir de um número da conta que contém o template. Um template pertence a uma única conta do WhatsApp Business, então um envio que indica um número de outra conta é rejeitado antes de chegar à Meta.

API Marketing Messages na conta comercial

Abra Numbers, escolha um número e abra a conta comercial dele para ver o que a Meta informa sobre a conta usada pelo número nos envios. A linha Marketing Messages API mostra o status de onboarding dessa conta:

A linha não aparece até a Meta informar um valor. Ela é uma leitura armazenada do provedor, não uma verificação de elegibilidade em tempo real. A Bird atualiza periodicamente os metadados das contas conectadas. Atrasos e falhas podem deixar campos individuais mais antigos que a última leitura bem-sucedida. Quando um envio depender do onboarding, confirme-o no WhatsApp Manager.

A Meta aceita os termos uma única vez para todo o portfólio empresarial, por isso o painel também mostra um segundo estado, válido para o portfólio inteiro: not_started, request_sent ou term_of_service_signed. A Meta dá o mesmo nome aos dois campos, mas usa vocabulários diferentes em cada um. Consulte a linha da conta para saber a elegibilidade e a linha do portfólio para acompanhar o andamento da aceitação dos termos.

O onboarding acontece na Meta, e não no painel da Bird. Uma pessoa com controle total do portfólio empresarial aceita os termos da Marketing Messages API no WhatsApp Manager, em Overview > Accept terms to get started. O guia de onboarding da Meta traz as etapas atuais.

Envio antes de a conta concluir o onboarding

O fluxo de envio inclui o product_policy de CLOUD_API_FALLBACK da Meta, que permite que mensagens de marketing elegíveis usem a Cloud API enquanto o onboarding na Marketing Messages API não estiver concluído. A categoria de marketing continua definindo a tarifa aplicável. Esse fallback não contorna restrições de destinatário, de conta ou de conteúdo e não garante a entrega. Formatos e preços que exigem a Marketing Messages API, como cabeçalhos em GIF e templates com preço máximo, continuam exigindo o onboarding.

Lance máximo na Marketing Messages Lite

Um preço máximo limita o valor que a Meta cobra por entrega de marketing. Configure-o por idioma no editor de templates ou pela API. O guia de criação de templates de marketing explica os controles do painel, as substituições por país, as estimativas e como aplicar ou remover um limite.

Envios com preço máximo exigem uma conta comercial que tenha concluído o onboarding na Marketing Messages API. Consulte a disponibilidade geográfica de recursos da Meta para os países do remetente e do destinatário. O seletor de país do editor não identifica regiões restritas dentro de um país nem confirma a elegibilidade da conta. A Meta rejeita envios com preço máximo para destinos não compatíveis com 131065 e não recorre à tarifa padrão.

Recursos adicionais e configurações de envio

A Meta oferece recursos adicionais de otimização e medição de marketing para contas e mercados elegíveis. Confirme quais recursos estão disponíveis para a sua conta na comparação de recursos da Meta antes de fazer um lançamento depender deles. A integração, por si só, não comprova que todos os recursos de otimização ou de relatórios estejam ativados para todos os destinatários.

O fluxo de envio atual da Bird seleciona a Marketing Messages API para templates de marketing e inclui CLOUD_API_FALLBACK. Ele não fornece substituições de recursos criativos do template, configuração de medição de conversões nem configuração de deep links para Android. Configure o limite de um idioma do template pela precificação por lance máximo. Não presuma que essas configurações estejam definidas só porque um template foi aprovado.

Quando a Meta informa a categoria de preço marketing_lite, a Bird a associa à categoria de tarifa de marketing. Para saber a cobrança real, consulte o custo informado da mensagem e os registros de faturamento. Uma mensagem enviada e uma mensagem entregue geram cobranças em momentos diferentes.

Verifique as restrições de destino e de destinatário

A elegibilidade para marketing pode variar conforme o país do destinatário, a conta, o formato e os limites que a Meta aplica a cada destinatário. Confirme as restrições vigentes 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 é informado pelo Bird como rate_limited. Investigue os detalhes do provedor, a elegibilidade do destino e os limites do destinatário antes de tentar novamente. Um envio aceito ou um template aprovado não comprova que o destinatário é elegível. Não reenvie repetidamente uma mensagem restrita.

Quando um destinatário interrompe as mensagens de marketing

O WhatsApp oferece a cada destinatário um controle Offers and announcements no seu perfil comercial. Escolher Not interested alimenta os limites por usuário da Meta. Interromper totalmente o recebimento bloqueia seus templates de marketing, mas não afeta as mensagens de utilidade e de autenticação.

Uma recusa do provedor pode informar o erro 131050 da Meta. Leia o código do provedor em last_error.meta_error_code junto com o erro normalizado do Bird e o log de mensagens. Quando o Bird já tem uma preferência de descadastro aplicável, ele pode rejeitar a mensagem antes da entrega ao provedor. Verifique a escolha registrada do destinatário antes de tentar novamente.

Quando o Bird recebe um evento de interrupção válido da Meta, ele registra uma preferência não transacional, originada pelo destinatário e restrita à WhatsApp Business Account. Essa preferência aparece na aba Preferences, e não na lista Suppressions. Um evento de retomada atualiza essa preferência, mas bloqueios independentes continuam valendo. Verifique as duas 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 de a preferência correspondente ser registrada. Consulte Preferências para ver o escopo e a cobertura.

Próximos passos

• Diretrizes de templates: as regras com base nas quais a Meta analisa um template de marketing
• Templates do WhatsApp: navegação, status e leitura do conteúdo de um template pela API
• Enviar mensagens do WhatsApp: como indicar um template e um remetente em um envio
• Qualidade do número e limite de mensagens: como o volume de marketing afeta a classificação de um número