Como conectar sua própria aplicação através do Portal 29 de agosto de 2024 15:40 Atualizado índice: Configurando sua própria aplicação do Facebook para conectar via Portal Configurações do Produto: Login do Facebook Configurações do Produto: Webhooks Apenas se for utilizar Organização) Alteração de URL do Webhook Configurações do Produto: Messsenger Apenas se for utilizar Organização) Alteração de URL do Messenger Permissões necessárias pela aplicação do Facebook para conectar via Portal Publicando através de sua própria aplicação do Facebook via Portal Para publicar seu bot no Facebook usando sua própria aplicação através do Portal do Blip você precisará de uma Aplicação previamente criada e analisada pelo Facebook.Se sua aplicação própria ainda na estiver configurada corretamente seguir os passos da Seção 1 e da Seção 2 para configurar. Caso contrário é só seguir os passos da Seção 3: 1. Configurando sua própria aplicação do Facebook para conectar via Portal Importante: Para que sua aplicação funcione corretamente é preciso adicionar os produtos: Login do Facebook, Messenger e Webhooks em sua aplicação. 1.1) Configurações do Produto: Login do Facebook Após adicionar o produto Login do Facebook, clique no menu Login do Facebook → Configurações e configure as informações de OAuth do cliente conforme imagem abaixo: URIs de Redirecionamento do OAuth válidos: https://portal.blip.ai/facebookCallback 1.2) Configurações do Produto: Webhooks Após adicionar o produto Webhooks, é necessário configurar quais eventos do Messenger serão enviados pelo Facebook. Para isto, no menu Webhooks, selecione a opção Page e clique em Subscribe to this Object. Preencha com os valores abaixo: Url: https://messenger.gw.msging.netToken: ze3jRmmaLU5KUTtUN (Apenas se for utilizar Organização) Alteração de URL do Webhook Após realizar a migração para Organização será necessário alterar a Url do Webhook sua aplicação do Facebook.Usar os valores abaixo: Url: https://{IdOrganização}-messenger.gw.msging.netToken: ze3jRmmaLU5KUTtUN Nota: Lembre-se de substituir {IdOrganização} pelo valor correspondente. 1.3) Configurações do Produto: Messsenger Após adicionar o produto Messenger, e de posse das duas informações abaixo, clique no menu Messenger → Configurações → Webhook e configure as informações Url de retorno de chamada e Verificar Token conforme imagem abaixo: Url: https://messenger.gw.msging.netToken: ze3jRmmaLU5KUTtUN (Apenas se for utilizar Organização) Alteração de URL do Messenger Após realizar a migração para Organização será necessário alterar a Url de retorno de chamada em sua aplicação do Facebook. Acesse sua aplicação, clique no menu Messenger, entre em Configurações e altere as informações Url de retorno de chamada e Verificar Token, com os dados abaixo: Url: https://{IdOrganização}-messenger.gw.msging.netToken: ze3jRmmaLU5KUTtUN Nota: Lembre-se de substituir {IdOrganização} pelo valor correspondente. Acessar Messenger → Configurações → Webhook → Controles de versão de campo do webhook .Verificar se a versão dos webhooks selecionadas estão marcadas como v8.0. Faça as alterações se necessário, caso contrário sua aplicação pode apresentar instabilidades: 2. Permissões necessárias pela aplicação do Facebook para conectar via Portal Após a criação da aplicação do Facebook, você vai precisar solicitar algumas permissões específicas para que sua aplicação funcione corretamente junto ao Blip. Para isto você deve ir em Análise do Aplicativo → Permissões e recursos e solicitar cada permissão separadamente: Segue a lista de permissões e o motivo do seu uso: pages_messaging: Enviar e responder as messagens no Facebook Messenger automaticamente. pages_user_gender: Os bots associados a aplicação podem enviar mensagens em vários idiomas. Essa permissão será usada para aplicar o pronome correto. pages_user_locale: Os bots associados a aplicação podem enviar mensagens para pessoas em muitos países. Essa permissão pode ser usada para direcionar pessoas para bots que usam seus idiomas. pages_user_timezone: Os bots associados a aplicação podem enviar notificações para o usuário usando Tags de mensagem. Essa permissão pode ser usada para evitar o envio de notificações em horários inconvenientes, como no meio da noite. pages_manage_metadata: A aplicação usará a permissão pages_manage_metadata para permitir que o Administrador da página assine os webhooks para receber as mensagens enviadas para a página do administrador. Com essas mensagens, podemos criar chatbots. A aplicação ajudará o administrador da página a gerenciar as mensagens recebidas por um chat automático. 3. Publicando através de sua própria aplicação do Facebook via Portal 3.1) Vá para aba Configurações, e clique no botão Usar minha própria aplicação. Serão disponibilizados os campos para você adicionar o App ID e App Secret da sua aplicação no Facebook. 3.2) Vá até a página do seu aplicativo no dashbord do Facebook. Clique em Configurações → Básico. Após isso aparecerá a tela de configurações da sua aplicação, onde está localizado o AppID (Id do Aplicativo) e App Secret (Chave Secreta do Aplicativo). 3.3) Adicione essas informações na configuração do Messenger no Blip e clique em Salvar Configurações. 3.4) Após isso você será redirecionado para a tela onde será concluída a conexão com o Facebook. 3.5) Após concluída a conexão com o Facebook serão listadas as páginas para você publicar o seu bot. 3.6) Envie uma mensagem para sua página no Facebook e teste se a mensagem chegou para o seu bot no Blip. Nota: O bot pode começar a responder em até 3 minutos. Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal. 😃 Artigos relacionados Como publicar seu Chatbot no Messenger Como construir bots através de SDKs ou API HTTP Como conectar sua própria aplicação pelas Configurações Avançadas Como salvar o histórico de atendimento humano via Integração do Blip com Google Drive Como conectar a um canal de atendimento personalizado
índice: Configurando sua própria aplicação do Facebook para conectar via Portal Configurações do Produto: Login do Facebook Configurações do Produto: Webhooks Apenas se for utilizar Organização) Alteração de URL do Webhook Configurações do Produto: Messsenger Apenas se for utilizar Organização) Alteração de URL do Messenger Permissões necessárias pela aplicação do Facebook para conectar via Portal Publicando através de sua própria aplicação do Facebook via Portal Para publicar seu bot no Facebook usando sua própria aplicação através do Portal do Blip você precisará de uma Aplicação previamente criada e analisada pelo Facebook.Se sua aplicação própria ainda na estiver configurada corretamente seguir os passos da Seção 1 e da Seção 2 para configurar. Caso contrário é só seguir os passos da Seção 3: 1. Configurando sua própria aplicação do Facebook para conectar via Portal Importante: Para que sua aplicação funcione corretamente é preciso adicionar os produtos: Login do Facebook, Messenger e Webhooks em sua aplicação. 1.1) Configurações do Produto: Login do Facebook Após adicionar o produto Login do Facebook, clique no menu Login do Facebook → Configurações e configure as informações de OAuth do cliente conforme imagem abaixo: URIs de Redirecionamento do OAuth válidos: https://portal.blip.ai/facebookCallback 1.2) Configurações do Produto: Webhooks Após adicionar o produto Webhooks, é necessário configurar quais eventos do Messenger serão enviados pelo Facebook. Para isto, no menu Webhooks, selecione a opção Page e clique em Subscribe to this Object. Preencha com os valores abaixo: Url: https://messenger.gw.msging.netToken: ze3jRmmaLU5KUTtUN (Apenas se for utilizar Organização) Alteração de URL do Webhook Após realizar a migração para Organização será necessário alterar a Url do Webhook sua aplicação do Facebook.Usar os valores abaixo: Url: https://{IdOrganização}-messenger.gw.msging.netToken: ze3jRmmaLU5KUTtUN Nota: Lembre-se de substituir {IdOrganização} pelo valor correspondente. 1.3) Configurações do Produto: Messsenger Após adicionar o produto Messenger, e de posse das duas informações abaixo, clique no menu Messenger → Configurações → Webhook e configure as informações Url de retorno de chamada e Verificar Token conforme imagem abaixo: Url: https://messenger.gw.msging.netToken: ze3jRmmaLU5KUTtUN (Apenas se for utilizar Organização) Alteração de URL do Messenger Após realizar a migração para Organização será necessário alterar a Url de retorno de chamada em sua aplicação do Facebook. Acesse sua aplicação, clique no menu Messenger, entre em Configurações e altere as informações Url de retorno de chamada e Verificar Token, com os dados abaixo: Url: https://{IdOrganização}-messenger.gw.msging.netToken: ze3jRmmaLU5KUTtUN Nota: Lembre-se de substituir {IdOrganização} pelo valor correspondente. Acessar Messenger → Configurações → Webhook → Controles de versão de campo do webhook .Verificar se a versão dos webhooks selecionadas estão marcadas como v8.0. Faça as alterações se necessário, caso contrário sua aplicação pode apresentar instabilidades: 2. Permissões necessárias pela aplicação do Facebook para conectar via Portal Após a criação da aplicação do Facebook, você vai precisar solicitar algumas permissões específicas para que sua aplicação funcione corretamente junto ao Blip. Para isto você deve ir em Análise do Aplicativo → Permissões e recursos e solicitar cada permissão separadamente: Segue a lista de permissões e o motivo do seu uso: pages_messaging: Enviar e responder as messagens no Facebook Messenger automaticamente. pages_user_gender: Os bots associados a aplicação podem enviar mensagens em vários idiomas. Essa permissão será usada para aplicar o pronome correto. pages_user_locale: Os bots associados a aplicação podem enviar mensagens para pessoas em muitos países. Essa permissão pode ser usada para direcionar pessoas para bots que usam seus idiomas. pages_user_timezone: Os bots associados a aplicação podem enviar notificações para o usuário usando Tags de mensagem. Essa permissão pode ser usada para evitar o envio de notificações em horários inconvenientes, como no meio da noite. pages_manage_metadata: A aplicação usará a permissão pages_manage_metadata para permitir que o Administrador da página assine os webhooks para receber as mensagens enviadas para a página do administrador. Com essas mensagens, podemos criar chatbots. A aplicação ajudará o administrador da página a gerenciar as mensagens recebidas por um chat automático. 3. Publicando através de sua própria aplicação do Facebook via Portal 3.1) Vá para aba Configurações, e clique no botão Usar minha própria aplicação. Serão disponibilizados os campos para você adicionar o App ID e App Secret da sua aplicação no Facebook. 3.2) Vá até a página do seu aplicativo no dashbord do Facebook. Clique em Configurações → Básico. Após isso aparecerá a tela de configurações da sua aplicação, onde está localizado o AppID (Id do Aplicativo) e App Secret (Chave Secreta do Aplicativo). 3.3) Adicione essas informações na configuração do Messenger no Blip e clique em Salvar Configurações. 3.4) Após isso você será redirecionado para a tela onde será concluída a conexão com o Facebook. 3.5) Após concluída a conexão com o Facebook serão listadas as páginas para você publicar o seu bot. 3.6) Envie uma mensagem para sua página no Facebook e teste se a mensagem chegou para o seu bot no Blip. Nota: O bot pode começar a responder em até 3 minutos. Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal. 😃