Integração Messenger via Zenvia NLU

Essa integração só pode ser feita em uma página comercial do Facebook

Para começar, acesse a página principal do Facebook e realize o login em sua conta pessoal, selecionando no menu horizontal a opção entrar.

A página comercial é criada dentro da sua conta pessoal no Facebook, desta forma, você será o administrador da página empresarial. Caso não tenha uma página comercial ou esteja com dificuldade na criação, entre em contato com o nosso suporte:

suporte@smarkio.com.br

Não recomendamos a criação de um perfil falso no Facebook, pois você corre o risco de ter o perfil da empresa excluído por não seguir as diretrizes do Facebook. Então, se ainda não tem um perfil pessoal, acesse o Facebook e clique em “criar conta nova conta”.

Após acessar a conta, localize a opção de gerenciamento de páginas do facebook

Facebook for Developers

Acesse o site Facebook for Developers, clique em Entrar e faça login com as credenciais do seu Facebook pessoal.

Se estiver efetuando o login pela primeira vez, será necessário se registrar, confirmando algumas informações pessoais, como e-mail e número do celular. Por fim, selecione qual das funções melhor descreve você.

Após logar, selecione a opção Meus Aplicativos no menu superior e vá em Criar aplicativo.

Selecione o tipo de aplicativo Empresa e preencha os dados obrigatórios solicitados, cada opção é acompanhada por uma breve descrição;

Nome de exibição do aplicativo: Este é o nome do aplicativo associado ao seu ID do aplicativo
Email de contato do aplicativo: Normalmente colocamos o e-mail do nosso facebook pessoal, onde está a nossa página comercial
Finalidade do aplicativo: Opção que define o seu caso de uso

Com o aplicativo criado, aparecerá a tela de Adicionar produtos ao seu aplicativo, e nesta tela adicione o Messenger.

Agora que criamos um aplicativo Messenger, precisamos vinculá-lo à sua página do Facebook, então clique em Adicionar ou remover Páginas, em seguida, perguntará se você deseja continuar o processo com a conta do seu facebook pessoal, clique em Continuar.

Selecione a página desejada, conforme na imagem abaixo:

Em seguida, aparecerá uma tela com a opção de permitir que o Aplicativo gerencie e acesse suas conversas da página, deixe selecionado Sim e depois Concluir.

Clique em código numérico para copiar a ID da página, e depois clique em Gerar Token, para obter o Token de Acesso, conforme a imagem abaixo:

Somente o Administrador consegue visualizar a página com o ID e Token, logo, será necessário passar para o Desenvolvedor essas informações para serem usadas na Integração Zenvia NLU.

A etapa de configuração do Webhook é a única etapa de responsabilidade do Desenvolvedor da Smarkio que atua no projeto, para isso, é necessário criar um perfil de Desenvolvedor no seu Aplicativo do Facebook for Developers, clicando na opção Funções no menu esquerdo do Aplicativo.

Em seguida, clique em Adicionar Desenvolvedor e aparecerá um pop-up solicitando que digite o nome do usuário que deseja atribuir a permissão, a priori será feito uma busca na lista de amigos do Facebook e para adicionar alguém de quem não tem como amigo no Facebook, digite seu fbid ou nome de usuário ( endereço web de seu perfil ou Página, por exemplo, facebook.com/seunome).

Clique aqui e saiba mais sobre as permissões de cada perfil.

Depois de criar um novo acesso, o Desenvolvedor Smarkio deverá se registrar e acessar sua conta do Facebook for Developers com as credenciais do seu Facebook pessoal. Ao acessar sua conta, receberá a notificação do aplicativo do Administrador, basta Confirmar.

Em seguida, o Aplicativo recém vinculado aparecerá na página Meus Aplicativos, clique e acesse-o, em seguida, no menu vertical esquerdo clique em Messenger , depois Configurações, por fim clique em Adicionar URL de retorno, na seção Webhooks, e preencha com os dados do Zenvia NLU: URL e Token.

