Pular para o conteúdo principal
Por favor, certifique-se de ter instalado a versão v4.1 ou superior. Se não, por favor consulte este guia para o método de Login do Facebook.

Pré-requisitos

  1. Uma conta válida no Facebook.
  2. Uma conta profissional válida no Instagram.

Registrar um Aplicativo no Facebook

Para usar o Canal do Instagram, você deve criar um aplicativo do Facebook no portal de desenvolvedores. Você pode encontrar mais detalhes sobre como criar aplicativos do Facebook aqui.
  1. Clique no botão “Create App” (Criar Aplicativo).
facebook_create_app
  1. Selecione a opção “Other” (Outro).
facebook_other_app
  1. Para o tipo de aplicativo, escolha “Business” (Empresa).
facebook_business
  1. Adicione o nome do aplicativo e conecte a conta comercial.
facebook_business_details
  1. Adicione o produto Instagram a partir da página inicial.
instagram_product

Configurar as definições do Instagram para o AirysChat

  1. Copie o Instagram app ID (ID do aplicativo Instagram) e o Instagram app secret (Chave secreta do aplicativo Instagram).
instagram_app_id
  1. Adicione o Instagram app ID e o Instagram app secret na configuração do seu aplicativo via {AirysChat installation url}/super_admin/app_config?config=instagram.
instagram_app_config
  1. Configurar Webhooks
Defina a URL de callback (URL de retorno) para {your_airyschat_url}/webhooks/instagram. O token de verificação deve corresponder ao seu INSTAGRAM_VERIFY_TOKEN, que pode ser configurado por meio do app_config. instagram_webhooks Inscreva-se nos eventos messages, messaging_seen e message_reactions. instagram_webhooks_subscribe
Para receber webhooks, o modo do aplicativo deve ser definido como “Live”.
  1. Configurar o login comercial do Instagram (Instagram business login)
Defina a URL de redirecionamento (Redirect URL) como {your_airyschat_url}/instagram/callback. instagram_business_login
  1. Crie uma nova conta de testador do Instagram.

Criar uma Caixa de Entrada do Instagram

Acesse o AirysChat e crie uma caixa de entrada do Instagram. Por favor, consulte este guia para mais detalhes sobre como criar uma caixa de entrada do Instagram no AirysChat.

Como testar o Instagram antes de ir ao ar

  1. Adicione Testadores do Instagram clicando no botão “Add People” (Adicionar Pessoas).
facebook_instagram_test
  1. Certifique-se de ter selecionado a função Instagram Tester ao criar um novo testador.
instagram_tester_list

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 sobre como ter seu aplicativo verificado.

Solução de problemas & Erros comuns

Erro de Papel de Desenvolvedor Insuficiente (Insufficient Developer Role Error)

Certifique-se de que o usuário do Instagram seja adicionado como desenvolvedor: Meta Dashboard → App Roles → Roles → Add People → Enter Instagram ID

Acesso à API Desativado (API Access Deactivated)

Certifique-se de que a URL da Política de Privacidade (Privacy Policy URL) seja válida e esteja definida corretamente.

Requisição inválida: Parâmetros de requisição são inválidos: redirect_uri inválido (Invalid request: Request parameters are invalid: Invalid redirect_uri)

Por favor, configure a URL do Frontend. A URL do Frontend não corresponde à URL de autorização.

Erro de criação do Canal do Instagram: Falha ao trocar token (Instagram Channel creation Error: Failed to exchange token)

Por favor, certifique-se de que a conta de teste foi adicionada às configurações do aplicativo do facebook.

400: Sessão Inválida ao conectar o canal do instagram (400: Session Invalid when connecting the instagram channel)

Isso pode ser um problema do lado do facebook. Por favor, tente novamente depois de algum tempo.