Descrição de permissões e Instrução de teste para Meta - Aplicativo

Quando estiver criando seu aplicativo do Facebook e/ou Instagram, a Meta solicitará um descritivo das permissões e uma instrução de teste.

Esse material deve ser seguido após o material abaixo: 

Como criar um aplicativo na Meta para integrar o Chat Corp com o Facebook e Instagram

Descrição de cada permissão

Informações que devem ser enviadas para a Meta.

business_asset_user_profile_acess

Conte para nós como você está usando essa permissão ou recurso.
Nosso aplicativo utiliza esta permissão apenas para acessar o nome e a foto de perfil dos usuários que interagem com nosso ativo comercial através do Messenger. Essas informações são usadas para personalizar a comunicação e melhorar a experiência do usuário durante as interações.

pages_manage_metadata

Nosso utiliza o pages_show_list para listar os aplicativos de páginas gerenciados pelo usuário, permitindo que ele escolha qual página deseja conectar. A permissão pages_manage_metadata é utilizada como complemento para gerenciar webhooks e configurar notificações de atividades em tempo real.

A permissão será utilizada exclusivamente para registrar-se em webhooks relacionados às atividades da página conectada ao nosso aplicativo, especificamente para receber mensagens enviadas para o Instagram conectado.

business_management

Conte para nós como você está usando essa permissão ou recurso.
A permissão business_management está sendo solicitada porque é um requisito necessário para ativar a permissão instagram_manage_messages. Por meio dela, o aplicativo pode gerenciar e configurar ações comerciais, garantindo assim a possibilidade de se inscrever nos Webhooks de uma conta comercial do Instagram. Dessa forma, o aplicativo poderá monitorar e responder a eventos relacionados a mensagens, mantendo uma integração contínua e eficiente com as interações dos clientes na plataforma.

pages_show_list

Conte para nós como você está usando essa permissão ou recurso.
Nosso aplicativo usa a permissão `pages_show_list` para acessar e exibir a lista de páginas do Facebook que um usuário gerencia. Essa funcionalidade é crucial para permitir que os usuários selecionem páginas específicas que desejam integrar ao nosso sistema de bate-papo corporativo. Depois que um usuário integra uma página, o aplicativo estabelece uma conexão que permite que a plataforma de Chat passe a receber as mensagens recebidas na página do Facebook.

Sem essa permissão, o aplicativo não pode funcionar como pretendido porque seria incapaz de identificar e conectar as páginas gerenciadas do usuário ao sistema de bate-papo corporativo.

pages_messaging

Conte para nós como você está usando essa permissão ou recurso.
A permissão `pages_messaging` é necessária para que nossa aplicação gerencie e acesse as conversas da Página Comercial, permitindo que os atendentes respondam aos usuários que entram em contato via Messenger. Essa funcionalidade é essencial para fornecer às empresas uma maneira eficiente de atender seus clientes na rede social.

O Screencast terá os passos de testar o uso da permissão, demonstrando o fluxo de recebimento e envio de mensagens na plataforma.

Caso não consigam testar a permissão, nos informe o que ocorreu durante a análise para podermos realizar os ajustes necessários. Vale ressaltar que, somente usuário com acesso administrativo ao aplicativo conseguem receber a mensagem do bot no Facebook, por isso foi disponibilizado um usuário de teste do Facebook.

Forneça instruções passo a passo para nos orientar sobre como testar essa integração.
Para este teste utilize as credenciais de acesso do usuário do Facebook: 
(Forneça um usuário do Facebook)

1. Envie uma mensagem à Página e escolha um setor de atendimento digitando o número da opção ou o nome do setor. 
2. Acesse: (Informe seu endereço para acessar a sua solução)
3. Efetue login no site com as credenciais de teste: 
(Forneça um usuário de acesso a sua plataforma)

4. Após efetuar login na plataforma, clique em 'Iniciar Chat' no painel de navegação esquerdo.
5. Na tela terá os atendimentos vindos do Facebook Messenger, para iniciar o atendimento basta clicar no ícone de 'v' no contato que tem o ícone do Facebook e siga com o atendimento.

instagram_manage_messages

