> For the complete documentation index, see [llms.txt](https://docs.altu.d1.cx/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.altu.d1.cx/connect/canais/facebook/integracao-messenger-via-altu.md). # 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**. ![](/files/-MkNCDVAWUiXPcrdaS88) 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 ![](/files/-MkNCogCrenAWSAvTiFK) ## **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ê. ![](/files/-MkIOpIidaddbvdGd_LC) Após logar, selecione a opção **Meus Aplicativos** no menu superior e vá em **Criar aplicativo.** ![](/files/-MkIOv8LIKjwgZvLv4lE) 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 ![](/files/-MkIP-cREiWyZsHVuJmV) Com o aplicativo criado, aparecerá a tela de **Adicionar produtos ao seu aplicativo**, e nesta tela adicione o **Messenger**. ![](/files/-MaYk5ky3agofyfEM3RO) 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**. ![](/files/-MkIQSn0md9VzkZMTHzf) Selecione a página desejada, conforme na imagem abaixo: ![](/files/-MkIQXnDE7bDKOu_7RC_) 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.** ![](/files/-MkIQagA6o9Jcodo3bGO) 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 %} ![](/files/-MkIQf2-TxovSEfwZZK7) 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). ![](/files/-MkIQifvg7DdBXJkq-4d) ![](/files/-MkIQklxdLPJAbkVKWiU) [**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.** ![](/files/-MkIRCeNtgBIR7VS79G5) ![](/files/-MkIRMOGlsODBizrhXf6) 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 %} ![](/files/-MkIRWBJGHIYbPOfdKp3) ![](/files/-MkIRhY8JSNA9DGzveiR) {% 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: ![](/files/-MkIRn7ILuJwrRge4c95) 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**
![](/files/-MkIS42-8un0Z0HEpfU0) ![](/files/-MkIS9mqtlFbzGo4YI09) ## 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: ![](/files/-MkITi8wgZYcRG7mNo7f) * **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** ![](/files/-MkITnNR-0s_p7d_2tzy) No menu lateral esquerdo, clique em **Configurações > Configurações avançadas de mensagens** ![](/files/-MkITqmbOeSwj271_6wU) 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! ![](/files/-MkITx2RAuv_6fPUVZua) 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 %} ![](/files/-MkIU1w9TbVSCcFVJrUt) ## **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**” ![](/files/-MkJHroZvdSuw3T9Rwlo) 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). ![](/files/-MkJI-eXFGg5ovi8OmQe) ![](/files/-MkJI2vCA6KSeUq_W1RE) * 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 ![](/files/-MkJI8G8r3-v68O8bXa9) * 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!** ![](/files/-MkJIB7Ln5g391Cw82KC) ### ### **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”.** ![](/files/-MkJIyqZsHU6H2-oY6EI) {% 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**”. ![](/files/-MkJJ0J5utVqGU_knNjK) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.altu.d1.cx/connect/canais/facebook/integracao-messenger-via-altu.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.