Configurando o Facebook

Configurar a integração do Facebook Messenger para o Chatwoot

Para usar o Canal do Facebook, você precisa criar um aplicativo do Facebook no portal do desenvolvedor. Você pode encontrar mais detalhes sobre como criar aplicativos do Facebook aqui .

​

Pré-requisitos

1. Uma conta válida do Facebook.

2. Uma página válida do Facebook.

​

Registre um aplicativo do Facebook

1. Acesse o portal do desenvolvedor do Facebook e clique no botão “Criar aplicativo”

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

3. Para o tipo de aplicativo, escolha “Negócios”.

3. Insira detalhes básicos, como o nome do aplicativo e o e-mail.

Após registrar seu aplicativo do Facebook, você precisará obter os App Idvalores e App Secret. Esses valores estarão disponíveis nas configurações do aplicativo e serão necessários ao configurar as variáveis ​​de ambiente do Chatwoot.

​

Configurando as variáveis ​​de ambiente no ChatwootConfigure as seguintes variáveis ​​de ambiente do Chatwoot com os valores obtidos durante a configuração do aplicativo do Facebook. A FB_VERIFY_TOKENstring deve ser exclusiva e segura, fornecida ao configurar o aplicativo do Facebook. Gere uma string aleatória e defina-a como FB_VERIFY_TOKEN. O Facebook incluirá essa string em todas as solicitações de verificação.Reinicie o servidor Chatwoot após atualizar as variáveis ​​de ambiente

Cópia

FB_VERIFY_TOKEN=
FB_APP_SECRET=
FB_APP_ID=

​

Configurar login do Facebook

1. Adicione o produto Login do Facebook por meio do painel do aplicativo do Facebook.

2. Habilite Web OAuth Logine Login with Javascript SDKadicione seu domínio auto-hospedado à Allowed Domains for the JavaScript SDKentrada.

​

Configurar o aplicativo do Facebook

1. Nas configurações do aplicativo, adicione seu Chatwoot installation domaincomo domínio do aplicativo.

2. Na seção de produtos na página de configurações do seu aplicativo, adicione “Messenger”

3. Acesse as configurações do Messenger e configure o URL de retorno de chamada

4. Forneça o URL de retorno de chamada {your_chatwoot_installation_url}/bote o token de verificação FB_VERIFY_TOKENda sua variável de ambiente.

5. Acesse o Chatwoot e crie uma caixa de entrada no Messenger. Escolha uma página à qual sua conta de desenvolvedor do Facebook tenha acesso de administrador. Consulte este guia para obter mais detalhes sobre como criar uma caixa de entrada no Messenger no Chatwoot.

​

Testando o canal do FacebookAté que o aplicativo seja aprovado para produção, o Facebook não enviará as novas mensagens da sua página para o Chatwoot.Para testar as alterações até que o aplicativo seja aprovado para produção, siga os passos abaixo:

1. Vá até a seção de mensagens na página de configurações do seu aplicativo, em desenvolvedores do Facebook.

2. Clique Add or remove pagese conecte a página que você escolher ao criar a caixa de entrada do Chatwoot Messenger.

3. Após conectar as páginas, clique em Add subscriptionsna página conectada.

4. Assine os seguintes campos e salve a assinatura.

Cópia

messages
messaging_postbacks
message_deliveries
message_reads
message_echoes

4. Envie uma mensagem para a página conectada da sua conta do Facebook e ela deverá aparecer no Chatwoot agora.

​

**Entrando em produção.**Antes de começar a usar seu aplicativo do Facebook em produção, você precisará verificá-lo pelo Facebook. Consulte a documentação sobre como verificar seu aplicativo.Obtenha acesso avançado às permissões necessárias mencionadas abaixo para seu aplicativo do Facebook

Cópia

pages_messaging (To message on behalf of the page)
pages_show_list (To list the pages to be connected in chatwoot)
pages_manage_metadata (Subscribe webhooks on behalf of the page)
business_management
pages_read_engagement (Read followers data (including name, PSID), and profile )
Business Asset User Profile Access  (For accessing user profile picture and name of people who contacts the page)

Certifique-se de que a versão da sua assinatura do aplicativo do Facebook seja 17.0. Atualizamos a assinatura do FB com a versão mais recente, então altere a versão da assinatura de permissão na opção webhooks do aplicativo do Facebook.

​

Desenvolvendo ou testando a integração do Facebook em sua máquinaInstale o ngrok na sua máquina. Isso será necessário, pois as APIs do Facebook Messenger só se comunicam via https.

Cópia

brew cask install ngrok

Configure o ngrok para rotear para a porta do seu servidor Rails.

Cópia

ngrok http 3000

Acesse a página de desenvolvedores do Facebook e navegue até as configurações do seu aplicativo. Nas configurações do aplicativo, adicione-o localhostcomo domínio do aplicativo. Na página de configurações do Messenger, configure a URL de retorno com o seguinte valor.

Cópia

{your_ngrok_url}/bot

Atualize o token de verificação nas variáveis ​​de ambiente do Chatwoot.Você também precisará adicionar uma página do Facebook à sua Access Tokensseção nas configurações do Messenger. Reinicie o servidor local do Chatwoot. Sua configuração do Chatwoot estará pronta para receber mensagens do Facebook.

​

Versão da API do FacebookDaremos suporte à versão v13.0 da API do Facebook daqui para frente, que você pode atualizar nas configurações avançadas do aplicativo do Facebook.

​

Teste sua configuração local

1. Após concluir a configuração acima, crie uma caixa de entrada do Facebook após efetuar login na sua instalação do Chatwoot.

2. Envie uma mensagem para sua página do Facebook.

3. Aguarde e confirme as solicitações recebidas para /boto endpoint na tela do ngrok.