Como criar e aprovar um Message Template no WhatsApp 22 de dezembro de 2023 21:18 Atualizado Índice: Introdução Criando um Message Template no Blip Call to action (ir para um link) Passando o parâmetro para o link Call to action (ligar para telefone) Quick reply Analisando o status do Message Template Utilizando templates aprovados No vídeo entenda "Mensagem Ativa" como mensagens enviadas fora da janela de 24hrs e sem o message template (modelo de mensagem) e "Notificações" como mensagens enviadas através do message template. Utilizei a diferenciação no vídeo para tentar facilitar o entendimento. Quando falamos de "Notificações" são mensagens que não afetarão a saúde do seu número pois não ferem as políticas. Introdução Para disparar uma notificação (mensagens ativas) no canal WhatsApp é necessário criar e aprovar um modelo de mensagem (também conhecido como Message Template). Message Templates são mensagens que já foram pré-aprovadas pelo WhatsApp e que possuem um formato reutilizável, ou seja, por variáveis é possível utilizar o mesmo template e disparar diferentes mensagens. Para saber mais detalhes sobre os modelos de mensagem consulte a documentação do WhatsApp. Um exemplo de Message Template para notificar os usuários que acabaram de criar uma conta em uma aplicação qualquer, seria: Olá, {{1}}! Sua conta foi criada no Blip. 👏 Para mais informações acesse https://blip.ai. Observe neste exemplo foi utilizado uma variável representada pelo padrão {{1}}. O número 1 indica o índice da variável, ou seja, {{1}} representa a primeira variável do template. Para adicionar outras variáveis utilize o mesmo padrão e incremente o valor do índice. O exemplo abaixo define um template com duas variáveis: Olá, {{1}}! Sua conta foi criada no Blip. 👏 Para mais inforamções acesse {{2}}. Criando um Message Template no Blip 1. Acesse o portal do Blip 2. Selecione um bot previamente publicado no canal WhatsApp 3. Acesse o módulo de Conteúdos. 4. Selecione o item Modelo de Mensagens e clique no botão “+ Adicionar Novo”. 5. Preencha as informações necessárias para a submissão de um message template. Nome do modelo: nome que identifica seu template (use apenas letras minúsculas, números ou o caracter underline " _ " ) Categoria: categoria que mais se aproxima do conteúdo da sua mensagem. Idioma do modelo: o idioma utilizado no template (é possível disponibilizar diferentes traduções para cada template) Conteúdo da mensagem: (tipos suportados: texto, documentos e imagens) Para criação do Message Template dentro do Blip: tamanho máximo do vídeo é de 16MB. Ao preencher o campo Link assegurar que o servidor aonde o arquivo está não valide o cabeçalho "User-Agent", pois hoje ele não é enviado pelo Blip. Exemplos de servidores válidos: Google Drive, Amazon S3, Imgur, etc. Exemplos de variáveis: exemplos de valores para as variáveis do seu template (essa informação ajuda no entendimento do caso de uso do seu template durante o processo de revisão) Observação: clique no botão 'Adicionar tradução' caso queira utilizar um mesmo template em diferentes idiomas. Tipos de conteúdo suportados e um exemplo de como ele será recebido pelo usuário no WhatsApp: 1) Tipo de Conteúdo: Texto Exemplo: Exemplos de Variáveis: 2) Tipo de Conteúdo: Imagem Exemplo: Exemplos de variáveis: 3) Tipo de Conteúdo: Vídeo Exemplo: Atenção! Os conteúdos de imagem e vídeo funcionam apenas por links diretos, por este motivo existe uma extensão na Blip Store que também cria link para o WhatsApp, veja mais sobre clicando aqui. 4) Tipo de Conteúdo: Documento Exemplo: Message Template com botões Recentemente o WhatsApp liberou uma funcionalidade que permite o envio de conteúdos com botões, como Call to Actions e Quick replies, apenas por Message Templates (para utilizar esse tipo de conteúdo no seu fluxo de conversa, será necessário enviar por conteúdo dinâmico ou mensagens prontas do Desk). Já é possível criá-los através do nosso Portal! Veja abaixo os tipos de conteúdo com botões disponíveis nesta nova atualização e como criá-los: Abaixo do conteúdo, há o menu dos botões disponíveis. Call to action (ir para um link) Tipo de botão que permite enviar um link que levará o usuário para a página correspondente. 1. Selecione o botão Botões de ação; 2. Selecione Link do website e preencha as informações necessárias. Observação: lembre-se de preencher a URL seguindo a estrutura do exemplo! Sempre colocando https:// ou http:// 3. Ao salvar as informações, é possível visualizar uma prévia de como ficará o template. No campo de URL você poderá adicionar uma URL dinâmica e adicionar até uma variável {{1}} para criar um link personalizado. Exemplo: URL dinâmica: https://www.google.com/{{1}} URL estática: https://www.google.com Se acrescentar uma variável no final da URL o sistema entenderá como URL Dinâmica, senão ela será Estática. Será recebido pelo usuário no WhatsApp, conforme o exemplo abaixo: Passando o parâmetro para o link Para atribuir o valor a URL dinâmica cadastrada, podemos fazer da seguinte maneira:1. No fluxo do seu chatbot adicione uma ação do tipo “Requisição HTTP” 2. Selecione o método do Tipo Post e use a URL: https://{{contractid}}.http.msging.net/messages Observação: Utilize a URL com ID do contrato para consumir os endpoints, sua performance e funcionamento podem ser impactados, pois só assim poderá utilizar as requisições http. 3. Informe o código de autorização do seu bot; 4. Aqui você encontra a explicação sobre como encontrar a chave de autorização. No corpo da mensagem, você pode seguir o exemplo abaixo: Texto do json usado no exemplo{ "id":"{{$guid}}", "to":"{{contact.identity}}", "type":"application/json", "content":{ "type":"template", "template":{ "name":"{{NOME-DO_MODELO}}", "language":{ "code":"pt_BR", "policy":"deterministic" }, "components":[ { "type":"button", "sub_type":"url", "index":0, "parameters":[ { "type":"text", "text":"{{urlPayment}}" } ] } ] } }} 2. Call to action (ligar para telefone) Tipo de botão que permite enviar um número de telefone que ao ser clicado acionará a aplicação correspondente do sistema (Telefone, Agenda, Skype e até mesmo o WhatsApp). 1. Selecione o botão Botões de ação. 2. Selecione Número de telefone e preencha as informações necessárias. Observação: lembre-se de colocar o código do país no número de telefone. 3. Ao salvar as informações, é possível visualizar uma prévia de como ficará o template. Exemplo de como ele será recebido pelo usuário no WhatsApp: Quick reply Tipo de conteúdo com botões que permite o envio de respostas rápidas e predefinidas. 1. Selecione o botão Respostas rápidas; 2. Preencha os textos que irão nos botões. Observação: lembre-se você pode adicionar até no máximo 3 botões! 3. Ao salvar as informações, é possível visualizar uma prévia de como ficará o template. Exemplo de como ele será recebido pelo usuário no WhatsApp: Ainda é possível adicionar estes botões juntamente a outros tipos de conteúdo além de texto, como imagens, vídeos e documentos. Analisando o status do Message Template Após a submissão de um Message Template ele ficará em análise com o status de Pendente. Ao final do processo o template receberá o status de Aprovado ou Reprovado, caso seja aceito ou rejeitado pelo WhatsApp, respectivamente. Utilizando templates aprovados Para utilizar um message template é necessário ter acesso ao Nome do modelo. Atenção! Mesmo após a aprovação do Modelo de mensagem (Message Template), pode levar até 20 minutos para a atualização ser refletida no WhatsApp Business API, portanto aguarde esse prazo antes de iniciar a criação da sua campanha. Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal. 😃 Artigos relacionados Envio de Mensagens Ativas do WhatsApp no Blip Desk Dúvidas sobre modelos de mensagens no WhatsApp Como conectar seu chatbot no WhatsApp - 2ª versão Mensagens Ativas - Códigos de erro Gerenciando permissões de acesso
Um exemplo de Message Template para notificar os usuários que acabaram de criar uma conta em uma aplicação qualquer, seria: Olá, {{1}}! Sua conta foi criada no Blip. 👏 Para mais informações acesse https://blip.ai. Observe neste exemplo foi utilizado uma variável representada pelo padrão {{1}}. O número 1 indica o índice da variável, ou seja, {{1}} representa a primeira variável do template. Para adicionar outras variáveis utilize o mesmo padrão e incremente o valor do índice. O exemplo abaixo define um template com duas variáveis: Olá, {{1}}! Sua conta foi criada no Blip. 👏 Para mais inforamções acesse {{2}}. Criando um Message Template no Blip 1. Acesse o portal do Blip 2. Selecione um bot previamente publicado no canal WhatsApp 3. Acesse o módulo de Conteúdos. 4. Selecione o item Modelo de Mensagens e clique no botão “+ Adicionar Novo”. 5. Preencha as informações necessárias para a submissão de um message template. Nome do modelo: nome que identifica seu template (use apenas letras minúsculas, números ou o caracter underline " _ " ) Categoria: categoria que mais se aproxima do conteúdo da sua mensagem. Idioma do modelo: o idioma utilizado no template (é possível disponibilizar diferentes traduções para cada template) Conteúdo da mensagem: (tipos suportados: texto, documentos e imagens) Para criação do Message Template dentro do Blip: tamanho máximo do vídeo é de 16MB. Ao preencher o campo Link assegurar que o servidor aonde o arquivo está não valide o cabeçalho "User-Agent", pois hoje ele não é enviado pelo Blip. Exemplos de servidores válidos: Google Drive, Amazon S3, Imgur, etc. Exemplos de variáveis: exemplos de valores para as variáveis do seu template (essa informação ajuda no entendimento do caso de uso do seu template durante o processo de revisão) Observação: clique no botão 'Adicionar tradução' caso queira utilizar um mesmo template em diferentes idiomas. Tipos de conteúdo suportados e um exemplo de como ele será recebido pelo usuário no WhatsApp: 1) Tipo de Conteúdo: Texto Exemplo: Exemplos de Variáveis: 2) Tipo de Conteúdo: Imagem Exemplo: Exemplos de variáveis: 3) Tipo de Conteúdo: Vídeo Exemplo: Atenção! Os conteúdos de imagem e vídeo funcionam apenas por links diretos, por este motivo existe uma extensão na Blip Store que também cria link para o WhatsApp, veja mais sobre clicando aqui. 4) Tipo de Conteúdo: Documento Exemplo: Message Template com botões Recentemente o WhatsApp liberou uma funcionalidade que permite o envio de conteúdos com botões, como Call to Actions e Quick replies, apenas por Message Templates (para utilizar esse tipo de conteúdo no seu fluxo de conversa, será necessário enviar por conteúdo dinâmico ou mensagens prontas do Desk). Já é possível criá-los através do nosso Portal! Veja abaixo os tipos de conteúdo com botões disponíveis nesta nova atualização e como criá-los: Abaixo do conteúdo, há o menu dos botões disponíveis. Call to action (ir para um link) Tipo de botão que permite enviar um link que levará o usuário para a página correspondente. 1. Selecione o botão Botões de ação; 2. Selecione Link do website e preencha as informações necessárias. Observação: lembre-se de preencher a URL seguindo a estrutura do exemplo! Sempre colocando https:// ou http:// 3. Ao salvar as informações, é possível visualizar uma prévia de como ficará o template. No campo de URL você poderá adicionar uma URL dinâmica e adicionar até uma variável {{1}} para criar um link personalizado. Exemplo: URL dinâmica: https://www.google.com/{{1}} URL estática: https://www.google.com Se acrescentar uma variável no final da URL o sistema entenderá como URL Dinâmica, senão ela será Estática. Será recebido pelo usuário no WhatsApp, conforme o exemplo abaixo: Passando o parâmetro para o link Para atribuir o valor a URL dinâmica cadastrada, podemos fazer da seguinte maneira:1. No fluxo do seu chatbot adicione uma ação do tipo “Requisição HTTP” 2. Selecione o método do Tipo Post e use a URL: https://{{contractid}}.http.msging.net/messages Observação: Utilize a URL com ID do contrato para consumir os endpoints, sua performance e funcionamento podem ser impactados, pois só assim poderá utilizar as requisições http. 3. Informe o código de autorização do seu bot; 4. Aqui você encontra a explicação sobre como encontrar a chave de autorização. No corpo da mensagem, você pode seguir o exemplo abaixo: Texto do json usado no exemplo{ "id":"{{$guid}}", "to":"{{contact.identity}}", "type":"application/json", "content":{ "type":"template", "template":{ "name":"{{NOME-DO_MODELO}}", "language":{ "code":"pt_BR", "policy":"deterministic" }, "components":[ { "type":"button", "sub_type":"url", "index":0, "parameters":[ { "type":"text", "text":"{{urlPayment}}" } ] } ] } }} 2. Call to action (ligar para telefone) Tipo de botão que permite enviar um número de telefone que ao ser clicado acionará a aplicação correspondente do sistema (Telefone, Agenda, Skype e até mesmo o WhatsApp). 1. Selecione o botão Botões de ação. 2. Selecione Número de telefone e preencha as informações necessárias. Observação: lembre-se de colocar o código do país no número de telefone. 3. Ao salvar as informações, é possível visualizar uma prévia de como ficará o template. Exemplo de como ele será recebido pelo usuário no WhatsApp: Quick reply Tipo de conteúdo com botões que permite o envio de respostas rápidas e predefinidas. 1. Selecione o botão Respostas rápidas; 2. Preencha os textos que irão nos botões. Observação: lembre-se você pode adicionar até no máximo 3 botões! 3. Ao salvar as informações, é possível visualizar uma prévia de como ficará o template. Exemplo de como ele será recebido pelo usuário no WhatsApp: Ainda é possível adicionar estes botões juntamente a outros tipos de conteúdo além de texto, como imagens, vídeos e documentos. Analisando o status do Message Template Após a submissão de um Message Template ele ficará em análise com o status de Pendente. Ao final do processo o template receberá o status de Aprovado ou Reprovado, caso seja aceito ou rejeitado pelo WhatsApp, respectivamente. Utilizando templates aprovados Para utilizar um message template é necessário ter acesso ao Nome do modelo. Atenção! Mesmo após a aprovação do Modelo de mensagem (Message Template), pode levar até 20 minutos para a atualização ser refletida no WhatsApp Business API, portanto aguarde esse prazo antes de iniciar a criação da sua campanha. Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal. 😃