Como conectar sua própria aplicação através do Portal – Blip | Blip Help

índice:

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.net
Token: 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.net
Token: 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.net
Token: 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.net
Token: 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. 😃