Criando uma conta na Meta e GupShup para o canal WhatsApp

---

Pré-requisito

Antes de iniciar a ativação no Tactium será necessário habilitar o número como “Live” dentro da plataforma do GupShup.

Conta Facebook verificada

O primeiro passo é garantir que sua conta de Facebook no Gerenciador de Negócios esteja marcada como “Verificada”. Para mais informações acesse, o nosso blog, guia para verificação de sua conta no gerenciador de negócios do Facebook.

Conta GupShup criada

O passo seguinte é criar uma conta no site da GupShup (www.gupshup.io), que servirá para consultar/emitir relatórios de envio / recebimento de mensagens pelo GupShup, visando acompanhar o consumo e cobranças, configurar a(s) aplicação(ões) vinculadas a cada número de WhatsApp Oficial habilitado e cadastrar as mensagens padrão/templates a serem utilizadas nas comunicações de ativo, sendo a recarga de créditos, para custear as mensagens trafegadas, é feita em dólares: cartão de crédito internacional, transferências bancárias.

Habilitação da aplicação do GupShup

Próximo passo será habilitar o número no GupShup devendo seguir as orientações contidas na nossa documentação: Ativação Gupshup.

IMPORTANTE:

• O número a ser habilitado no GupShup não pode estar sendo usado no WhatsApp, e também não poderá mais ser habilitado no WhatsApp Emulado.
• Um número de WhatsApp somente pode ser vinculado a um aplicativo no GupShup.
• Um número que já esteja habilitado no WhatsApp oficial com outro broker não poderá ser migrado para o GupShup. Poderá ser desativado no outro broker e após um período de aproximadamente 6 meses é que é liberado novamente.

Integrando a aplicação do GupShup com o Tactium

Para iniciar as configurações no TACTIUM OMNI será necessário obter as 5 informações no portal da Gupshup e no portal Gupshup Partner  para configurá-lo no Tactium obtendo as seguintes informações:

• API KEY
• APP NAME
• URL de INTEGRAÇÃO
• APP ID
• APP TOKEN

Dados do Portal GupShup

As informações referentes a API KEY, APP NAME e URL de INTEGRAÇÃO são encontradas na aba “SandBox” acessando o aplicativo no Dashboard.

Após copiar as informações, recomendamos transferi-las para um arquivo .txt para auxiliar a visualização das informações necessárias.

Dados do Portal Partner GupShup

As informações referentes ao APP ID e ao APP TOKEN são encontradas no detalhamento do aplicativo no Dashboard.

Configurar o WebHook no Portal do GupShup

O link do WebHook do TACTIUM OMNI deverá conter o protocolo de segurança https com o método do GupShup definido na URL. Em vermelho sinalizamos os dados que serão variáveis de acordo com o site configurado no cliente.

https://SiteDomínioDoCliente/Omni/Webhook/hook/messageGupShup

Para mais informações acesse Configurando o Webhook do Tactium Omni. Exemplo da URL no ambiente da Tactium: https://tactium.com.br/Omni/Webhook/

Para adicionar um webhook, basta clicar em “Adicionar Webhook”, na tela que aparecer preencher os seguintes campos:

• Nome do Webhook (tag): Informando um nome de identificação para a configuração do Webhook;
• URL de retorno de chamada: Passando a URL de conexão com o Webhook.

IMPORTANTE: Caso o Webhook esteja em um ambiente que possua um Nat configurado em seu firewall será necessário adicionar os IP’s da GupShup na whitelist do firewall para permitir a comunicação. Para mais informações sobre os IPs da GupShup acesse: Quais os IPs públicos da GupShup para adicionar no firewall.

Em seguida, iremos definir as assinaturas dos eventos que iremos receber na URL de Callback cadastrada anteriormente:

A assinatura de eventos de webhook  é uma prática essencial para receber notificações em tempo real sobre as atividade do nosso serviço. Orientamos que sejam habilitados todos os eventos abaixo para funcionamento correto.

A priori não recomendamos o uso de mais de uma conexão de webhook.

Desabilitar o OPT-IN diretamente do GupShup

O OPT-IN poderá ser habilitado no TACTIUM que por sua vez está integrado com o GupShup. Portanto, será necessário desabilitar esse recursos diretamente no portal do GupShup, apenas clicando no botão para não ser enviada a mensagem do GupShup automática do OPT-IN.

Esse passo é necessário fazer sempre, visto que o OPT-IN não poderá ser obtido diretamente do GupShup sem passar pelo Tactium, já que a gestão do OPT-IN é gerenciada na plataforma do Tactium integrada com o GupShup.

Vinculando código Partner ISV Tactium no GupShup

O nosso código é o 78 e precisa ser configurado na parte superior das configurações avançadas no aplicativo do GupShup.

Configurando um template para envio de mensagem

Para iniciar uma mensagem ativa no WhatsApp, torna-se necessário a criação das mensagens templates que são usadas para abrir uma sessão por iniciativa da empresa.

Colocamos esse item como obrigatório, pois é recomendado ter pelo menos um template para ser usado caso abrir a sessão com o cliente.

Para mais informações acesse Configurando Template do GupShup para Ativo.

Configurando a solicitação de OPT-IN no receptivo (opcional)

Para configurar a solicitação do OPT-IN automático do Tactium no receptivo com um link será necessário realizar os passos à seguir, sendo:

Essa mensagem será enviada para todo cliente que for atendida pelo operador.

Trata-se de uma mensagem automática e só enviada para os clientes que não possuem OPT-IN registrados na base de dados do Tactium.

É importante garantir que não esteja habilitado no GupShup. Para mais informações de como desabilitar volte ao tópico Desabilitando o OPT-IN diretamente no GupShup.

Para habilitar acesse o aplicativo ManagerADM, em cadastro de serviços >>> WhatsApp GupShup >>> Integração e marque o botão   e adicione a mensagem que antecederá o link que será enviado automático pela aplicação Tactium.

Essa mensagem será enviada logo após a mensagem de saudação que o operador envia automaticamente ao iniciar o atendimento no OmniPA.

Após concluir os passos acima e habilitar o parâmetro, o cliente ao enviar uma mensagem receptiva receberá a mensagem padrão:

Esse link é criado automaticamente através da solução Tactium.

Ao clicar no link é apresentado a seguinte mensagem sinalizando que o número encontra-se com o OPT-IN registrado.

Configurando a identidade visual da solicitação OPT-IN (opcional)

Na tela do registro OPT-IN temos as seguintes informações que podem ser configuradas:

Logo da empresa:	A logo da empresa é retirada diretamente da imagem que foi configurada nos Parâmetros do ManagerADM em Configurações>>Parâmetros>>Logotipo
Nome da empresa:	Em desenvolvimento – Colocar o parâmetro no ManagerADM e não colocar a informação pelo banco de dados. O nome da empresa presente na frase de requisição OPT_IN é retirado da coluna NM_PAR_EMPRESA presente na tabela T_PAR. Caso o nome do registro OPT-IN esteja diferente do nome real da empresa, entre em contato com o Suporte Tactium.

Ao finalizar a configuração da identidade visual, ao ser direcionado para o link do Registro OPT-IN aparecerá: