Pela API oficial da Meta, sem senha compartilhada: 8 passos e um arquivo para colar no Claude Code.
Responde com as regras do consultório. Dúvida clínica vai para a equipe.
Quem comenta CHECK-UP no post recebe o guia no direct em segundos.
13h e 19h pelos próximos 30 dias: é só pedir.
Pergunte qual post trouxe mais pedidos de consulta.
O Claude Code gasta créditos para montar e conectar tudo: use o Pro ou, de preferência, o Max.
No app do Claude, entre na aba Code e escolha uma pasta nova para o projeto.
Copie o arquivo do fim desta página e cole no Claude Code: ele monta o projeto e pergunta o que faltar.
Ir para o arquivo ↓A API oficial só funciona com conta profissional: Comercial ou Criador de conteúdo.
Em developers.facebook.com, crie o app com o caso de uso do Instagram. O Claude te guia clique a clique.
Abrir o Meta for Developers ↗Clique em Conectar Instagram e autorize na tela oficial: ninguém recebe a sua senha.
Comente CHECK-UP num post e mande um direct de outra conta: a resposta chega em segundos.
Com o app em teste, só contas com função no app recebem resposta. Para atender todo mundo, a Meta analisa o app: o Claude prepara o pedido com você.
Peça em português: ele agenda os posts, cria as automações e mostra o que trouxe consulta.
Sem senha compartilhada e sem extensão duvidosa: você autoriza na tela oficial.
Sintoma, remédio ou exame: a IA não responde e passa para a equipe.
Aprova regras, textos e posts, e assume qualquer conversa.
Conversa de saúde é dado sensível pela LGPD. Avise que é um atendimento automático, guarde só o necessário e proteja o servidor.
A conduta continua sendo sua: a IA informa e encaminha. Quem orienta o paciente é o médico.
O plano do Claude para montar, uma chave da API da Anthropic para a IA responder (cobrada por uso) e um servidor com endereço HTTPS.
As chaves ficam só no arquivo .env, no seu computador ou servidor.
O caminho inteiro, pronto.
Ele monta e conecta com você.
O próximo sai em minutos.
INSTAGRAM DO CONSULTÓRIO COM O CLAUDE
Você vai me ajudar a conectar o Instagram profissional do meu consultório a um
assistente que eu controlo, usando só a API oficial da Meta (API do Instagram
com login do Instagram, graph.instagram.com). Siga uma etapa por vez, explique
em português simples e espere o meu ok antes de seguir.
REGRAS DO COMEÇO AO FIM
- Nunca me peça a senha do Instagram ou do Facebook: a conexão é pelo login
oficial, que eu autorizo na tela da Meta.
- Chaves, tokens e segredos ficam só no arquivo .env, que eu mesmo preencho.
Nunca no chat, no código ou no git.
- Nada de extensão de navegador, robô de clique ou biblioteca não oficial.
- Dúvida clínica (sintoma, remédio, exame, diagnóstico) nunca é respondida pela
IA: o paciente recebe uma mensagem padrão e a conversa vai para a minha equipe.
Sinal de emergência: orientar a ligar 192 na hora.
- Nada vai para o Instagram de verdade antes de eu testar e aprovar.
1. PROJETO
Crie a pasta instagram-consultorio com Node.js 22: servidor web pequeno, banco
SQLite e um painel simples com senha. Crie o .env.example com INSTAGRAM_APP_ID,
INSTAGRAM_APP_SECRET, INSTAGRAM_REDIRECT_URI, WEBHOOK_VERIFY_TOKEN (32 ou mais
caracteres aleatórios), TOKEN_ENCRYPTION_KEY (32 bytes em base64),
ANTHROPIC_API_KEY, AI_MODEL=claude-opus-5-5 e PAINEL_SENHA.
Escreva testes de cada parte.
2. CONTA PROFISSIONAL
Confirme comigo que o Instagram é conta profissional (Comercial ou Criador de
conteúdo) e que, no celular, em Configurações → Mensagens e respostas a stories
→ Ferramentas conectadas, "Permitir acesso a mensagens" está ligado.
3. APP NA META
Me guie em developers.facebook.com: criar o app com o caso de uso "Gerenciar
mensagens e conteúdo no Instagram", configurar a API com login do Instagram,
cadastrar o endereço de retorno exato (HTTPS) e pegar o ID e a chave secreta do
app do Instagram (podem ser diferentes do ID do app da Meta). Eu colo no .env.
Permissões: instagram_business_basic, instagram_business_manage_messages,
instagram_business_manage_comments, instagram_business_content_publish e
instagram_business_manage_insights.
Me explique a diferença entre o app em teste (só contas com função no app) e o
app aprovado pela análise da Meta (qualquer pessoa), e prepare comigo o pedido
de análise quando chegar a hora.
4. ENDEREÇO PÚBLICO
A Meta precisa chamar o meu servidor por HTTPS. Para testar no computador, use
um túnel (cloudflared). Para ficar no ar, me ajude a publicar (Railway ou Render).
5. CONECTAR O INSTAGRAM
Botão "Conectar Instagram" que abre https://www.instagram.com/oauth/authorize
com client_id, redirect_uri, response_type=code, scope (as permissões acima,
separadas por vírgula) e um state aleatório, de uso único, que vence em 15 min.
No retorno: confira o state, troque o code por token em
POST https://api.instagram.com/oauth/access_token, troque pelo token de longa
duração em GET https://graph.instagram.com/access_token?grant_type=ig_exchange_token
e confira a conta em
GET https://graph.instagram.com/v26.0/me?fields=user_id,username,account_type
(tem de ser BUSINESS ou MEDIA_CREATOR). Guarde o token cifrado (AES-256-GCM) e
renove antes de vencer em
GET https://graph.instagram.com/refresh_access_token?grant_type=ig_refresh_token.
Se a Meta devolver o erro 190, me avise para conectar de novo.
6. AVISOS DA META (WEBHOOKS)
GET /webhooks/instagram: devolva o hub.challenge só quando hub.mode=subscribe e
o hub.verify_token bater. POST: valide a assinatura X-Hub-Signature-256 (HMAC
SHA-256 do corpo bruto com a chave secreta do app) antes de tudo, guarde o
evento sem duplicar, responda 200 na hora e processe depois, numa fila.
Assine comments e messages no painel do app e, depois do login, chame
POST https://graph.instagram.com/v26.0/<user_id>/subscribed_apps
com subscribed_fields=comments,messages,messaging_postbacks.
7. DIRECT COM AS REGRAS DO CONSULTÓRIO
Me entreviste e escreva regras.md: endereço, horários, convênios, como marcar
consulta e o que nunca responder. A IA (AI_MODEL) responde só com o que está
ali; o resto vai para a equipe. Envie em
POST https://graph.instagram.com/v26.0/<user_id>/messages com recipient.id.
Respeite a janela de 24 horas desde a última mensagem do paciente, mensagens
curtas e um limite por hora. Mostre tudo no painel e me deixe assumir qualquer
conversa.
8. COMENTOU, RECEBEU
Automação por palavra-chave (exemplo: CHECK-UP) num post ou em todos: resposta
privada pelo mesmo endpoint de mensagens com recipient.comment_id, uma vez por
comentário, só para comentários de até 7 dias, com um botão de link (template
"button", título de até 20 caracteres). Opcional: resposta pública curta em
POST https://graph.instagram.com/v26.0/<comment_id>/replies.
9. POSTS AGENDADOS
Agenda no painel: imagem ou vídeo, legenda, dia e hora (exemplo: 13h e 19h
pelos próximos 30 dias). No horário, crie o contêiner em
POST https://graph.instagram.com/v26.0/<user_id>/media (image_url, ou
video_url com media_type=REELS, sempre numa URL pública), espere o status_code
FINISHED e publique em POST .../<user_id>/media_publish com creation_id.
Respeite o limite diário de publicações da Meta e me avise se algo falhar.
10. MÉTRICAS
Leia as métricas de cada post (insights) e conte os pedidos de consulta que
chegaram pelo direct ou pela automação de cada post. Quero perguntar "qual post
trouxe mais pedidos de consulta?" e receber uma tabela.
11. TESTE E LIBERAÇÃO
Primeiro só com contas de teste: comentar CHECK-UP de outra conta, um direct de
madrugada, uma dúvida clínica e um "quero falar com alguém". Só depois de eu
aprovar, libere para todos.
No final, transforme esse processo numa SKILL reutilizável chamada
"instagram-consultorio", para eu montar o próximo só dizendo o consultório e o @.
Na comunidade você encontra outros médicos montando o seu e as soluções para ir além.