Ir para o conteúdo

Guia de Configuração Meta (Instagram & Messenger)

Conectar seu bot ao Facebook Messenger e às Mensagens Diretas do Instagram requer a configuração de um aplicativo no Portal do Desenvolvedor da Meta.

Este processo envolve várias etapas porque a Meta exige permissões explícitas e webhooks para rotear as mensagens de suas plataformas para a sua instância do FRENZY.BOT.

Pré-requisitos

Antes de começar, certifique-se de ter: 1. Uma Página do Facebook para o seu negócio. 2. Uma Conta Profissional do Instagram (Comercial ou Criador) vinculada a essa Página do Facebook. 3. Acesso ao painel do seu FRENZY.BOT para obter sua URL de Webhook.

Passo 1: Criar um Aplicativo Meta

  1. Vá para o Portal do Desenvolvedor da Meta e faça login.
  2. Clique em Meus Aplicativos no canto superior direito e depois em Criar Aplicativo.
  3. Selecione Outro como tipo de aplicativo e clique em Avançar.
  4. Selecione Empresa e clique em Avançar.
  5. Insira um Nome de Exibição do Aplicativo (ex: "Meu Bot de Negócios") e seu e-mail de contato.
  6. Selecione sua Conta Empresarial (opcional, mas recomendado) e clique em Criar Aplicativo.

Passo 2: Adicionar Produtos ao seu Aplicativo

A partir do Painel do Aplicativo: 1. Role para baixo até Adicionar produtos ao seu aplicativo. 2. Encontre Messenger e clique em Configurar. 3. Na barra lateral esquerda, clique em Messenger → Configurações do Instagram (se desejar Instagram) ou permaneça em Messenger → Configurações (para Facebook Messenger).

Passo 3: Gerar Tokens de Acesso

Você precisa de um Token de Acesso à Página para permitir que o FRENZY.BOT envie mensagens em seu nome.

  1. Em Messenger → Configurações, encontre a seção Tokens de Acesso.
  2. Clique em Adicionar ou remover páginas e autentique-se com sua conta do Facebook.
  3. Selecione a(s) Página(s) do Facebook que deseja conectar e conceda as permissões solicitadas.
  4. Assim que a Página estiver vinculada, clique em Gerar Token ao lado dela.
  5. Copie este token imediatamente e salve-o. Você irá colá-lo no painel do FRENZY.BOT.

Passo 4: Configurar o Webhook

Isso informa à Meta para onde enviar as mensagens recebidas.

  1. No painel do seu FRENZY.BOT, vá em Canais → Messenger (ou Instagram).
  2. Procure por sua Webhook URL única e o Verify Token nessa página.
  3. De volta ao Portal do Desenvolvedor da Meta, role para baixo até a seção Webhooks (em Configurações do Messenger).
  4. Clique em Adicionar URL de retorno.
  5. Cole a Webhook URL e o Verify Token do seu painel FRENZY.BOT.
  6. Clique em Verificar e Salvar.

Passo 5: Inscrever-se em Eventos

Você deve dizer à Meta quais eventos enviar para o seu webhook.

  1. Na seção Webhooks, clique em Gerenciar ao lado do nome da sua Página.
  2. Inscreva-se nos seguintes campos:
  3. messages (Obrigatório para mensagens de texto)
  4. messaging_postbacks (Obrigatório para cliques em botões/respostas rápidas)
  5. messaging_optins (Opcional, para botões "Começar")
  6. Clique em Salvar.

Passo 6: Encontrar seus IDs

Se você estiver configurando o Instagram, precisará de IDs específicos:

  1. ID da Conta do Instagram:
  2. Vá para Configurações da Página do Facebook → Contas Vinculadas → Instagram.
  3. Ou use o Explorador da API Graph: GET /v18.0/me?fields=instagram_business_account
  4. Recipient IGID:
  5. Este é o ID de escopo do Instagram da pessoa que você deseja que receba alertas (se estiver usando o Instagram como uma Integração). Para a configuração do Canal, isso geralmente não é necessário, a menos que especificado no painel.

Passo 7: Finalizar no FRENZY.BOT

  1. Volte ao seu Painel FRENZY.BOT (Canais → Messenger ou Instagram).
  2. Cole o Token de Acesso à Página que você gerou no Passo 3.
  3. Cole quaisquer IDs necessários (como o ID da Conta do Instagram).
  4. Alterne para Ativado para ligar o canal.
  5. Clique em Salvar Configurações.

⚠️ Crucial: Análise do Aplicativo (Colocando em Produção)

Ao criar um Aplicativo Meta pela primeira vez, ele estará em Modo de Desenvolvimento.

No Modo de Desenvolvimento, seu bot responderá apenas a você e a outros desenvolvedores/testadores adicionados ao aplicativo no portal da Meta (em Funções do Aplicativo).

Para fazer seu bot responder ao público em geral, você deve: 1. Concluir a Verificação de Empresa no Portal do Desenvolvedor da Meta. 2. Solicitar Acesso Avançado para permissões específicas (geralmente pages_messaging e instagram_manage_messages). 3. Enviar um screencast mostrando como seu bot funciona. 4. Uma vez aprovado, mude a chave do aplicativo no topo da tela de Desenvolvimento para Ativo.

Nota: O processo de análise da Meta pode levar vários dias.