Messenger
Dois caminhos
Abra Configurações → Canais na barra lateral do painel e, no cartão Messenger, escolha Autorizar. A janela oferece duas rotas:
- Conecte sua Página do Facebook, com o botão Conectar Página, em um único pop-up: escolha a sua Página, permita o acesso e pronto. Nada para copiar, nada para configurar no lado do Facebook.
- Avançado, traga o seu próprio app da Meta, abaixo dele, a rota manual, para quem já tem um app próprio no site de desenvolvedores do Facebook.
O botão Conectar Página mostra atualmente Em breve: o aplicativo próprio do ProxyAI no Facebook ainda passa pela verificação de negócios e pela revisão da Meta. Essa é uma decisão e um cronograma da Meta. Até lá, a rota avançada funciona por completo.
A rota manual
Esta é realmente técnica, envolve o site de desenvolvedores do Facebook e não as configurações comuns de Página. Se não for a sua praia, repasse esta seção para quem cuida do seu site ou aguarde a conexão com um clique.
O Messenger entrega as mensagens por meio de uma Página do Facebook, nunca de um perfil pessoal. Você vai precisar de:
- Uma Página do Facebook da qual você seja administrador.
- Um app no site de desenvolvedores da Meta com o produto Messenger adicionado.
Dois valores vão para o ProxyAI:
- Token de acesso da Página, no site de desenvolvedores da Meta: seu app → Messenger → Configurações → Tokens de acesso → adicione sua Página e gere um token.
- App Secret, em Configurações do app → Básico → App Secret. O ProxyAI o usa para confirmar que as mensagens recebidas realmente vieram do Facebook, para que ninguém consiga enviar mensagens falsas ao seu bot.
Trate os dois como senhas. Se algum deles vazar, redefina-o no lado da Meta e salve o substituto aqui.
Cole os dois e escolha Salvar. O ProxyAI verifica os valores com o Facebook e conecta a sua Página.
Aponte o Facebook para o ProxyAI
O Facebook mantém esta configuração no app, não na Página, então o ProxyAI não consegue preenchê-la para você. A janela mostra os dois valores necessários, cada um com botão de copiar: URL de callback do webhook e Token de verificação.
Depois, uma vez por app:
- Site de desenvolvedores da Meta → seu app → Messenger → Configurações → Webhooks.
- Escolha Adicionar URL de callback.
- Cole a URL de callback e o token de verificação da janela do ProxyAI.
- Escolha Verificar e salvar. O Facebook verifica o endereço imediatamente, então salve primeiro no ProxyAI.
- Assine `messages` e adicione `messaging_postbacks` se o seu bot usar botões.
Deixe clientes reais entrarem
Um app novo começa no modo Desenvolvimento, no qual só recebem resposta as pessoas listadas no app: você e quem você adicionar. Para atender clientes reais, conclua a Revisão de App da Meta para pages_messaging e depois mude o app para Ativo.
Teste
Abra a sua Página no Messenger e envie uma mensagem. O bot responde em poucos segundos.
- Nenhuma resposta: a assinatura de
messagesestá faltando, ou o app ainda está no modo Desenvolvimento e você está enviando de uma conta que não está nele. - O Facebook rejeita a verificação: o token de verificação precisa coincidir exatamente com o da janela do ProxyAI, e você precisa ter salvo no ProxyAI antes de pressionar Verificar e salvar.
- Falha ao salvar com erro de token inválido: o token é de outra Página ou expirou. Gere um novo.
A regra das 24 horas
O Facebook só permite que uma Página responda dentro de 24 horas desde a última mensagem do cliente. As respostas do bot saem imediatamente, então quase nunca são afetadas. As respostas humanas são: se você assumir uma conversa na caixa de entrada do agente e responder um dia depois, o Facebook recusa; a caixa de entrada informa que a janela expirou e o cliente precisa escrever de novo. Essa é a regra da Meta, e nada no lado do ProxyAI pode suspendê-la.