Neste momento a página comercial vinculada ao Aplicativo, pelo Administrador, não aparecerá para o Desenvolvedor, mas não tem problema, é só ignorar e realizar a configuração do webhook normalmente.

Para obter a URL e Token do webhook da Integração com o Facebook, basta solicitar ao e-mail suporte.jira@zenvia.com

No menu esquerdo, o Desenvolvedor ou o Administrador, pode acessar as Configurações e em seguida selecione Básico para ter acesso à Chave Secreta do Aplicativo:

Por fim, o Administrador irá acessar novamente o Aplicativo e, no menu vertical esquerdo, clicar na opção Messenger e depois em Configurações, Na seção de Webhooks Adicionar assinaturas, selecione as caixinhas messages , messaging_postbacks e messaging_handovers

Zenvia NLU Connect

No Zenvia NLU vá até Connect > Canais > Facebook, clique no botão ➕ para criar uma nova integração e preencha os seguintes campos:

Nome: nome da sua integração
Assistente: selecione o assistente
Squad: selecione o nome da squad se estiver disponível na lista, caso contrário mantenha como “geral”
Segredo da aplicação: Token disponibilizado para perfil Administrador e Desenvolvedor do Aplicativo no site Facebook for Developers (Ao logar na sua conta, acesse o menu lateral esquerdo > Configurações > Básico > Chave secreta do aplicativo) Secret e clique no botão de exibir para visualizar o segredo da sua aplicação.
ID da Página: ID disponibilizada no site do Facebook for Developers apenas para o perfil Administrador do Aplicativo no site Facebook for Developers (Ao logar na sua conta, acesse o menu lateral esquerdo > Messenger > Configurações > Na seção “Tokens de Acesso” )
Token de Acesso: Token disponibilizado no site do Facebook for Developers apenas para o perfil Administrador do Aplicativo no site Facebook for Developers (Ao logar na sua conta, acesse o menu lateral esquerdo > Messenger > Configurações > Na seção “Tokens de Acesso”)

Ao criar a integração no Zenvia NLU, volte à página comercial do Facebook e certifique-se das configurações:

Acesse o seu facebook pessoal, vá em Páginas e clique em Suas páginas

No menu lateral esquerdo, clique em Configurações > Configurações avançadas de mensagens

Irá aparecer o seu aplicativo criado no Facebook for Developers, o qual você vinculou a página, clique em Configurar e vá em integrações comerciais e confira se a sua está na aba de ativas!

Pronto, mande uma mensagem para o messenger da página comercial e teste!

Lembre-se que o assistente precisa estar publicado hein... 😀

Submetendo seu Aplicativo Messenger à revisão

Ainda falta mais uma etapa… 😅

Ao realizar os testes você deve ter notado que o Assistente só funciona nos perfis de Administrador, Desenvolvedor ou Tester, os demais usuários não conseguem interagir.

Após a conclusão da integração, o Facebook tem seu próprio processo de revisão para aplicativos que são publicados no Messenger. O assistente será testado para garantir que esteja em conformidade com as políticas estabelecidas.

Para dar início à submissão, o Administrador deverá acessar o Aplicativo da Integração, no site do Facebook for Developers, clicar na opção do menu esquerdo Análise do aplicativo, depois Permissões e recursos, procure na lista de permissões a pages_messaging e clique em solicitar acesso avançado.

Esse processo deve ser feito pelo Administrador

Messenger Platform - App Review - Documentation - Facebook for DevelopersFacebook for Developers

1°- Passo:

Antes de iniciar o processo de envio da análise do aplicativo, verifique se você concluiu cada uma das etapas descritas abaixo. Isso melhora a qualidade do seu envio e reduzirá as chances de rejeição.

Carregue uma imagem vetorizada de ícone do aplicativo compatível de no máximo 1.024 x 1.024 pixels, JPG, GIF ou PNG, tamanho máximo de 5MB e para isso clique no aplicativo e vá em Configurações > Básico > Ícone do aplicativo.
Adicione a URL da Política de Privacidade, neste campo pode incluir a “URL da Política de Privacidade oficial da plataforma Messenger e salvar alterações”: https://developers.facebook.com/docs/messenger-platform/policy/policy-overview

