Facebook Messenger

Este guia mostra como conectar seu Quickchat AI Agent ao Facebook Messenger. Depois que uma Página do Facebook é vinculada, seu Assistente de IA responde às pessoas que enviam mensagens para essa Página no Messenger, e cada conversa aparece na sua Caixa de entrada do Quickchat AI.

Se travar, vá para Solução de problemas e FAQs ou fale conosco.

Verificações opcionais com exemplos

• Comparar respostas por orçamento de créditos. Calcule o máximo de respostas de AI completas para cada modelo compatível com base em um orçamento de créditos informado. Isso não verifica seu saldo nem a elegibilidade dos modelos.

• Verificar requisitos do plano. Compare necessidades declaradas de uso, conteúdo, equipe e recursos com os planos públicos do Quickchat AI. Não é uma cotação nem uma consulta à conta.

Os formulários estão em inglês.

Passo 0 - Pré-requisitos

• Uma Página do Facebook para a sua empresa. As integrações do Messenger se conectam a uma Página, não a um perfil pessoal. Ainda não tem uma Página? Use o link Criar uma página do Facebook abaixo de Conectar com o Facebook no painel do Messenger.
• Uma função na Página que inclua as mensagens para a conta do Facebook com a qual você se conectar. No facebook.com, isso fica em Settings > Page access. Controle total funciona, e uma função no Meta Business que inclua mensagens também.

Cuidado

Páginas que pertencem a um Meta Business são compatíveis. Se você chega à Página por meio de uma função no Business em vez de administrá-la diretamente, o Quickchat AI ainda consegue abri-la, desde que essa função inclua as mensagens. Se mesmo assim o Facebook recusar a Página, veja Solução de problemas e FAQs abaixo.

Cuidado

Uma Página do Facebook pode ser conectada a um único Assistente de IA por vez. Se você gerencia vários Agentes, use uma Página separada para cada um.

Passo 1 - Autorize o Quickchat AI no Facebook

1. Abra o App do Quickchat AI e vá em External Apps.
2. Clique em Messenger e depois clique em Conectar com o Facebook.
3. Um pop-up do Facebook é aberto. Faça login se solicitado e continue como você mesmo.
4. Marque a Página para a qual você quer que seu Assistente de IA responda e revise as permissões solicitadas. Se nenhuma Página for marcada, o Facebook não compartilha nenhuma e nada é conectado (veja Solução de problemas e FAQs).
5. Clique em Continue / Confirm para conceder acesso ao Quickchat AI.
6. O pop-up se fecha e você volta ao Quickchat AI. Enquanto ele trabalha, o painel mostra Conectando ao Facebook.

Autorizar ainda não coloca seu Assistente no ar. O painel do Messenger agora mostra o selo Concluir configuração e pede que você confirme a Página.

Passo 2 - Confirme em qual Página seu Assistente de IA responde

1. Se o Facebook retornar uma Página, o painel do Messenger mostra Confirme sua Página do Facebook. Confira o nome e o ID e clique em Conectar seguido do nome, por exemplo Conectar Acme Support.
2. Se o Facebook retornar várias Páginas, o painel mostra Escolha uma página do Facebook. Confira o nome e o ID da Página desejada e clique em Conectar esta página ao lado dela.

Confirmar a Página habilita as respostas imediatamente. Conclua o conhecimento, as instruções e as configurações de transferência para uma pessoa do seu Assistente antes de confirmar. Nada fica ativo antes dessa confirmação.

Neste ponto, há outras duas opções:

• Usar outra conta do Facebook reinicia a autorização do Facebook, para que você possa entrar com uma conta que administre a Página desejada.
• Cancelar configuração descarta a conexão pendente. Ela só aparece enquanto nenhuma Página está conectada, então você não perde uma integração que já funciona.

Depois de confirmar, o painel mostra Conectado com o nome da Página e o ID da Página.

Seu Assistente de IA já está habilitado no Messenger. Envie uma mensagem de teste para verificar a resposta.

Passo 3 - Pause ou retome as respostas

Confirmar a Página ativa Habilitar Messenger. Use o botão para ligar ou desligar a integração sem desconectar a Página. Quando está ligado, seu Assistente de IA responde às mensagens recebidas no Messenger; quando está desligado, a Página permanece conectada, mas o Agente para de responder.

O botão fica indisponível até você confirmar uma Página no Passo 2.

