Configurando o Serviço do Instagram Direct no Tactium OMNI

---

Visão Geral

Esta documentação visa orientar e auxiliar no cadastro do serviço do Instagram no Tactium OMNI para a realização de atendimentos centralizados no OmniPA.

Pré-requisito

• Disponibilizar uma conta comercial no Instagram, caso o clientes que NÃO possua, para que o mesmo possa interagir a partir do Instagram direct. Você pode acessar a página Configurar uma conta empresarial no Instagram.
• Vincular a conta do Instagram a uma página do Facebook, e ter esta atualizada, para saber como vincula essas contas acesse Adicionar ou remover uma conta do Instagram da sua Página do Facebook.
• Vincular a Página do Facebook e conta do Instagram no Facebook Business Suíte, realizando também as autorizações dentro do Gerenciador de Negócio, para saber como realizar esse procedimento acesse Configurando o Facebook Business Suíte com o Instagram e o Facebook.

Fora os requisitos acima é 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 a conta do Instagram e o Webhook no Painel do app

No painel do Developers localize o produto “Messenger” e clique em ‘Configurar’, com isso será possível vincular a página do Facebook que contenha a conta do Instagram vinculada para uso da mensageria.

Após habilitar o produto “Messenger”, localize-o no menu lateral e vá em “Configurações do Instagram”. Feito isso na etapa ‘Tokens de acesso’ clique em “Adicionar ou remover Páginas” para vincular a conta do Instagram e a página do Facebook.

Ao clicar para adicionar a página você deverá realizar 3 passos importantes, são eles:

• Passo 01: Selecionar a conta do Instagram que será utilizada para o serviço de mensageria. É aconselhável salvar o ID da conta o Instagram.
• Passo 02: Selecionar a página do Facebook que está vinculada a conta do Instagram;
• Passo 03: Habilitar as permissões necessárias para a utilização dos serviço do Instagram.

Finalizando os passos anteriores, será apresentado uma notificação de vinculo entre a página do Facebook e a Aplicação do Meta for Developers.

Após a vinculação, será necessário gerar o token da página. Para isso ainda na etapa ‘Tokens de acesso’ clique em “Gerar token” e selecione “Estou ciente” da página adicionada.

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

Ainda nas configurações do Instagram, localize a etapa ‘Webhooks’ e clique no botão de “Adicionar URL de retorno” 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/messageInstagram
• Token (fixo): 4c54507e-72cf-44c1-bee0-3aa0d28849dc

Exemplo de URL padrão:

https://tactium.softium.com.br/Omni/Webhook/hook/messageInstagram

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 “Editar assinaturas”, marcar “messages” e “Salvar”.

Habilitando usuários para os 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.

Após concluir essas etapas, teremos que cadastrar o serviço do Instagram no ManagerADM. Para isso, antes de iniciarmos o cadastro do serviço, precisaremos obter as seguintes informações:

• ID da Conta do Instagram – Esses números são obtidos no ato da vinculação da conta ao Meta for Developers;
• Token – Obtido ao gerar o token após a vinculação da página do Facebook e conta do Instagram no Meta for Developers;
• URL de Integração (fixo) – https://graph.facebook.com/v12.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.

Com essas informações salvas em um bloco de texto, acesse COLOCAR LINK OFICIAL AQUI;

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, além de dar as permissões delas 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 da Meta

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.

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, com 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 Aprovacão 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.