Referencia: https://developers.facebook.com/docs/app-review/before-you-submit

2°- Passo:

Para dar início à submissão, o Administrador deverá acessar o Aplicativo da Integração, no site do Facebook for Developers, clicar na opção do menu esquerdo “Análise do aplicativo”, depois “Permissões e recursos”,em seguida clique em “Solicitar Acesso Avançado”

Em seguida clique em “Editar solicitação de análise do aplicativo” para ver as 3 etapas da submissão do aplicativo: Concluir verificação do aplicativo, Recursos e permissões solicitadas e Concluir configurações do aplicativo.

Concluir verificação do aplicativo

Nesta etapa forneceremos detalhes para verificação do nosso aplicativo.

Selecione a opção “Sim”, conforme a imagem abaixo, na primeira pergunta.
Em seguida, clique em “Adicionar plataforma”, você será direcionado para outra página onde será necessária a verificação individual da sua identidade, então suba na página, vá até a seção de “Verificação” > selecione “Verificação Individual” e faça upload da foto do seu RG ou CPF.
Feito isso, ainda na mesma página, desça e clique em “+ Adicionar plataforma” , depois clique em “Site” e adicione a URL do seu Assistente em Web Chat (Widget).

Volte ao início, em Análise do aplicativo > Solicitações, vá na primeira etapa de novo e aparecerá mais um campo para você preencher, solicitando instruções passo a passo de como um analista do Facebook pode acessar seu aplicativo

Inclua a instrução, conforme o exemplo abaixo:

Exemplo: Clique no ícone do Messenger para iniciar o atendimento, diga "Oi" ou clique na mensagem de sugestão do messenger para iniciar o atendimento, o assistente irá solicitar o seu nome para começar o atendimento, digite seu nome e prossiga com o atendimento, conforme o vídeo enviado

Recursos e permissões solicitadas

Nesta etapa responderemos basicamente “por que precisamos do pages_messaging?” e enviaremos um vídeo do nosso assistente funcionando para eles.

Então preencha o primeiro campo que pede uma descrição detalhada de como seu aplicativo usará a permissão pages_messaging, ou seja, deixar o assistente público.

Exemplo: “Abra meu assistente do Messenger clicando no botão 'Iniciar bate-papo agora' na página da minha empresa de pizzaria (https://www.facebook.com/Pizzaria-Qualy-103825991935076). Esse aplicativo fornece informações pertinentes para pessoas que desejam pedir pizzas.

Ele usa o mecanismo de resposta rápida para agilizar o atendimento e proporcionar um atendimento automatizado, sem filas e customizado para o nossos clientes.

Precisamos da permissão pages_messaging para deixar nosso assistente público, e proporcionar maior interação e engajamento entre os clientes que usam o canal do Messenger, atualmente ele funciona apenas para Administrador, Desenvolvedor ou Tester.”

Selecione a página comercial que o assistente está vinculado.
Descreva o passo a passo de como acessá-lo e realizar o teste:

Faça o upload do vídeo em MP4 mostrando o funcionamento do assistente no Messenger.
Marque a opção que concorda: “Se aprovados, você concorda que todos os dados recebidos por meio do pages_messaging serão usados conforme permitido.”

Concluir configurações do aplicativo

Nesta última etapa selecione a categoria do aplicativo “Bots do Messenger para negócios” e salve.

Depois disso é só enviar o aplicativo para revisão!

Criando o aplicativo teste

3°- Passo:

O aplicativo de teste nada mais é que uma redundância do aplicativo “pai ”, ele possui o status “em desenvolvimento” e somente por meio dele que os analistas do Facebook conseguem testar o seu aplicativo.

Para criá-lo é necessário clicar na opção do menu superior “Meus Aplicativos”, clique nos “três pontos” do aplicativo desejado e depois clique em “Criar Aplicativo de Teste”.