# Integração Messenger via Zenvia NLU {% hint style="info" %} Essa integração só pode ser feita em uma página comercial do Facebook {% endhint %} Para começar, acesse a página principal do [**Facebook**](https://www.facebook.com/) e realize o login em sua conta pessoal, selecionando no menu horizontal a opção **entrar**. ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkJJDFHMF7IDu-0PWCe%2F-MkNCDVAWUiXPcrdaS88%2Fimage%20\(47\).png?alt=media\&token=a33d84c7-eefb-4d3c-8ccd-07eaa127d4c1) 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: {% hint style="danger" %} 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”. {% endhint %} Após acessar a conta, localize a opção de gerenciamento de páginas do facebook ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkJJDFHMF7IDu-0PWCe%2F-MkNCogCrenAWSAvTiFK%2Fmesse18.png?alt=media\&token=44ea0480-a836-4e1b-aefb-7db32d94f4d2) ## **Facebook for Developers** Acesse o site[ **Facebook for Developers**](https://developers.facebook.com/)**,** 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ê. ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkIJWC9o0srssIvXe1t%2F-MkIOpIidaddbvdGd_LC%2Fmesse2.png?alt=media\&token=4f63f8ce-fb62-42f0-bdaa-ca9d86c6596e) Após logar, selecione a opção **Meus Aplicativos** no menu superior e vá em **Criar aplicativo.** ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkIJWC9o0srssIvXe1t%2F-MkIOv8LIKjwgZvLv4lE%2Fmesse3.gif?alt=media\&token=dacf4da2-707e-4b2f-bba8-4a4387d4290c) 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 ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkIJWC9o0srssIvXe1t%2F-MkIP-cREiWyZsHVuJmV%2Fmesse4.png?alt=media\&token=839e0e84-ba2b-45cb-80b8-9ce0f2cc0a6a) Com o aplicativo criado, aparecerá a tela de **Adicionar produtos ao seu aplicativo**, e nesta tela adicione o **Messenger**. ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MaYViFBKjNIVNcugyR9%2F-MaYk5ky3agofyfEM3RO%2Fgif%20config%20app%20Messenger.gif?alt=media\&token=d950c1f2-6b47-49fe-a980-d3de4f74dd7b) 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**. ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkIJWC9o0srssIvXe1t%2F-MkIQSn0md9VzkZMTHzf%2Fmesse5.gif?alt=media\&token=b042ee11-375f-427c-a7d6-ee12657434fd) Selecione a página desejada, conforme na imagem abaixo: ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkIJWC9o0srssIvXe1t%2F-MkIQXnDE7bDKOu_7RC_%2Fmesse6.png?alt=media\&token=f5fa851c-df83-425d-a9a4-5c4efaa95adf) 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.** ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkIJWC9o0srssIvXe1t%2F-MkIQagA6o9Jcodo3bGO%2Fmesse7.png?alt=media\&token=62338f51-4122-4dec-9574-1a54768109b2) 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: {% hint style="info" %} 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. {% endhint %} ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkIJWC9o0srssIvXe1t%2F-MkIQf2-TxovSEfwZZK7%2Fmesse8.png?alt=media\&token=6b5f3055-7604-4833-a2b8-57f8899614ec) 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). ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkIJWC9o0srssIvXe1t%2F-MkIQifvg7DdBXJkq-4d%2Fmesse9.png?alt=media\&token=ccdc9d3c-773e-4ff4-9e01-9c444e6ad498) ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkIJWC9o0srssIvXe1t%2F-MkIQklxdLPJAbkVKWiU%2Fmesse10.png?alt=media\&token=26ad866e-ae65-45cf-b94a-5121db1b78f8) [**Clique aqui**](https://developers.facebook.com/docs/development/build-and-test/app-roles) 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.** ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkIJWC9o0srssIvXe1t%2F-MkIRCeNtgBIR7VS79G5%2Fmesse11.png?alt=media\&token=37aa10f3-05a4-405b-b252-25fefdfd5c11) ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkIJWC9o0srssIvXe1t%2F-MkIRMOGlsODBizrhXf6%2Fmesse12.png?alt=media\&token=9d69d3da-933e-4295-adcb-c272b26facae) 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**. {% hint style="info" %} 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. {% endhint %} ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkIJWC9o0srssIvXe1t%2F-MkIRWBJGHIYbPOfdKp3%2Fmesse13.png?alt=media\&token=34acfac4-2144-4349-9c1e-dc92b1e28f9f) ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkIJWC9o0srssIvXe1t%2F-MkIRhY8JSNA9DGzveiR%2Fmesse14.png?alt=media\&token=0ac4d610-4f16-428e-88ce-7b41bd4b336e) {% hint style="info" %} Para obter a URL e Token do webhook da Integração com o Facebook, basta solicitar ao e-mail {% endhint %} 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: ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkIJWC9o0srssIvXe1t%2F-MkIRn7ILuJwrRge4c95%2Fmesse15.png?alt=media\&token=52dab1d0-9b0d-4a4d-82b2-602325b8e291) 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**
![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkIJWC9o0srssIvXe1t%2F-MkIS42-8un0Z0HEpfU0%2Fmesse16.png?alt=media\&token=70e1f3f7-5305-460d-b673-28b391dcd052) ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkIJWC9o0srssIvXe1t%2F-MkIS9mqtlFbzGo4YI09%2Fmesse17.png?alt=media\&token=94f9b817-10b6-4a84-9614-19eeb489dec5) ## 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: ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkIJWC9o0srssIvXe1t%2F-MkITi8wgZYcRG7mNo7f%2Fconne1.png?alt=media\&token=b99313e9-99fd-406c-9edb-c2c1f28c8c73) * **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** ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkIJWC9o0srssIvXe1t%2F-MkITnNR-0s_p7d_2tzy%2Fconne2.png?alt=media\&token=fab63c7a-48d5-4a6e-ada7-e3aaf181fb02) No menu lateral esquerdo, clique em **Configurações > Configurações avançadas de mensagens** ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkIJWC9o0srssIvXe1t%2F-MkITqmbOeSwj271_6wU%2Fconne3.png?alt=media\&token=e3f51f53-c73b-4bfa-ab75-c6cf4e42eb64) 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! ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkIJWC9o0srssIvXe1t%2F-MkITx2RAuv_6fPUVZua%2Fconne4.png?alt=media\&token=39c6a0e4-35d9-417f-b24a-070e78dee540) Pronto, mande uma mensagem para o messenger da página comercial e teste! {% hint style="info" %} **Lembre-se que o assistente precisa estar publicado hein... 😀** {% endhint %} ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkIJWC9o0srssIvXe1t%2F-MkIU1w9TbVSCcFVJrUt%2Fconne5.png?alt=media\&token=fe76f69b-805a-4b3a-adad-ca7e4d463dd1) ## **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**. {% hint style="info" %} Esse processo deve ser feito pelo Administrador {% endhint %} {% embed url="" %} ### **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 ](https://developers.facebook.com/docs/messenger-platform/policy/policy-overview) Referencia: ### **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**” ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkIUKtEdRZgNQ7en70z%2F-MkJHroZvdSuw3T9Rwlo%2Fsub1.gif?alt=media\&token=fd9aa899-e7f3-4bf0-abf1-72ff5ca94f14) 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). ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkIUKtEdRZgNQ7en70z%2F-MkJI-eXFGg5ovi8OmQe%2Fsub2.png?alt=media\&token=7c7e1f9e-7ca0-4ad5-9baf-0e4694bbf1de) ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkIUKtEdRZgNQ7en70z%2F-MkJI2vCA6KSeUq_W1RE%2Fsub3.gif?alt=media\&token=e49f7b93-bbd7-4228-a834-56faa8f852f6) * 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 ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkIUKtEdRZgNQ7en70z%2F-MkJI8G8r3-v68O8bXa9%2Fsub4.png?alt=media\&token=6823b9b9-27de-4d6c-b500-a366a185ee5d) * 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 (). 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: **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” * 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!** ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkIUKtEdRZgNQ7en70z%2F-MkJIB7Ln5g391Cw82KC%2Fsub5.png?alt=media\&token=9a841f4e-8a55-4143-a43d-40ea49253c88) ### ### **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”.** ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkIUKtEdRZgNQ7en70z%2F-MkJIyqZsHU6H2-oY6EI%2Fsub6.gif?alt=media\&token=d2fb535a-d42b-44d0-8c55-de926e0c019a) {% hint style="info" %} Agora, aguarde o retorno da avaliação do Facebook! {% endhint %} Você receberá a notificação do Facebook for Developers em até 5 dias, no e-mail de contato cadastrado em **Configurações > Básico.** Para verificar se foi aprovado mesmo, vá no aplicativo padrão, clique em Análise do Aplicativo > Solicitações, e depois em “**Detalhes**”. ![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-MkIUKtEdRZgNQ7en70z%2F-MkJJ0J5utVqGU_knNjK%2Fsub7.gif?alt=media\&token=bcb2e004-a377-45d0-917b-238e6326353a)