Integração Messenger via Zenvia NLU
Last updated
.svg?alt=media&token=d4e6f36f-8994-47d0-b855-83e47927012c)
Last updated
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
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
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... 😀
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
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
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.
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
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:
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.”
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!
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”.
Agora, aguarde o retorno da avaliação do Facebook!
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”.
