Configurando o Serviço do Facebook Messenger no Tactium OMNI

---

Pré-requisito

Disponibilizar uma página no Facebook para que o cliente possa interagir a partir do Facebook Messenger, nela será criado o aplicativo que terá a integração com o Tactium Omni.

Para criar a página do Facebook você pode acessar a página Criando uma Página do Facebook do próprio Facebook, é necessário informar apenas o nome dela e também a categoria com uma descrição breve (opcional). Para mais informações acesse o link informado anteriormente.

Também é necessário possuir um aplicativo no Meta for Developers. Caso não possua um aplicativo basta acessar Configurando um app no Meta for Developers.

Habilitando e Configurando o Messenger e o Webhook no Meta for Developers

Com o Meta for Developers devidamente configurado, é preciso as realizar os procedimentos de conexão do Messenger com o Webhook, para habilitar será necessário clicar em “Configurações” do produto “Messenger”.

Em seguida aparecerá no menu lateral os produtos associados. Nas configurações do Messenger, primeiramente temos que clicar no botão de “Adicionar ou remover Páginas”, para vincular a página que utilizaremos para o serviço.

Após será listado todas as páginas do Facebook que o usuário tem acesso, para realizar o vinculo da página que foi criada inicialmente com o app do Facebook, selecione a página desejada vincular e clique em “Avançar”.

Na página adicionada clique em “Gerar token” e selecione “Estou ciente”.

IMPORTANTE: Antes de clicar em “Concluir”, clique em “Copiar” para guardar esse token, pois ele será utilizado posteriormente.

Ainda nas configurações do Messenger, localize o Webhook e clique no botão de “Configure” para vincular a URL de retorno, que será o Webhook do Tactium Omni e também o Token que é um parâmetro fixo da Tactium.

Em vermelho sinalizamos as informações que serão específicas do cliente de acordo com os seu cenário.

• URL: https://SiteCliente/AppCliente/hook/messageFacebook
• Token (fixo): 4c54507e-72cf-44c1-bee0-3aa0d28849dc

Exemplo de URL padrão:

https://softium.com.br/Omni/Webhook/hook/messageFacebook

Essa URL precisará ter o certificado SSL instalado (https) no servidor do cliente que o Webhook do Tactium estiver sido instalado. Ela também precisará estar disponível na internet para que o Facebook possa enxergar e se comunicar com o nosso Webhook.

Por fim, será necessário clicar em “Adicionar assinaturas”, marcar “messages” e “Salvar”.

Habilitando usuários para testes na aplicação

Esse processo consiste em realizar a liberação de usuários para a validação do Instagram, sem a aprovação final do Facebook (do Meta), visto que nesse primeiro momento somente usuários nominais (específicos) poderão interagir com o Instagram e responder pela API de integração.

Existem duas formas para incluir esses usuários de testes, sendo:

1. Com usuários de teste específicos que são gerados com ID e senha de acesso. Para mais informações acesse Cadastrando usuários de testes no aplicativo do Meta for Developers.
2. Com usuários válidos associados nas funções do aplicativo com o perfil de teste. Para mais informações acesse Vinculando usuários válidos nas funções do aplicativo no Meta for Developers.

Configurando o serviço do Facebook no Tactium OMNI

Após concluir a criação da página no Facebook e ter realizado as configurações iniciais no app do Developers, teremos que cadastrar o serviço do Facebook no ManagerADM. Para isso, antes de iniciarmos o cadastro do serviço, precisaremos obter as seguintes informações:

• ID da página – Os números obtidos no endereço (URL) da página do Facebook;

Caso você não consiga localizar o ID da página pela URL, você pode conseguir acessando pelo Meta for Developers (como no exemplo abaixo).

• Token – Obtido no vinculo da página;

• URL de integração (fixo) – https://graph.facebook.com/v11.0/me/messages
  • A URL de integração deve estar de acordo com a versão implementada no Developers. Para saber a versão atual acesse Registro de alterações.

Configurando o path e as permissões das pastas para troca de anexo do Tactium

Torna-se necessário realizar as configurações das pastas de anexos que são feitas dentro do ManagerADM, e dar as permissões das pastas para o funcionamento da aplicação. Para saber mais sobre as permissões acesse Configurando as permissões e o compartilhamento da pasta de anexo.

No Facebook é restrito apenas a troca dos seguintes tipos de mídia imagens, vídeos, gifs, figurinhas e emojis.

Configurando o link do WebHook

Se torna necessário a configuração dos links do Webhook para o funcionamento das integrações com as API’s dos canais de messaging e das pesquisas de satisfação que são associadas juntamente à essa camada de integração. Portanto, deve-se configurar os parâmetros interno e externo em Configurações Gerais no ManagerADM. Para mais informações acesse Configurando o link externo e interno Webhook no TACTIUM.

Solicitação da análise do aplicativo para aprovação do Facebook

Para finalizar, será obrigatório para o cliente solicitar à análise e receber a aprovação do Meta for Developers para o uso da sua aplicação de forma pública, isto é, que todos os clientes consigam interagir de forma transparente.

Porém, um pré-requisito para poder iniciar essa etapa será garantir que o Tactium Omni esteja 100% em funcionamento em ambiente interno, trocando todas as mensagens e fazendo todas as interações necessárias entre a página do Instagram Direct e o Tactium OmniPA usando os usuários de testes.

Para saber mais informações acesse de como deverá ser submetido essas análises acesse  Solicitando Análise do Aplicativo para Aprovacao do Facebook no uso do Tactium OMNI.

Após o envio, você receberá diversas notificações do desenvolvedor na caixa de entrada de alertas informando sobre o status da sua solicitação. Normalmente, leva menos de uma semana para processar o envio, ou até mesmo de 2 a 3 dias. Porém, o processo poderá demorar mais em períodos de pico.