Conte para nós como você está usando essa permissão ou recurso.
A permissão 'instagram_manage_messages' é necessária para permitir que nossa aplicação gerencie e acesse as mensagens recebidas pelas contas comerciais do Instagram de nossos clientes após a integração. Isso possibilitará que os atendentes respondam aos usuários que entrarem em contato com a empresa via DM diretamente através da nossa plataforma. Essa funcionalidade é essencial para fornecer uma maneira eficiente e simplificada para que as empresas atendam seus clientes na rede social, melhorando a comunicação e o atendimento ao cliente.

O Screencast terá os passos de testar o uso da permissão, demonstrando o fluxo de recebimento e envio de mensagens na plataforma.

Utilize o usuário abaixo com permissão de testador do aplicativo, enviando uma mensagem a conta Profissional do Instagram:
(Informe um usuário do Instagram com função de testador do aplicativo)

instagram_basic

Conte para nós como você está usando essa permissão ou recurso.
A permissão 'instagram_basic' será utilizada para obter informações básicas da conta profissional do Instagram, especificamente o ID e o nome da conta vinculados a uma página do Facebook. Essas informações serão utilizadas em nosso sistema para gerar o token da página e habilitar a funcionalidade de troca de mensagens entre nosso aplicativo e a conta do Instagram do usuário.

No screencast, apresentaremos o fluxo completo de integração com a conta do Instagram, incluindo como as permissões são concedidas, quando o usuário dá permissão a mais de uma conta e como ocorre a troca de mensagens.

Etapas Detalhadas para Testar a Integração do Chat Corp

Se possível, gravar um vídeo realizando os passos abaixo para enviar a Meta.

1. Acesso ao Site de Teste:
- Abra o seu navegador e acesse: 
(Informe a URL para acessar o Chat Corp).

2. Login no Sistema:
- Insira suas credenciais de acesso (usuário e senha) e clique em "Entrar".
- Após o login, você será direcionado ao painel principal do Chat Corp.

3. Teste das Permissões “pages_show_list” e “pages_manage_metadata”:
- No menu lateral, clique em "Integrações".
- Na seção do Facebook, selecione "Gerenciar".
- Clique em "Conectar Facebook".
- Siga o fluxo de login do Facebook, garantindo que você concede todas as permissões solicitadas, especialmente a "pages_show_list".
- Confirme a integração e verifique se ela já está integrada no sistema.

4. Acesso à Área de Mensagens:
- No menu lateral, selecione "Iniciar Chat".
- Acesse a aba "Atendimentos".
- Nesta tela, todas as interações provenientes do Facebook Messenger e Instagram Direct serão centralizadas.
- Para iniciar um atendimento, clique no ícone de 'v' ao lado da mensagem recebida.

5. Teste das Permissões Relacionadas ao Instagram:

  a. Teste da Permissão "instagram_basic":
  - No menu "Integrações", vá até a seção do Instagram e clique em "Gerenciar".
  - Selecione "Conectar Facebook" e siga o fluxo de autenticação.
  - Conceda as permissões necessárias para o aplicativo acessar sua conta do Instagram.
  - Nota: Certifique-se de que sua conta do Instagram está conectada a uma página do Facebook.

  b. Teste da Permissão "instagram_manage_messages" e “business_management”:
  - Usando uma conta diferente (por exemplo, uma conta do Instagram de teste fornecida abaixo), envie uma mensagem direta para o Instagram que você integrou.
  - Retorne ao Chat Corp e verifique se a mensagem aparece na aba "Atendimentos" no menu Iniciar Chat.
  - Inicie o atendimento clicando no ícone de 'v' e responda à mensagem.
  - Este passo confirma o funcionamento da permissão "instagram_manage_messages", que depende da "instagram_basic". Sem a permissão “business_management”, não recebemos os webhook de mensagens recebidas no Instagram.

6. Teste das Permissões Relacionadas ao Facebook Messenger:
- Com o usuário do Facebook que utilizou para integrar sua página, envie uma mensagem para a página.
- No Chat Corp, acesse a aba "Atendimentos" e verifique se a mensagem foi recebida.
- Clique no ícone de 'v' para iniciar o atendimento e responda à mensagem.
- Este procedimento verifica a permissão "pages_messaging", que é dependente da "pages_show_list".

Observações Importantes:
- Certifique-se de utilizar contas e páginas com permissões administrativas para realizar as integrações.