Configurando a API na Meta para uso do canal Facebook Messenger/Instagram Direct

---

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 configuração do Messenger será necessário criar uma 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, a categoria e uma descrição breve (opcional).

Na configuração do Direct será necessário criar um perfil do Instagram:

• Crie um perfil no Instagram como qualquer outra conta.

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 Instagram com Webhook no Meta for Developers

Devido a similaridade do processo de cadastro de serviços de Instagram e Messenger no App da Meta, decidimos descrever um deles para descrever os dois, considerando que atualmente grande parte dos passos são praticamente intercambiáveis.

Encontrando os Casos de Uso

Com um aplicativo criado, é preciso realizar os procedimentos de conexão do Messenger com o Webhook. Busque pelo menu de Casos de Uso e encontre a opção de Messenger/Instagram. Clique no botão na direita escrito “Personalizar”:

Permissões e recursos

O primeiro menu de personalização de caso de uso é o de Permissões e recursos. Ele é útil somente se houver alguma necessidade especial pela coleta de dados do usuário ou comportamento do messenger, como por exemplo, aguardar atendimento humano por 7 dias antes de deletar uma mensagem, ou coletar e guardar dados de contato do usuário.

Quando estiver satisfeito com suas opções, clique em “Configurações da API do Messenger/Instagram” para continuar:

Configurações da API do Messenger/Instagram

Configure webhooks

Agora precisamos informar a URL de Callback e o Token a serem utilizados para comunicação com o serviço cadastrado no cliente:

As informações que você precisa digitar são essas:

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

Não sabe qual sua URL? Siga esse passo a passo:

1. Acesse seu crm admin: https://SiteDoCliente/crm/admin
2. Procure por “Configurações”
3. Dentro de “Configurações”, procure por “Configurações Gerais”
4. Dentro de “Configurações Gerais”, use a barra de pesquisa para pesquisar por “webhook”
5. Pegue o link que está sendo usado por um dos parâmetros e formate o seu link encontrado dessa forma:

link encontrado/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.

Gere tokens de acesso

Agora vamos coletar os dados que precisamos informar no serviço do sistema da Tactium para realizar a conexão com o webhook. Para isso, selecione a página que terá suas mensagens extraídas:

Um popup do Facebook vai abrir, e tudo que você precisa fazer é clicar em “continuar” até ele fechar:

E com isso feito, temos nossa página do facebook associada com o App. Mas só isso não é o bastante para seu funcionamento. Precisamos agora, assinar os campos de webhook e gerar o token:

Assinar um campo é como dizer para o webhook que informações do chat do messenger ele deve trazer para o Omni Client. Nesse caso, precisamos só das mensagens, então selecione somente “Messages”:

Após isso, precisamos apenas clicar em “Gerar Token”. É importantíssimo que você copie e cole esse token em um bloco de notas ou algum lugar, pois ele só poderá ser revelado durante sua criação, ficando oculto logo em seguida:

Guarde as informações do Token e o Id (sequência de números encontrada abaixo do nome da página) para utilizar no cadastro do serviço de Facebook Messenger ou Instagram Direct. Para deixar claro, o Id deve ser usado como a cifra do serviço.

Configurando o Serviço no Tactium OMNI

A configuração do serviço deverá ser realizada a partir do CRM Admin. Para mais informações de como realizar esse processo acesse a documentação Realizando a configuração de um serviço de Facebook Messenger no Tactium OMNI.

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.

Permissões e recursos	Usos
Business Asset User Profile Access	O recurso Acesso ao perfil do usuário de ativo comercial permite que o aplicativo leia os Campos do usuário de usuários que interagem com seus ativos comerciais como ID, ids_for_business, nome e foto. O uso permitido desse recurso serve para ler um ou mais dos Campos do Usuário em uma experiência no aplicativo de negócios. Você também pode usar esse recurso para solicitar informações de análise com o objetivo de aprimorar seu aplicativo e para fins de marketing ou publicidade, por meio do uso de informações agregadas e anônimas ou sem identificação (desde que tais dados não possam ser identificados novamente).
Human Agent	O recurso Human Agent permite que seu aplicativo use um agente humano para responder às mensagens de usuários com a tag human_agent até sete dias após o envio da mensagem por um usuário. O uso permitido do recurso é para oferecer o suporte de um agente humano nos casos em que o problema do usuário não pode ser resolvido na janela de mensagens-padrão. Por exemplo, quando a empresa fechar no fim de semana ou a questão exigir mais de 24 horas para ser resolvida.
Instagram Public Content Access	O recurso Acesso ao Conteúdo Público do Instagram possibilita que seu aplicativo acesse os pontos de extremidade da Pesquisa de Hashtag da Graph API do Instagram. O uso desse recurso é concedido para descobrir conteúdo associado às suas campanhas de hashtag, entender o sentimento do público com relação à sua marca ou identificar participantes de concursos, competições e sorteios. Ele também pode ser usado para fornecer suporte ao cliente, além de compreender e gerenciar melhor seu público. A permissão também pode ser usada para solicitar insights de análise a fim de melhorar o app. Além disso, ela pode ser usada para fins de marketing ou de publicidade, por meio do uso de informações agregadas, anônimas ou sem identificação (desde que não seja possível identificar esses dados novamente).
ads_management	Com a permissão ads_management, seu aplicativo pode ler e gerenciar a conta de anúncios que possui ou à qual teve ou que tenha recebido acesso pelo proprietário da conta de anúncios. Essa permissão pode ser usada para programar a criação de campanhas, o gerenciamento de anúncios ou a busca por métricas de anúncio para ajudar nos negócios. Além disso, também pode ser usada para criar ferramentas de gerenciamento que forneçam soluções inovadoras e valores diferenciados para os anunciantes. Você também pode usar essa permissão para solicitar informações de análise com o objetivo de aprimorar seu aplicativo e para fins de marketing ou publicidade, por meio do uso de informações agregadas e anônimas ou sem identificação (desde que tais dados não possam ser identificados novamente).
ads_read
business_management
catalog_management
email
instagram_basic
instagram_branded_content_ads_brand
instagram_branded_content_brand
instagram_branded_content_creator
instagram_business_basic
instagram_business_content_publish
instagram_business_manage_comments
instagram_business_manage_insights
instagram_business_manage_messages
instagram_content_publish
instagram_creator_marketplace_discovery
instagram_manage_comments
instagram_manage_contents
instagram_manage_engagement
instagram_manage_insights
instagram_manage_messages
instagram_manage_upcoming_events
instagram_shopping_tag_products
pages_read_engagement
pages_show_list
public_profile