Partilhar via


Enviar mensagens modelo do WhatsApp

Este documento fornece orientação para enviar mensagens de modelo do WhatsApp usando o SDK de mensagens de comunicação avançadas.

Por que preciso enviar uma mensagem de modelo?

Uma empresa só pode enviar mensagens de modelo até que o usuário envie uma mensagem para a empresa.

Uma empresa ou um usuário pode iniciar uma janela de conversa, mas a empresa é limitada em quais tipos de mensagens eles podem enviar. Somente depois que o usuário envia uma mensagem para a empresa, a empresa tem permissão para enviar mensagens de texto ou mídia para o usuário durante a conversa ativa. Quando a janela de conversa de 24 horas expirar, a conversa deve ser reiniciada. Para saber mais sobre conversas, consulte a definição em Plataforma WhatsApp Business.

Para obter mais requisitos do WhatsApp sobre modelos, consulte as referências da API da plataforma WhatsApp Business:

Escolher um modelo

Quando você cria uma conta do WhatsApp Business por meio do portal do Azure durante a inscrição incorporada, um conjunto de modelos de exemplo está disponível para você.

Criar o modelo

Para criar seus próprios modelos, use o Meta WhatsApp Manager.

Siga as instruções na Central de Ajuda do Meta Business em Criar modelos de mensagens para sua conta do WhatsApp Business.

Modelos de lista

Pode ver os seus modelos no portal do Azure acedendo aos seus Modelos de recursos >do Serviço de Comunicação do Azure.

Captura de ecrã que mostra um recurso dos Serviços de Comunicação do Azure no portal do Azure, visualizando o separador 'Modelos'.

Selecione um modelo para visualizar os detalhes.

O content campo de detalhes do modelo pode incluir associações de parâmetros. As ligações de parâmetros podem ser indicadas como:

  • Um format campo com um valor como IMAGE.
  • Colchetes duplos ao redor de um número, como {{1}}. O número, indexado iniciado em 1, indica a ordem na qual os valores de vinculação devem ser fornecidos para criar o modelo de mensagem.
  • Colchetes duplos ao redor de um nome, como {{movie_name}}. Os parâmetros nomeados permitem que os desenvolvedores façam referência a parâmetros por nome em vez de posição.

    Importante

    Ao usar parâmetros nomeados, você deve garantir que o nome que você usa ao enviar a mensagem corresponda exatamente ao nome definido no modelo que você criou no Meta WhatsApp Manager.

Captura de tela que mostra os detalhes do modelo.

Como alternativa, você pode visualizar e editar todos os modelos da sua conta do WhatsApp Business nas ferramentas de conta do >> Modelos de mensagem.

Para listar seus modelos programaticamente, você pode buscar todos os modelos para o ID do canal:

MessageTemplateClient messageTemplateClient = new MessageTemplateClient(connectionString);
Pageable<MessageTemplateItem> templates = messageTemplateClient.GetTemplates(channelRegistrationId);

Referência rápida

O sample_template não leva parâmetros.

Captura de tela que mostra os detalhes do modelo chamado sample_template.

Monte o MessageTemplate fazendo referência ao nome e idioma do modelo de destino.

string templateName = "sample_template"; 
string templateLanguage = "en_us"; 

var sampleTemplate = new MessageTemplate(templateName, templateLanguage); 

Para obter exemplos detalhados e cenários suportados por modelos do Advanced Messages SDK, consulte:

Próximos passos