Experimente

Abra sua Página no Messenger (por exemplo, via m.me/<nome-de-usuario-da-sua-pagina>) e envie uma mensagem. Seu Assistente de IA responde, e a conversa aparece na sua Caixa de entrada do Quickchat AI, onde você pode ler a transcrição completa, ver o nome do visitante e assumir o controle da IA a qualquer momento.

Depois de assumir o controle de uma conversa na Caixa de entrada, use Anexar arquivo ou imagem para enviar uma imagem JPEG ou PNG (até 5 MB) ou um PDF (até 16 MB). Outros tipos de arquivo e áudio não são compatíveis. Os anexos são enviados sem legendas. Qualquer texto que você tenha digitado permanece no campo de mensagem; envie-o separadamente após o envio do arquivo terminar.

Solução de problemas e FAQs

O pop-up não abre.

• Desative os bloqueadores de pop-up e de rastreadores do navegador, recarregue a página e tente novamente. Se isso não ajudar, tente outro navegador.

Autorizei no Facebook, mas nada parece conectado.

• Autorizar é só o Passo 1. Volte ao painel do Messenger, procure o selo Concluir configuração e confirme sua Página conforme o Passo 2. Seu Assistente de IA só começa a responder depois que você confirma.

Aparece “Facebook won’t let us open that Page”.

• O Facebook recusou essa Página específica. A conta com que você entrou não tem uma função na Página que inclua as mensagens, nem diretamente nem por meio de um Meta Business.
• Abra a Página no facebook.com, vá em Settings > Page access, dê à sua conta uma função que inclua gerir mensagens e conecte novamente.
• Se você não conseguir alterar isso, peça a quem administra a Página que faça a conexão, ou fale conosco.

Aparece “Your Facebook session ended”.

• O Facebook encerrou sua sessão antes de a configuração terminar. Nada foi alterado na sua Página.
• Inicie a conexão novamente e mantenha a sessão do Facebook aberta até ela concluir.

Aparece “A Facebook permission wasn’t granted”.

• O login do Facebook não incluiu uma das permissões de que a Quickchat AI precisa para abrir sua Página, geralmente porque foi desmarcada na tela do Facebook.
• Conecte novamente e mantenha todas as permissões solicitadas ativadas. Elas são usadas apenas para encontrar sua Página e responder às mensagens dela.

Aparece “We couldn’t open that Facebook Page”.

• O Facebook não entregou a Página e não disse por quê. Normalmente vale uma nova tentativa.
• Se falhar de novo, confira em Settings > Page access se sua conta tem uma função na Página que inclua as mensagens e conecte novamente.

Aparece “No Facebook Page connected” ou “O Facebook não compartilhou nenhuma página”.

• O Facebook concluiu o login sem compartilhar nenhuma Página. Ou nenhuma Página foi marcada na tela do Facebook, ou a conta com a qual você entrou não administra nenhuma Página.
• Nada muda no Quickchat AI. Sua conexão atual continua como estava, e as Páginas que aguardam sua confirmação continuam na lista.
• Tente de novo com Conectar com o Facebook, Trocar página ou Usar outra conta do Facebook, conforme o que o painel do Messenger mostrar, e marque sua Página na tela do Facebook. Se ela não estiver listada, entre com a conta do Facebook que a administra.
• Ainda não tem uma Página? Use Criar uma página do Facebook e conecte novamente.

Meu Assistente de IA não responde.

• Verifique se você concluiu o Passo 2 e se o painel mostra a Página como Conectado, e não como Concluir configuração.
• Verifique se o botão Habilitar Messenger está ligado.
• Confirme que você conectou a Página pretendida e que o Assistente de IA correto está selecionado.
• Uma Página se conecta a um único Assistente de IA. Não conecte a mesma Página a vários Agentes.

Conectei a Página errada.

• Clique em Trocar página no painel da integração, entre no Facebook e confirme a Página correta no Passo 2.

O Messenger envia uma mensagem de boas-vindas?

• O Quickchat AI não envia uma mensagem de boas-vindas automática no Messenger. O cliente inicia a conversa enviando uma mensagem à Página. Alterar a mensagem de boas-vindas do widget do site não cria uma saudação no Messenger.

Precisa de ajuda?

Ainda travado? Fale com a gente no Discord ou entre em contato, e ajudaremos você a conectar sua Página.