Configurando Template do GupShup para ativo do WhatsApp no Tactium OMNI

---

Pré-requisitos

• Realizar a configuração do GupShup. Para mais informações acesse Configurando o Serviço do GupShup.
• O sistema deve estar na versão 21.08.09a ou superior, pois a partir desta versão os templates serão encontrados dentro do próprio serviço (WhatsApp), assim como suas informações de vinculação e configuração.

Cadastrando Template no GupShup

Para iniciar o cadastro de um template, o primeiro passo será acessar a API do GupShup https://www.gupshup.io/.

Na tela principal (Dashboard) selecione a API desejada, na aba de “Templates” é possível cadastrar novos templates ou localizar os já cadastrado.

Para adicionar um novo template clique em .

Configuração e modelagem de templates

A página seguinte exibirá os campos necessários para criação de um template de mensagens.

Configurando template

Os 4 (quatros) primeiros campos são utilizados para a configuração dos templates.

No novo layout de criação de template, liberado desde 01/04/2023, é obrigatório fornecer amostras enquanto se criam Modelos de Mensagens. As amostras são uma forma de fornecer um exemplo de dados possíveis para o seu modelo. Isto ajudará o processo de revisão e aprovação, para que a equipe do WhatsApp e Gupshup compreender que tipo de mensagem pretendesse enviar.

• Nome do modelo: É o identificador do template utilizado para identificação do WhatsApp.
  • Requisitos: apenas letras minúsculas, números e sublinhado (‘_’).
  • Ex.: app_template_teste
• Categoria: As categorias são uma forma de definir o objetivo do template. Cada categoria possui um tipo de taxação especifica e objetivos referentes a cada categoria. Para saber mais sobre as categorias acesse Diretrizes para modelos de utilidade, autenticação e marketing.
  • Requisitos: selecionar a categoria que condiz com o objetivo do template.
• Idioma: Informa qual o idioma utilizado na mensagem do template.
• Etiquetas de templates: Serve para informar o caso de uso do template com uma forma de identificação generalizada do mesmo.
  • Requisitos: Mais claro e objetivo possível, utilizando 2 ou 3 palavras.
  • Ex.: Promoção Semanal

Modelando template

Os outros campos são utilizados para a modelagem do template, onde é possível dar forma e definir a mensagem do template.

• Cabeçalho (Opcional): É utilizado para aplicar alguma informação textual ou mídia para incrementar a mensagem de template que está sendo modelada.
  • Tipos:
    • Texto: É possível adicionar um texto de até 60 caracteres, podendo incluir uma variável (única).
      • 
    • Mídia: Ao invés de texto, envia um arquivo de mídia (foto, vídeo ou documento), com os formatos de arquivo e seus respectivos tamanhos que são aceitos para upload, no template.
      • 

• Corpo: Onde pode ser definido a mensagem template, que pode ou não conter variáveis de mesclagem, além de adicionar emojis e formatações especiais do WhatsApp.
  • Tipos de formatação: Negrito (*Texto*), Itálico (_Texto_), Riscado (~Texto~) e monoespaçado (“`Texto“`).
• Rodapé (Opcional): Assim como o cabeçalho, é utilizado para aplicar alguma informação textual para incrementar a mensagem de template que está sendo modelada.
  • Observação: No rodapé, NÃO é possível adicionar mídia ou variável.
• Botões (Opcional): Pode ser utilizado com o objetivo de deixar o template mais interativo, adicionando botões ou URL/Número de telefone. Para entender como configurar os botões interativos leia a sessão Adicionando botões de resposta interativa com o WhatsApp nos templates.

Deve-se ter uma atenção na quantidade de caracteres do cabeçalho (header) devido ter uma limitação de apenas 60 caracteres, enquanto que no corpo (body) permite um total de 1024 caracteres. Portanto, recomenda-se que utilize preferencialmente o corpo no cadastro do template, já que o cabeçalho é opcional e tem limitação da quantidade de caracteres.

Durante a modelagem do template é possível ter uma pré-visualização de como o template está ficando para ajudar na percepção da modelagem.

Após preenchimento dos campos desejados clique no botão   para submeter as informações para posteriormente aguardar a aprovação do GupShup.

O pop-up de confirmação é a etapa final do processo de criação de um novo template, clique em    se você confirma as informações.

Ou caso queira realizar a edição de algum campo novamente clique em Cancelar.

Adicionando botões de resposta interativa com o WhatsApp nos templates

Os botões de interativos no WhatsApp surgem como uma boa estratégia para tornar o atendimento mais dinâmico e menos falho. Proporcionando uma facilidade maior nas respostas dos usuários.

Os tipos de botões disponíveis são Chamada para ações e Resposta rápida.

Botões: Chamada para ações

Selecionando a opção “Chamada para ações” em “Botões” é possível habilitar  a utilização de botões com ações ao fluxo, aumentando o envolvimento dos usuários com as notificações.

