Enviar mensagens de modelo do WhatsApp
Este documento fornece diretrizes para enviar mensagens do 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 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 está limitada quanto aos tipos de mensagens que pode enviar. Somente depois que o usuário enviar uma mensagem para a empresa, a empresa poderá enviar mensagens de texto ou de mídia ao usuário durante a conversa ativa. Quando a janela de conversação de 24 horas expirar, a conversa deverá ser reiniciada. Para saber mais sobre conversas, consulte a definição em WhatsApp Business Platform.
Para obter mais requisitos do WhatsApp sobre modelos, consulte as referências da API da plataforma WhatsApp Business:
- Criar e gerenciar modelos
- Componentes de modelo
- Envio de mensagens modelo
- As empresas também devem cumprir os requisitos de aceitação antes de enviar mensagens para usuários do WhatsApp
Escolhendo um modelo
Ao criar uma conta comercial do WhatsApp por meio do portal do Azure durante a inscrição inserida, um conjunto de modelos de exemplo está disponível para você.
Criar 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.
Listar modelos
Você pode exibir seus modelos no portal do Azure acessando o recurso do Serviço de Comunicação do Azure >Modelos.
Selecione um modelo para exibir os detalhes.
O campo content dos detalhes do modelo pode incluir associações de parâmetros. As associações de parâmetro podem ser indicadas como:
- Um campo
formatcom um valor comoIMAGE. - 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 associação devem ser fornecidos para criar o modelo de mensagem.
Como alternativa, você pode exibir e editar todos os modelos da sua conta do WhatsApp Business nas ferramentas da conta do WhatsApp Manager> e dos >Modelos de mensagens.
Para listar seus modelos de forma programática, você pode buscar todos os modelos para a ID do seu canal:
MessageTemplateClient messageTemplateClient = new MessageTemplateClient(connectionString);
Pageable<MessageTemplateItem> templates = messageTemplateClient.GetTemplates(channelRegistrationId);
Referência rápida
O sample_template não usa nenhum parâmetro.
Monte o MessageTemplate referenciando o nome e o 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 compatíveis com modelos pelo SDK de Mensagens Avançadas, consulte: