Sign inGet Started

Templates de marketing do WhatsApp

Um template de marketing traz conteúdo promocional, como uma oferta, o anúncio de um produto ou um cupom. Antes de enviar, tenha o conteúdo aprovado, a permissão do destinatário e uma forma clara de lidar com respostas e descadastramentos.

O WhatsApp Studio envia para um destinatário por vez. Um broadcast envia um template de marketing para um público inteiro pelo dashboard. Para planejar uma campanha, consulte WhatsApp Studio e campanhas de marketing.

Antes de enviar

O catálogo gerenciado do Bird não inclui nenhum template de marketing. Por isso, um envio de marketing sempre usa um template criado pelo seu espaço de trabalho, em uma WhatsApp Business Account própria:

  1. Conecte uma WhatsApp Business Account e um número próprio. Consulte Configuração de número de telefone.
  2. Crie um template de marketing e envie-o para análise. Consulte as Diretrizes de templates para saber o que é aprovado.
  3. Envie de um número que esteja na mesma WhatsApp Business Account do template. from é obrigatório em um envio de marketing, e um remetente de outra conta é recusado 422 E15023 WhatsAppSenderWABAMismatch antes de qualquer cobrança.

Como enviar um template de marketing

POST /v1/whatsapp/messages com from definido e um objeto template que indica o seu próprio slug:

const msg = await bird.whatsapp.send({
  to: "+16505551234",
  from: "+13125550101",
  template: {
    slug: "summer_sale",
    language: "en",
    parameters: {
      header_url: "https://cdn.example.com/banners/summer.png",
      first_name: "Pablo",
      code: "SUMMER25",
    },
  },
});
console.log(msg.id, msg.status);
  • As variáveis do corpo são nomeadas, assim como nos templates de utilidade, então first_name é uma chave própria.
  • O código de um botão de cupom vai em code, como no exemplo acima. Não existe uma chave separada para cupom.
  • Um cabeçalho de mídia usa header_url, seja uma imagem, um vídeo ou um gif. Omita-o para enviar a amostra aprovada do template. Um template importado da Meta não tem amostra, então ele precisa de header_url. Marketing é a única categoria que aceita um cabeçalho com GIF animado.
  • A mídia e o sufixo de URL numerado de um cartão de carrossel usam chaves numeradas: header_url_1 e button_url_1 para o primeiro cartão, header_url_2 para o segundo e assim por diante. Dê nomes às variáveis dentro dos cartões. Um nome usado em dois cartões é uma única chave, então os dois cartões recebem o mesmo valor. Um carrossel em que cada cartão numera um {{1}} usa apenas components, com os valores em cards, e esse envio precisa fornecer exatamente o número de cartões com que o template foi aprovado.

A Bird encaminha automaticamente todo envio de marketing para a API Marketing Messages da Meta; você não precisa aderir e não há uma opção por envio. O status de integração da conta comercial nessa API controla as otimizações da Meta, e não a entrega em si. A exceção são os cabeçalhos gif, que exigem uma conta com a integração concluída. Consulte Templates de marketing para ver o estado da conta, o que a integração libera e em quais países o marketing é limitado.

Descadastros

Quando a Bird recebe da Meta um evento válido de interrupção de marketing, ela registra uma preferência do destinatário para essa conta comercial. Essa preferência é separada de uma supressão de todas as mensagens. Verifique os dois registros antes de enviar. Uma falha de entrega pode chegar antes do evento de preferência correspondente; preserve a escolha do destinatário e investigue esse histórico em vez de tentar novamente. Consulte Preferências para saber como registrar e ler esses registros.

Custo

Use a tarifa de marketing publicada para o destino e a moeda, ou defina um preço máximo para uma cobrança de entrega variável da Meta até o seu limite. A Bird cobra a tarifa de saída antes do envio à Meta; um resultado de entrega ou leitura faturável pode acrescentar a tarifa da Meta. Consulte Custo e faturamento e Preços do WhatsApp.

Pontos de atenção

  • A categoria definida pela Meta determina o preço. A Meta pode reclassificar conteúdo promocional como marketing após a aprovação. Verifique a categoria atual de cada idioma antes de enviar; um envio com preço máximo exige a categoria marketing. Consulte o processo de revisão de categoria da Meta se você discordar da classificação.
  • 131049 é uma pausa de entrega, não uma limitação de requisições que você configurou, e tentar novamente piora a situação. A Meta informa 131049 tanto para sua pausa geral nos EUA quanto para um limite de marketing por usuário, e a própria orientação dela é esperar cerca de um dia antes de reenviar. Reenviar antes disso pode deixar a conta indisponível para esse destinatário por mais tempo e distorce a sua taxa de entrega. A Bird informa a falha como rate_limited.
  • 131050 significa que o destinatário desativou "Offers and announcements", e nunca se deve tentar novamente. A Meta aceita o envio e depois se recusa a entregá-lo. A resposta correta é seguir o caminho das preferências de mensagens, não reenviar: suprima o destinatário você mesmo ou espere que ele reative a entrega, o que o Bird fica sabendo pelo mesmo mecanismo de preferências que informou a interrupção. Consulte Preferências.
  • 132015 e 132016 indicam pausa do template, não um problema do destinatário. 132015 é uma pausa por baixa qualidade; 132016 é a desativação permanente após pausas repetidas, e a única solução é um novo template com conteúdo diferente. Verifique o status do próprio idioma, e não o do template, porque um idioma pausado para de enviar imediatamente.
  • Um remetente na WhatsApp Business Account errada é recusado antes de qualquer cobrança. from precisa estar na mesma conta do template; caso contrário, o envio falha 422 E15023 WhatsAppSenderWABAMismatch.

Próximos passos