• Selecionar tipo: Definir o tipo de ação, redirecionamento para uma ligação (Número de telefone) ou site (URL).
• Titulo do botão: Nome do Botão.
• Selecione o tipo de URL (Opção disponível apenas quando tipo for “URL”): Definir o tipo de URL, optando por um endereço estático ou dinâmico.
  • Estático: É passado a URL completa sem variáveis de mesclagem.
    • Ex.: www.tactium.com.br
  • Dinâmico: É passado a URL parcial e adiciona uma variável para mesclagem de demais informações.
    • Ex.: Podemos adicionar como valor do botão a URL de chamada web para um contato de WhatsApp (https://wa.me/) e utilizar a variável ({{1}}) para retornar o número do WhatsApp, como na imagem acima.
• Valor do botão: Informando o valor para redirecionamento, neste preenchendo com o  Endereço de URL ou DDI+DDD+ Número de Telefone.

Botões: Resposta Rápida

Selecionando a opção “Resposta rápida” em “Botões” é possível habilitar a utilização de até 3 botões de resposta rápida ao fluxo, automatizando o tipo de resposta nas interações e reduzindo erros de ortografia.

• Titulo da resposta rápida: Nome da resposta rápida (Valor que será apresentado no botão)

Processo de Aprovação do Template por parte do WhatsApp

Com a finalização do processo de configuração e envio para aprovação é possível visualizar o Template na listagem inicial com o status de aprovação pendente pelo WhatsApp.

Essa aprovação dependerá 100% do WhatsApp.

Ativando o envio manual (ativo) de templates

Após a aprovação do template pela Meta (WhatsApp) é necessário habilitar a autorização de envio de templates na plataforma da Gupshup.

Vinculando Templates ao Serviço de WhatsApp

Após a aprovação do template na Gupshup, será necessário vinculá-lo ao serviço de WhatsApp no ManagerADM para que ele possa ser utilizado no sistema.

Para realizar essa configuração:

1. Acesse o ManagerADM;
2. Vá em Serviços e Processos >>> Cadastrar Serviço;
3. Selecione o serviço de WhatsApp desejado;
4. Acesse a aba Integração;
5. Clique na opção Templates.

Listagem de Templates

Após acessar a opção de templates, será exibida a tela Definição de Template WhatsApp Ativo.
Nessa tela, o sistema realiza automaticamente a listagem de todos os templates aprovados na Gupshup.

Para cada template são apresentadas as seguintes informações:

• Nome: Nome definido durante a criação do template na Gupshup;
• ID: Identificador único do template cadastrado na Gupshup;
• Template: Conteúdo e estrutura da mensagem aprovada na plataforma.

Templates destacados em VERDE representam templates já configurados e salvos no sistema, estando disponíveis para utilização no OmniPA.

Templates exibidos em CINZA ainda não foram configurados ou salvos corretamente e, por esse motivo, não poderão ser utilizados até a conclusão da parametrização.

Parametrizando um Template

Ao selecionar um template na listagem, suas informações serão exibidas no painel lateral direito da tela.

Além dos dados básicos do template, como nome, ID e conteúdo da mensagem, também serão disponibilizadas configurações adicionais necessárias para definir a forma de utilização do template dentro do sistema.

Configurações Gerais

• Idioma:
  Define o idioma configurado no template aprovado na Gupshup.
• Tipo de Uso:
  Define como o template será utilizado no sistema:
  • Ativo Manual: Utilização manual pelo operador através do OmniPA;
  • Campanha: Utilização em campanhas automatizadas de disparo.

Parâmetros Dinâmicos

Ao selecionar o tipo de uso Ativo Manual, será exibida a seção de Parâmetros/Variáveis, utilizada para associar os valores que serão substituídos automaticamente durante o envio da mensagem.

• Parâmetros do template:
  As variáveis cadastradas durante a criação do template na Gupshup podem ser associadas a informações do cliente e da ocorrência, permitindo personalizar automaticamente o conteúdo das mensagens enviadas.

Esses parâmetros permitem inserir dinamicamente informações do cliente e da ocorrência no momento do envio da mensagem.

Parâmetro	Descrição
Nome completo	Insere automaticamente o nome completo do cliente vinculado ao disparo, permitindo uma comunicação mais personalizada e identificável.
Email	Retorna o endereço de e-mail cadastrado para o cliente associado ao disparo da campanha.
Telefone Principal	Utiliza o número de telefone principal cadastrado para o cliente relacionado ao disparo.
Protocolo	Insere automaticamente o número da ocorrência vinculada ao atendimento ou campanha, facilitando a identificação do registro pelo cliente.
Data da ocorrência	Retorna automaticamente a data de abertura da ocorrência vinculada ao disparo.

Importante:

• A utilização dos parâmetros relacionados à ocorrência depende da existência de uma ocorrência vinculada ao disparo.
• Os parâmetros Nome completo, Email e Telefone Principal utilizam informações do cadastro do cliente.
• Os parâmetros Protocolo e Data da ocorrência utilizam informações da ocorrência associada.
• Os valores dos parâmetros são substituídos automaticamente durante o processamento e envio das mensagens.

Uso em Campanhas

Em templates configurados para uso em Campanhas, a associação dos valores não é realizada manualmente nesta tela.

Nesse cenário, os parâmetros são preenchidos automaticamente a partir das informações importadas no mailing utilizado pela campanha.

Para mais informações, consulte:
Utilizando variáveis via mailing nas campanhas de WhatsApp.

Upload de Mídia

• Arquivo de mídia:
  Caso o template possua mídia configurada na Gupshup (imagem, vídeo ou documento), será necessário realizar o upload do mesmo arquivo no cadastro do template dentro do Tactium.A mídia enviada deve corresponder exatamente ao conteúdo previamente aprovado na Gupshup.

Funcionalidades Disponíveis

• Em desuso:
  Permite desativar o template sem remover sua configuração do sistema.
• Salvar:
  Grava as configurações realizadas e disponibiliza o template para utilização.
• Remover:
  Exclui o template da configuração do serviço.

Usando o Ativo Manual com Templates

Após concluir os cadastros dos templates eles estarão disponíveis no OmniPA para para envio de mensagens. Para mais informações acesse Realizando envio de mensagens ativa manual (WhatsApp).