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 qualificadas com acesso à versão prévia podem definir um lance 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 com a categoria 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 que exigem a Marketing Messages API, como cabeçalhos em GIF, continuam exigindo o onboarding.

Lance máximo na Marketing Messages Lite

A precificação por lance máximo para o Marketing Messages Lite está em versão prévia. Se a sua organização tiver acesso à versão prévia, o criador de templates de marketing mostra uma seção Pricing para cada idioma. Escolha Default price para usar as tarifas publicadas pela Meta ou Maximum price para definir um limite de lance. Limites mais baixos podem reduzir a entrega.

Para definir um preço máximo:

1. Escolha Maximum price e confira o Country. Se todos os números conectados da conta pertencerem a um único país compatível, ele já vem selecionado, e você pode alterá-lo. O país ajuda a carregar um valor sugerido. Ele não é salvo e não restringe destinatários.
2. Insira o Maximum per 1,000 deliveries na moeda da WhatsApp Business Account ou selecione Use price. O máximo sugerido pela Meta é a tarifa de marketing de tabela publicada para o país selecionado, na moeda da conta. Com a precificação padrão, a mesma tarifa de marketing vale para a Cloud API e para o Marketing Messages Lite. O valor não inclui as taxas da Bird. Uma sugestão não garante a entrega nem a elegibilidade do país.
3. Selecione Submit for review para solicitar a alteração de preço. Save as draft mantém a alteração na Bird até você enviá-la. Para voltar às tarifas publicadas, escolha Default price e envie a alteração.

Para ajustar o limite para destinos específicos, use Country overrides abaixo das estimativas. Adicione um país e o multiplicador dele: 1 mantém o limite base, 0.8 usa 80% e 1.2 usa 120%. Você pode adicionar até 50 países, com multiplicadores de 0.01 a 10. Os demais países mantêm o limite base. Ao remover uma linha, o limite base desse país volta a valer quando você envia a alteração. O gráfico e os resultados estimados mostram o limite base antes dessas substituições.

O envio inicia a atualização, mas não confirma que a Meta aceitou o limite. Confira o preço aplicado no WhatsApp Manager antes de enviar mensagens. Se a Meta recusar a atualização, o preço anterior continua valendo. Verifique os requisitos da conta e do país e, em seguida, ajuste o limite ou escolha Default price e envie novamente.

A lista Country omite os destinos em que a Meta desativa as otimizações de entrega ou proíbe mensagens de marketing. Ela não identifica regiões restritas dentro de um país. A disponibilidade também depende dos requisitos da Meta para a conta e o remetente. Antes de usar lances máximos, consulte a disponibilidade geográfica de recursos da Meta para os destinos que você pretende alcançar. O acesso à versão prévia na Bird não garante elegibilidade na Meta.

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