// ANTES DE COMECAR · PRE-REQUISITOS
O que voce precisa ter em maos
Tres coisas e mais nada. Nenhuma delas custa dinheiro. O fluxo no portal do Meta leva cerca de um minuto, e o painel final roda gratuito e ilimitado.
Conta no Meta for Developers
Acesso ao portal em developers.facebook.com, onde voce cria o aplicativo e gera o token.
Conta no Instagram
A sua propria conta, pra adicionar como usuario de teste do aplicativo.
Claude Code instalado
Funcionando na sua maquina. E ele que monta a integracao e o painel pra voce.
Custo e tempo
100% gratuito e ilimitado. Cerca de 1 minuto pro fluxo do portal do Meta.
// PORTAL DO META
Abrir o portal de desenvolvedores
Acesse developers.facebook.com e clique em Meus apps. E daqui que sai todo o resto: o aplicativo, o usuario de teste e o token de acesso.
Acessedevelopers.facebook.com
Cliquebotao “Meus apps” no topo
Resultadolista dos seus aplicativos abre
// CASO DE USO
Criar o aplicativo
Clique em Criar aplicativo. Na etapa de caso de uso, selecione Gerenciar mensagens e conteudo no Instagram, a opcao do Instagram, que fica no meio. As outras duas sao Messenger e WhatsApp, ignore.
Clique“Criar aplicativo”
EscolhaGerenciar mensagens e conteudo no Instagram
Ondeopcao do meio (Instagram)
Nao eMessenger nem WhatsApp
// USUARIO DE TESTE
Adicionar seu Instagram como testador
Va em Funcoes do app, depois Usuarios de teste. Clique em Adicionar pessoas e adicione a sua propria conta do Instagram como testador. E ela que a automacao vai controlar.
Va emFuncoes do app
DepoisUsuarios de teste
CliqueAdicionar pessoas
Adicionesua propria conta do Instagram
// TOKEN DE ACESSO
Gerar o token de acesso
Va em Ferramentas, depois Explorador de Graph API. Clique pra gerar um token de acesso. Esse token e a chave que liga a sua conta a automacao, guarde ele.
Va emFerramentas
AbraExplorador de Graph API
Cliquegerar token de acesso
Guardeo token pro proximo passo
// CLAUDE CODE
Levar o token pro Claude Code
Cole o token direto no Claude Code e peca pra ele integrar a automacao pra voce, conectando com a API do Instagram usando esse token. Ele cuida do codigo, voce so descreve o que quer.
Coleo token direto no Claude Code
Pecaintegrar a automacao pra voce
Ele conectacom a API do Instagram usando o token
// PAINEL
Pedir o painel estilo ManyChat
Ainda no Claude Code, peca pra ele criar uma dashboard estilo ManyChat. Pronto: um ManyChat 100% gratuito e ilimitado rodando pra voce, publicado na Vercel.
Pecauma dashboard estilo ManyChat
Publicana Vercel
ResultadoManyChat gratuito e ilimitado seu
// AUTOMACAO POR REEL
Configurar a automacao no painel
Por Reel, voce escolhe o gatilho (quando alguem comenta ou manda DM), a palavra-chave e monta a sequencia de DM. No fim, salve em rascunho e clique em Publicar.
aresposta rotativa no comentario, pra nao parecer robo
b1a mensagem na DM
cDM pedindo pra pessoa te seguir antes do link
do link final
Salvarem rascunho, depois Publicar
// PARTE 2 · O QUE O REEL NAO TE CONTOU
Pra funcionar de verdade,
falta o que ninguem mostra.
A Parte 1 (os 7 passos do reel) te faz testar na sua propria conta hoje. Funciona 100% pra isso. Mas pra virar um ManyChat que responde qualquer seguidor, faltam cinco pecas tecnicas que o video de 60 segundos pulou. Sao elas que ligam tudo de ponta a ponta.
Como o ManyChat funciona por baixo
O painel dispara duas acoes distintas, e voce configura as duas: a resposta publica no comentario, que aparece pra todos no post, e a DM privada (a private reply), que so o autor do comentario recebe no direct. Sao endpoints diferentes do Meta. E a private reply que carrega o link e vira lead.
// ESCOPOS E PERMISSOES
Os escopos certos (e atuais) do token
Pre-requisito que o reel nao cita: a conta do Instagram precisa ser Business ou Creator (profissional). Conta pessoal nao acessa a Messaging API. No fluxo moderno de login do Instagram, o caso de uso que o reel escolhe, voce nao precisa mais vincular a uma Pagina do Facebook: token e login saem direto do Instagram.
Os nomes antigos instagram_manage_messages e instagram_manage_comments foram descontinuados em 27/01/2025. Use sempre os instagram_business_* abaixo.
instagram_business_basicler perfil e midiainstagram_business_manage_messageslibera a DM: DM normal e private reply ao comentarioinstagram_business_manage_commentsler, responder, ocultar e deletar comentariosinstagram_business_content_publishpublicar posts e reels (opcional pro fluxo comentario para DM)
// A PECA CRITICA
Configurar o webhook
Sem webhook, o Instagram nunca avisa seu servidor que alguem comentou, e a automacao nunca dispara. O token so serve pra voce chamar a API. O webhook e o que faz a API chamar voce. Essa e a peca que o reel escondeu, e a mais importante.
Onde: no app em developers.facebook.com, va no produto Webhooks (ou API Setup with Instagram login) e escolha o objeto Instagram.
Callback URL e Verify Token: a Callback URL e a URL publica HTTPS do seu servidor. Localhost nao funciona, precisa de dominio real ou tunel ngrok/cloudflared. O Verify Token e uma string secreta que voce inventa; guarde a mesma no servidor pra comparar no handshake.
Ao salvar a Callback URL, o Meta faz um GET com hub.mode=subscribe, hub.verify_token e hub.challenge. Seu servidor confere o verify_token, devolve o hub.challenge como numero puro e HTTP 200. Sem isso, o Meta recusa a URL.
Cada evento chega como POST com o header X-Hub-Signature-256: sha256=<hmac>, um HMAC-SHA256 do corpo cru usando o App Secret como chave. Recalcule e compare com hmac.compare_digest. Se nao bater, descarte. Persista o payload cru antes de processar: o Meta reentrega se o banco piscar.
Doc MetaWebhooks da plataforma Instagram
commentsgatilho principal do comentario
live_commentscomentarios em transmissao ao vivo
mentionsquando te marcam
messagesa sequencia de conversa na DM
messaging_postbackscliques em botoes
messaging_seenconfirmacao de leitura
// O MAIS IMPORTANTE
O prompt exato pro Claude Code
Esse e o item que faz tudo acontecer. Copie o bloco abaixo e cole direto no Claude Code: ele descreve o servidor inteiro, do handshake ao disparo da DM, do jeito que precisa ser pra funcionar de verdade. Depois e so passar seu token e seus dados.
Crie um servidor web (Python + FastAPI, com uvicorn) que implemente a automacao comentario para DM do Instagram via Graph API do Instagram (graph.instagram.com, versao v23.0 ou a mais recente estavel). Requisitos:
1. GET /webhook (handshake do Meta): ler hub.mode, hub.verify_token, hub.challenge. Se hub.mode=="subscribe" E hub.verify_token == VERIFY_TOKEN (env), responder o hub.challenge como numero puro, HTTP 200; senao 403. Usar hmac.compare_digest.
2. POST /webhook (eventos): ler o corpo CRU (bytes) antes do parse; validar X-Hub-Signature-256 recalculando "sha256="+HMAC-SHA256(app_secret, corpo_cru) e comparando com hmac.compare_digest; se nao bater, 401 e descarta. Persistir o payload cru no Postgres ANTES de processar. Parse JSON: para object=="instagram", percorrer entry[].changes[]; quando field for "comments"/"live_comments"/"mentions", extrair value.id (comment_id), value.text, value.from.id, value.from.username, value.media.id. Anti-loop: ignorar se o autor for a propria conta. Dedup: cada usuario recebe a DM de uma automacao UMA vez (UNIQUE automation_id+ig_user_id, ON CONFLICT DO NOTHING).
3. Ao casar automacao (palavra-chave no texto, ou "qualquer comentario"):
- (opcional) resposta publica: POST graph.instagram.com/v23.0/{comment_id}/replies {"message":"<texto>"}
- DM privada (private reply): POST graph.instagram.com/v23.0/{ig_user_id}/messages {"recipient":{"comment_id":"<comment_id>"},"message":{"text":"<texto>"}}
Se houver botao com URL, mandar attachment template_type=button NA MESMA mensagem; botoes sem URL viram quick_replies na MESMA mensagem (private reply tem janela de 7 dias; nao fazer 2a chamada por IGSID, que cai fora da janela de 24h e da erro #10).
- Todos os POSTs levam ?access_token=<TOKEN>.
4. Guardar contatos (ig_user_id, username) e permitir SEQUENCIA: POST /{ig_user_id}/messages com recipient {"id":"<ig_user_id>"} pras mensagens seguintes (dentro da janela de 24h apos a pessoa responder).
5. No connect da conta, assinar webhooks: POST graph.instagram.com/v23.0/{ig_user_id}/subscribed_apps com subscribed_fields = messages,messaging_postbacks,comments,messaging_seen
Env: IG_APP_ID, IG_APP_SECRET, VERIFY_TOKEN, ACCESS_TOKEN, DATABASE_URL. Responder 200 rapido no POST (Meta reentrega se demorar) e logar cada disparo com sucesso/erro.
Host e graph.instagram.com (NAO graph.facebook.com) no login do Instagram.
// TOKEN QUE NAO MORRE EM 1H
Token de longa duracao
O token que sai do Explorador de Graph API e short-lived: morre em cerca de 1 hora. Pra automacao nao parar, troque por um de longa duracao e depois va renovando. Sao duas chamadas GET simples.
Trocar por long-lived (cerca de 60 dias): chame o endpoint de exchange com grant_type=ig_exchange_token passando o App Secret e o token curto.
Renovar (mais 60 dias): chame o refresh com grant_type=ig_refresh_token; o token precisa ter pelo menos 24h de vida. Agende a renovacao a cada cerca de 50 dias.
Um System User token no Business Manager tem longa duracao (ou nao expira) com os mesmos escopos. Configura em Business Settings, Users, System Users.
Trocar por longo (60 dias)
Renovar (mais 60 dias)
// A VERDADE SOBRE PRODUCAO
Modo Dev vs App Review
Em modo dev, a automacao so funciona com contas listadas como test users no app. E por isso que o reel manda adicionar sua conta como testador. Pra qualquer seguidor receber a DM, precisa passar pelo App Review do Meta e ganhar Advanced Access nos escopos de mensagem.
O tutorial do reel funciona 100% pra voce testar na sua propria conta hoje. Pra virar um ManyChat que responde qualquer seguidor, falta enviar o app pra App Review: e trabalho de formulario e video (um screencast mostrando cada permissao), nao de codigo. A aprovacao leva de dias a semanas.
Standardso quem tem papel no app (admin, dev, tester); serve pra testar
Dev Modeso test users conectam e recebem DM ate a revisao passar
Advancedvia App Review; exigido pra atender contas que nao sao suas
Limites pra sequencia nao ser bloqueada
Janela 24hapos a pessoa te mandar DM, 24h pra responder livre; depois so com tag de agente humano (estende 7 dias)
Private replyjanela propria de 7 dias; por isso o link vai NA MESMA mensagem
Rate limit750 private replies por hora por conta em posts e reels; 100 por segundo em comentarios de Live
// DICAS · PRA CONVERTER MAIS
Dois detalhes que fazem diferenca
Sao pequenos, mas mudam o resultado. Um deixa a automacao natural, o outro faz seu perfil crescer a cada disparo.
Varie as respostas
Use respostas rotativas e variacoes no comentario pra nao parecer robo. Cada pessoa ve uma resposta um pouco diferente.
Peca o follow antes do link
Peca pra pessoa te seguir antes de entregar o link. Assim, cada disparo de DM tambem faz o seu perfil crescer.
// O QUE FICA
Seu ManyChat, de graca, rodando
“Comentou no Reel, recebe DM automatica.”
“Sequencia pronta: mensagem, follow e link.”
“Zero mensalidade, ilimitado, e seu.”
“Um ManyChat proprio em 7 passos, com o Claude Code.”
Sete passos, cerca de um minuto no portal do Meta, e voce tem um painel identico ao ManyChat rodando de graca. Comece pelo passo 01.
// Tutorial · comentario vira DM no Instagram · @denderson.ai