> ## Documentation Index > Fetch the complete documentation index at: https://docs.airys.chat/llms.txt > Use this file to discover all available pages before exploring further. # Configurando o Facebook > Configure a integração do Facebook Messenger para o AirysChat Para usar o Canal do Facebook, você deve criar um aplicativo do Facebook no portal do desenvolvedor. Você pode encontrar mais detalhes sobre como criar aplicativos do Facebook [aqui](https://developers.facebook.com/docs/apps/#register). ## Pré-requisitos 1. Uma conta válida no Facebook. 2. Uma página válida no Facebook. ## Registrar um Aplicativo no Facebook 1. Acesse o [portal de desenvolvedores do Facebook](https://developers.facebook.com/apps/) e clique no botão "Create App" (Criar Aplicativo). facebook_create_app 2. Selecione a opção "Other" (Outro). facebook_other_app 3. Para o tipo de aplicativo, escolha "Business" (Empresa). facebook_business 3. Insira detalhes básicos como o nome do aplicativo e e-mail. facebook_business_details Após registrar seu Aplicativo do Facebook, você precisará obter o `App Id` (ID do Aplicativo) e o `App Secret` (Chave Secreta do Aplicativo). Esses valores estarão disponíveis nas configurações do aplicativo e serão necessários ao configurar as variáveis de ambiente do AirysChat. facebook_app_id ## Configurando as Variáveis de Ambiente no AirysChat Configure as seguintes variáveis de ambiente do AirysChat com os valores que você obteve durante a configuração do aplicativo do Facebook. O `FB_VERIFY_TOKEN` deve ser uma string única e segura que você fornece ao configurar o aplicativo do Facebook. Gere uma string aleatória e defina-a como o `FB_VERIFY_TOKEN`. O Facebook incluirá essa string em todas as requisições de verificação. Reinicie o servidor do AirysChat após atualizar as variáveis de ambiente. ```bash theme={null} FB_VERIFY_TOKEN= FB_APP_SECRET= FB_APP_ID= ``` ## Configurar o Login do Facebook 1. Adicione o produto Facebook Login através do painel do aplicativo do Facebook. facebook_app_login 2. Habilite `Web OAuth Login`, `Login with Javascript SDK` e adicione seu domínio self-hosted na entrada `Allowed Domains for the JavaScript SDK`. facebook_sdk_login ## Configurar o Aplicativo do Facebook 1. Nas configurações do aplicativo, adicione o `domínio de instalação do AirysChat` como o domínio do seu aplicativo. facebook_app_domain 2. Na seção de produtos na página de configurações do seu aplicativo, adicione "Messenger". facebook_messenger_product 3. Vá para as configurações do Messenger e configure a URL de callback (URL de retorno). Alt text 4. Forneça a URL de Callback como `{your_airyschat_installation_url}/bot` e o Token de verificação como `FB_VERIFY_TOKEN` da sua variável de ambiente. facebook_callback_url 5. Acesse o AirysChat e crie uma caixa de entrada do Messenger. Escolha uma página para a qual a sua conta de desenvolvedor do Facebook tenha acesso de administrador. Por favor, consulte este [guia](https://www.airyschat.com/hc/user-guide/articles/1677778588-how-to-setup-a-facebook-channel) para mais detalhes sobre como criar uma caixa de entrada do Messenger no AirysChat. ## Testando o canal do Facebook Até que o aplicativo seja aprovado para produção, o Facebook não enviará as novas mensagens da sua página para o AirysChat. Para testar as alterações até que o aplicativo seja aprovado para produção, siga os passos abaixo: 1. Acesse a seção do messenger na página de configurações do seu aplicativo, no portal de desenvolvedores do Facebook. facebook_messenger_settings 2. Clique em `Add or remove pages` (Adicionar ou remover páginas) e conecte a página que você escolheu ao criar a caixa de entrada do Messenger no AirysChat. facebook_callback_pages 3. Após conectar as páginas, clique em `Add subscriptions` (Adicionar assinaturas) a partir da página conectada. facebook_page_config 4. Inscreva-se nos seguintes campos e salve a assinatura. ``` messages messaging_postbacks message_deliveries message_reads message_echoes ``` facebook_page_subscription 4. Envie uma mensagem para a página conectada a partir da sua conta do Facebook e ela deve aparecer no AirysChat agora. ## Entrando em produção Antes que você possa começar a usar o seu aplicativo do Facebook em produção, você precisará que ele seja verificado pelo Facebook. Consulte a [documentação](https://developers.facebook.com/docs/apps/review/) sobre como ter seu aplicativo verificado. Obtenha acesso avançado às permissões necessárias mencionadas abaixo para o seu aplicativo do Facebook: ``` pages_messaging (Para enviar mensagens em nome da página) pages_show_list (Para listar as páginas a serem conectadas no airyschat) pages_manage_metadata (Assinar webhooks em nome da página) business_management pages_read_engagement (Ler dados de seguidores (incluindo nome, PSID) e perfil) Business Asset User Profile Access (Para acessar a foto do perfil e o nome das pessoas que contatam a página) ``` Certifique-se de que a versão da assinatura do seu aplicativo do Facebook seja 17.0. Nós atualizamos a assinatura do FB para a versão mais recente, então altere a versão de assinatura de permissão nas opções de webhooks do aplicativo do facebook. ## Desenvolvendo ou Testando a Integração do Facebook na sua máquina Instale o [ngrok](https://ngrok.com/docs) na sua máquina. Isso será necessário já que a API do Facebook Messenger se comunicará apenas via https. ```bash theme={null} brew cask install ngrok ``` Configure o ngrok para rotear para a porta do seu servidor Rails. ```bash theme={null} ngrok http 3000 ``` Vá para a página de desenvolvedores do Facebook e navegue até as configurações do seu aplicativo. Nas configurações do aplicativo, adicione `localhost` como domínio do seu aplicativo. Na página de configurações do Messenger, configure a url de callback com o seguinte valor. ```bash theme={null} {your_ngrok_url}/bot ``` Atualize o token de verificação nas suas variáveis de ambiente do AirysChat. Você também terá que adicionar uma página do Facebook à sua seção `Access Tokens` na sua página de configurações do Messenger. Reinicie o servidor local do AirysChat. Sua configuração do AirysChat estará pronta para receber mensagens do Facebook. ## Versão da API do Facebook Nós suportamos a API do Facebook versão v13.0 em diante, a qual você pode atualizar nas configurações avançadas do aplicativo do facebook. fb_api_version ## Testar sua Configuração local 1. Após terminar a configuração acima, [crie uma caixa de entrada do Facebook](https://www.airyschat.com/hc/user-guide/articles/1677778588-how-to-setup-a-facebook-channel) após fazer login na sua Instalação do AirysChat. 2. Envie uma mensagem para sua página do Facebook. 3. Aguarde e confirme as requisições de entrada para o endpoint `/bot` na sua tela do ngrok.