Visão Geral

Para usar o Facebook Channel na Solcon (instalação própria / on-premise), você precisa criar um Facebook App no portal de desenvolvedores.

Pré-requisitos

• Uma conta válida no Facebook

• Uma página válida do Facebook

• Acesso ao portal de desenvolvedores: https://developers.facebook.com/

Registrar um Aplicativo no Facebook

1. Acesse o portal do desenvolvedor e clique em “Criar aplicativo”.

2. Selecione a opção “Outro”.

3. EscoEscolha o tipo de aplicativo: “Negócios”.

4. Preencha os dados básicos (nome do app, e-mail etc.)

5. Após criar o app, pegue:

   • App ID

   • App Secret

   Eles estão em Configurações → Básico.
   Imagem: id_do_aplicativo_do_facebook

Configurar Variáveis de Ambiente na Solcon

Configure estas variáveis usando o App ID e App Secret obtidos:

FB_VERIFY_TOKEN=
FB_APP_SECRET=
FB_APP_ID=

⚠️ FB_VERIFY_TOKEN deve ser uma string segura gerada por você.
O Facebook enviará essa mesma string nas requisições de verificação do webhook.

Depois de atualizar, reinicie o servidor Solcon.

Configurar Login do Facebook

No painel do app:

1. Adicione o produto "Login do Facebook".

2. Habilite:

   • Web OAuth Login

   • Login with JavaScript SDK

   Adicione o domínio da sua instalação da Solcon em:
   Allowed Domains for the JavaScript SDK
   Imagem: login_sdk_facebook

Configurar o Aplicativo para a Solcon

1. Nas configurações do app, adicione o domínio da sua instalação da Solcon.

2. Adicione o produto Messenger

3. Configure o webhook (callback URL):

   {your_solcon_installation_url}/bot
   

   E use o FB_VERIFY_TOKEN configurado.
   Imagem: URL_de_retorno_de_chamada_do_facebook

4. Na Solcon, crie uma caixa de entrada Messenger, escolhendo a página que seu usuário administrador controla.

Testando o Canal (Antes da aprovação em Produção)

Facebook não envia mensagens da página até o app ser aprovado, mas você pode testar assim:

1. No painel do app:

   Messenger → Settings → Add or remove pages
   Conecte a página usada na Solcon.

2. Clique em Add Subscriptions na página conectada.

3. Assine os eventos:

   • messages

   • messaging_postbacks

   • message_deliveries

   • message_reads

   • message_echoes

4. Envie uma mensagem para a página → ela deve aparecer na Solcon.

Entrando em Produção

Antes de usar em produção:

1. Verifique seu aplicativo no Facebook

   Siga o processo de validação do app.

2. Solicite acesso avançado às permissões:

• pages_messaging

• pages_show_list

• pages_manage_metadata

• business_management

• pages_read_engagement

• Atualize a versão da assinatura Webhooks para 17.0.

Desenvolvendo ou Testando o Facebook Localmente

APIs do Messenger só funcionam via HTTPS.
Para testar localmente, use:

1. Instalar Ngrok

   brew cask install ngrok
   
   

2. Rodar o túnel

   ngrok http 3000
   
   

3. Configurações do App

   • Adicione localhost como domínio do app

   • Configure o webhook com:

   {your_ngrok_url}/bot
   
   

   • Atualize seu FB_VERIFY_TOKEN

   • Adicione uma página do Facebook em Messenger → Access Tokens

   • Reinicie a Solcon

   Agora a Solcon poderá receber mensagens do Messenger.

Versão Suportada da API do Facebook

A Solcon dá suporte à API versão 13.0 para frente.
Você pode ajustar isso em:

Configurações → Avançado → Versão da API

Teste Final da Configuração

1. Crie uma caixa de entrada do Facebook na Solcon

2. Envie uma mensagem para sua página

3. Verifique no console do Ngrok se há requisições chegando no endpoint:

/bot

Se as requisições aparecerem, a integração está funcionando.