Conectar o FluxoChat ao Instagram

Passo a passo para quem tem um celular e um computador com Windows. Reserve cerca de 1 hora na primeira vez.

Como funciona

Para a Meta conseguir avisar o FluxoChat, ele precisa de um endereço público com HTTPS. Por enquanto, esse endereço vem de um túnel que roda no seu computador. Enquanto o FluxoChat estiver nesse esquema, o computador precisa ficar ligado e com as duas janelas abertas. Depois que tudo estiver testado, dá para hospedar o FluxoChat num servidor que fica no ar 24 horas.

1 Preparar o Instagram 📱 celular

1. Conta profissional: no app do Instagram, toque no seu perfil → ☰ → Tipo de conta e ferramentas → Mudar para conta profissional → escolha Empresa. Se já for profissional, pule.
2. Conta pública: comentários de contas privadas não geram aviso. Deixe a conta da agência pública.
3. Permitir acesso às mensagens: em Configurações → Mensagens e respostas aos stories → Controles de mensagens, ative Permitir acesso às mensagens (pode aparecer em “Ferramentas conectadas”). Sem isso, a Meta não entrega as DMs para ferramentas externas.

2 Ligar o FluxoChat 💻 computador

1. Na pasta C:\Users\User\FluxoChat, dê dois cliques em iniciar.bat. Uma janela preta abre (deixe aberta) e o Chrome abre em http://localhost:3000.
2. Crie a senha do painel (mínimo 8 caracteres). Ela protege o FluxoChat quando ele estiver acessível pela internet. Guarde bem.
3. Opcional: se você já tinha ajustado fluxos no modo local (arquivo aberto direto), leve-os para o servidor: no modo local, vá em Configurações → Exportar JSON; no servidor, Configurações → Importar JSON.

Esqueceu a senha? Feche a janela preta, abra o PowerShell na pasta FluxoChat, rode node server\server.js --reset-password e abra o iniciar.bat de novo.

3 Criar o endereço público (túnel) 💻 computador

1. Instale o cloudflared (só na primeira vez): abra o PowerShell pelo menu Iniciar e rode winget install --id Cloudflare.cloudflared.
2. Dê dois cliques em tunel.bat. Outra janela preta abre. Procure a linha com um endereço assim: https://palavras-aleatorias.trycloudflare.com.
3. Abra esse endereço no Chrome, entre com a sua senha e vá em 📡 Canais. A tela vai mostrar a URL de callback e o token de verificação, que você vai usar no passo 5.

4 Criar o app na Meta 💻 Chrome

1. Acesse developers.facebook.com/apps e entre com o seu Facebook. Na primeira vez, ele pede para você se registrar como desenvolvedor (confirma por SMS no seu celular).
2. Clique em Criar app. No caso de uso, escolha Gerenciar mensagens e conteúdo no Instagram. Dê um nome (ex.: “FluxoChat Agência”). Se pedir portfólio empresarial, pode pular ou usar o da agência.
3. No menu do app, abra Instagram → Configuração da API com login do Instagram (em inglês: API setup with Instagram business login).
4. No topo dessa página aparecem o ID do app do Instagram e a chave secreta do app do Instagram. Clique em Mostrar na chave secreta e copie.
5. Em Gerar tokens de acesso, clique em Adicionar conta, entre com o Instagram da agência e autorize. Depois clique em Gerar token ao lado da conta e copie o token (começa com IGAA…).

O token vale 60 dias. O FluxoChat renova sozinho toda semana, enquanto estiver ligado.

5 Ligar as duas pontas 💻 Chrome

1. No FluxoChat (pelo endereço do túnel) → 📡 Canais → seção 2: cole a chave secreta do app do Instagram e o token, e clique em Conectar Instagram. Deve aparecer “✅ @suaconta conectado”.
2. Na Meta, na mesma página do passo 4.3, abra Configurar webhooks:
   • URL de callback: copie do FluxoChat (termina em /webhook/instagram).
   • Token de verificação: copie do FluxoChat (começa com fluxochat-).
   • Clique em Verificar e salvar.
   • Na lista de campos, ative a assinatura de messages, messaging_postbacks e comments.
3. Volte ao FluxoChat → Canais. O status deve ser Conectado. Se aparecer “sem webhook”, clique em Ativar recebimento.

6 Testar 📱 celular + 💻

Você precisa de outra conta do Instagram para fazer o papel de cliente. Com um celular só, dá para adicionar uma segunda conta pessoal no próprio app (perfil → nome da conta no topo → Adicionar conta), ou pedir para um amigo.

1. Da conta “cliente”, mande uma DM para a agência: oi. A triagem deve responder com os botões 🚤 / 🎣 / 🏨.
2. Toque em 🎣 e siga a conversa. No FluxoChat, em Simulador, o contato aparece com a etiqueta 📸 e a conversa atualiza ao vivo.
3. Num post da agência, comente PESCA com a conta “cliente”. Deve aparecer a resposta pública e chegar uma DM.

7 Liberar para todos os clientes 💻 Chrome

Para responder qualquer pessoa, e não só testadores, o app precisa estar Ativo (Live):

1. Em Configurações do app → Básico, preencha a URL da política de privacidade. O FluxoChat já tem um modelo em /privacidade.html: edite os campos entre colchetes (nome, CNPJ, e-mail) antes de usar. Use o endereço público, ex.: https://seu-endereco/privacidade.html. Preencha também ícone, categoria e instruções de exclusão de dados (podem apontar para a mesma página, seção 6).
2. No topo do painel da Meta, mude o Modo do app para Ativo.
3. A Meta pode pedir verificação da empresa (documentos da agência) e revisão do app para a permissão de mensagens (instagram_business_manage_messages) e de comentários. Se o painel pedir, siga as instruções dele. Na revisão, eles pedem um vídeo curto mostrando o atendimento funcionando, e o Simulador e o teste do passo 6 servem para isso.

Regras do Instagram que o FluxoChat respeita

• Janela de 24 horas: só dá para mandar mensagem até 24 h depois da última mensagem do cliente. Fora disso, o FluxoChat não envia e registra “⚠️ Não foi entregue” na conversa. Isso vale também para transmissões.
• Comentário → DM: a resposta privada a um comentário é uma única mensagem. As próximas só saem depois que a pessoa responder. Por isso os fluxos de comentário mandam uma mensagem só, com um botão.
• Botões: viram “respostas rápidas” no Instagram, com até 13 opções e até 20 caracteres cada. Botões de link aparecem como link no texto.
• Atrasos longos (ex.: “esperar 1 dia”) ficam agendados e continuam mesmo se o servidor reiniciar.

Problemas comuns

Referências oficiais: Primeiros passos · Webhooks · Respostas privadas · API de mensagens. Os nomes dos menus da Meta mudam com frequência; se algum não bater, procure pelo equivalente em inglês entre parênteses.