DIRECT: como montar o seu robô do Direct

Antes de começar, 5 palavras

• API: a porta oficial que o Instagram abre pra um programa ler comentários e mandar mensagens pela sua conta.
• App da Meta: o cadastro do seu robô no painel de desenvolvedores da Meta. É ele que recebe as permissões.
• Webhook: o aviso que o Instagram manda pro seu robô na hora em que alguém comenta ou escreve no Direct.
• Token: a chave de acesso da sua conta. Trate como senha.
• Worker: um programinha que roda na nuvem da Cloudflare, sem o seu computador ligado. É onde o robô mora.

O que o DIRECT faz

O meu robô está no ar desde 16/10/2026. Eu montei com o Claude Code, que escreveu o código e os testes. Quando alguém comenta num post meu, ele faz isto:

• lê o comentário e procura a palavra de um guia. A palavra conta inteira, sem acento e sem diferença de maiúscula;
• manda no Direct da pessoa uma mensagem com o botão Quero o guia;
• responde o comentário em público, com uma frase sorteada de uma lista;
• quando a pessoa toca no botão, confere se ela segue o perfil. Se segue, manda o link do guia;
• se não segue, manda um convite pra seguir com o botão Já segui;
• umas 3 horas depois, manda a lista com todos os guias, se a conversa ainda estiver dentro das 24 horas.

Se a mesma pessoa comenta a mesma palavra de novo em 24 horas, ele ignora. E quem manda a palavra direto no Direct, sem comentar, também recebe.

Exemplo de conversa (dados inventados):

Comentário no post da Loja Exemplo: "DICA"
Resposta pública: Mandei no seu Direct! Se não aparecer, confere em Pedidos de mensagem.
Direct: Oi! Vi seu DICA aqui. Toca no botão que eu te mando o guia agora.   [Quero o guia]
Direct (não segue): Antes do link, um convite: segue a Loja Exemplo pra não perder os próximos. Seguiu? Toca em Já segui.   [Já segui]
Direct (segue): Prontinho! Aqui está o guia da DICA.   [Abrir o guia]
Direct (3 h depois): Os outros guias estão todos aqui.   [Ver todos os guias]

As frases são do mesmo jeito que as minhas. A Loja Exemplo e a palavra DICA são inventadas.

O robô responde sozinho, mas as regras são minhas: quais palavras valem, o que cada mensagem diz e quem recebe o link. Toda mudança nele passa por mim antes de ir ao ar.

As regras da Meta que ele segue

O robô usa a API oficial do Instagram, e a Meta tem regras pra mensagem automática. Ele foi montado em cima delas:

• Só responde quem pediu. A empresa só manda mensagem depois que a pessoa comentou ou escreveu primeiro.
• Uma resposta privada por comentário. A resposta ao comentário pode sair até 7 dias depois dele, e só uma vez. Por isso a primeira mensagem leva um botão, e não o link. O toque no botão é a resposta da pessoa, e isso libera as mensagens seguintes.
• Janela de 24 horas. Depois que a pessoa responde, a conversa fica aberta por 24 horas. É por isso que a lista de todos os guias só sai dentro desse prazo.
• Pedidos de mensagem. Quem não segue você recebe a conversa na pasta Pedidos de mensagem, e não na caixa principal. A resposta pública avisa isso.
• Conta profissional e pública. A API funciona com conta de empresa ou de criador de conteúdo, e a conta dona do post tem que ser pública.

Essas regras estão na documentação de respostas privadas e na documentação de mensagens da Meta.

O que você precisa

Uma conta profissional e pública no Instagram

De empresa ou de criador de conteúdo. Com o login do Instagram, que é o caminho que eu uso, não precisa ligar uma Página do Facebook. Tenha também uma 2ª conta sua, pra fazer o papel de quem comenta nos testes.

Claude com o Claude Code

O Claude Code é o Claude que trabalha dentro do seu computador: ele escreve o código, roda os testes e te explica cada passo. Ele não está no plano grátis. O Pro sai US$ 20 por mês, ou US$ 17 por mês no anual. Veja os planos do Claude.

Uma conta na Meta pra desenvolvedores e outra na Cloudflare

Na Meta você cria o app do robô. Na Cloudflare o robô roda, guarda os pedidos num banco e tem um relógio que trabalha de 15 em 15 minutos. O plano grátis da Cloudflare dá 100 mil requisições por dia, como está nos limites do plano grátis.

Uma página de política de privacidade

O painel da Meta só me deixou publicar o app depois de eu colocar o endereço da política de privacidade e o da página de exclusão de dados.

Na minha, eu escrevi o que o robô guarda: o ID da pessoa, o @, a palavra e as datas. O meu robô apaga tudo com 90 dias e nunca guarda o texto do comentário.

Passo a passo

São 8 passos. Cada um termina num "pronto quando": só passe pro próximo quando ele estiver certo.

1. Deixe a conta do Instagram pronta

• No app do Instagram, confira se a conta é profissional, de empresa ou de criador de conteúdo.
• Confira se a conta está pública.
• Separe a 2ª conta de teste. Ela começa sem seguir a sua conta principal.

Conta pública e conta profissional são exigências da documentação da Meta. Passo da documentação, não testado por mim com conta privada.

Pronto quando: a conta é profissional, pública, e a 2ª conta está logada em outro celular ou navegador.

2. Crie o app na Meta

• Abra o painel de apps da Meta e entre com a sua conta.
• Clique em criar app e escolha o tipo empresa.
• Escolha o caso de uso do Instagram. No meu painel, em 16/10, ele se chamava Gerenciar mensagens e conteúdo no Instagram.
• Escolha a API com login do Instagram.
• Adicione as três permissões: instagram_business_basic, instagram_business_manage_comments e instagram_business_manage_messages.

No meu app, a permissão de comentários não veio adicionada e eu tive que clicar em adicionar. Os nomes dos menus mudam: a documentação de criar o app hoje fala em outro caso de uso. Passo da documentação, não testado por mim numa conta nova.

Pronto quando: as três permissões aparecem na lista do app.

3. Gere o token e guarde fora do chat

• No app, abra Configuração da API com login do Instagram e o item Gerar tokens de acesso.
• Na linha da sua conta, clique em Gerar token e permita o acesso na janela do Instagram.
• Copie o token e guarde num gerenciador de senhas. Ele aparece uma vez só.
• Na tela da API do Instagram, ache a chave secreta do app do Instagram. Ela é diferente da chave secreta do aplicativo, que fica em Configurações › Básico, e o robô precisa dessa do Instagram.

Regra que eu sigo: token e chave nunca passam pelo chat do Claude. Eles vão direto pro cofre de segredos do Worker, no passo 5.

Pronto quando: o token e a chave do Instagram estão guardados, e nenhum dos dois foi colado em conversa.

4. Peça pro Claude Code montar o robô

• Crie uma pasta vazia no computador (ex.: robo-direct) e abra o Claude Code nela.
• Cole o pedido abaixo. Antes, troque o que está entre colchetes pelo seu caso.

Quero montar um robô pro Direct do meu Instagram. Não sou programador: me explique cada passo em português simples e me peça confirmação antes de qualquer coisa que dependa de mim.

O QUE ELE FAZ
1. Recebe pelo webhook do Instagram (API com login do Instagram) os comentários dos meus posts, as mensagens do meu Direct e os toques em botão.
2. Quando um comentário tem uma palavra da minha lista, manda uma resposta privada ao comentário com o botão "Quero o guia". Depois que ela sair, responde o comentário em público com uma frase sorteada de uma lista.
3. Quando a pessoa toca em "Quero o guia", confere se ela segue a minha conta (campo is_user_follow_business do perfil). Se segue, manda o link daquela palavra com o botão "Abrir o guia". Se não segue, manda um convite pra seguir com o botão "Já segui".
4. Se ela tocar em "Já segui" e ainda não seguir, convida de novo uma vez. No toque seguinte, manda o link mesmo assim.
5. Umas [3] horas depois do link, manda uma mensagem com o link de [todos os meus materiais], só se ainda estiver dentro das 24 horas da última mensagem da pessoa.
6. Se a pessoa mandar a palavra direto no Direct, pula pra conferência de quem segue.
7. Mesma pessoa e mesma palavra em 24 horas: ignora.

A LISTA DE PALAVRAS
Um arquivo com cada palavra e o link dela, que eu edito sem mexer no código. Exemplo: [DICA = https://seusite.com.br/dica]. A palavra conta inteira, sem acento e sem diferença de maiúscula.

REGRAS DA META (não quebre nenhuma)
- Só responde quem comentou ou escreveu primeiro. Nunca manda mensagem pra quem não pediu.
- Uma resposta privada por comentário. As mensagens seguintes só dentro das 24 horas da última mensagem da pessoa.
- Confere a assinatura de cada aviso (X-Hub-Signature-256) com a chave secreta do app do Instagram e responde 200 na hora. A Meta reenvia o mesmo aviso: trate cada um uma vez só.
- Ignora o que a minha própria conta faz, pra não responder a si mesmo.

ONDE RODA (plano grátis da Cloudflare)
- Um Worker com um banco D1 pros pedidos e um relógio (cron) de 15 em 15 minutos que responde o que ficou pra trás, manda a mensagem de todos os materiais, renova o token antes de vencer e apaga os pedidos com mais de 90 dias.
- Três modos: escuta (só registra no log que achou a palavra), teste (só responde as minhas contas de teste) e ligado (todo mundo).
- Se algo falhar (envio recusado, token sem renovar), me avisa no [Telegram ou e-mail].

SEGREDOS E PRIVACIDADE
- Token, chave do app e código de verificação do webhook só nos secrets do Worker. Nunca me peça pra colar nada disso aqui no chat. Me passe um comando que leia o valor da área de transferência e grave direto no Worker.
- O log nunca mostra texto de comentário, texto de mensagem, @ nem token.
- O banco guarda só o que precisa (ID da pessoa, @, palavra, datas e se ela segue) e nunca o texto do comentário.

COMO TRABALHAR
Primeiro me mostre o plano em tarefas curtas e espere o meu ok. Depois faça uma tarefa por vez, com testes que não chamam a Meta de verdade. No fim, me passe o que eu preciso fazer na Meta e na Cloudflare, na ordem.

Ele vai te mostrar um plano, esperar o seu ok e fazer uma parte por vez. O meu robô terminou com 96 testes, e todos rodam sem chamar a Meta.

Pronto quando: os testes passam e o Claude te entregou o comando de publicar o Worker.

5. Grave os segredos e publique o Worker

• Crie a sua conta grátis na Cloudflare, se ainda não tiver.
• Peça pro Claude o comando de cada segredo: o token, a chave do app e um código de verificação que ele gera na hora.
• Copie cada valor e rode o comando que lê da área de transferência. No Windows, colar com Ctrl+V no terminal já gravou um caractere invisível no lugar do meu segredo.
• Publique o Worker em modo escuta, pelo comando que o Claude passar.

Sem domínio próprio, a Cloudflare dá um endereço workers.dev pro Worker. Eu uso um subdomínio do meu site.

Pronto quando: o Worker está publicado em modo escuta e você tem o endereço dele.

6. Ligue o webhook no painel da Meta

• No app, abra a parte de webhooks da Configuração da API com login do Instagram.
• Em Callback URL, cole o endereço do Worker com /webhook no fim.
• Em Verify token, cole o código de verificação do passo 5 e salve.
• Assine os campos comments, messages e messaging_postbacks.
• Na linha da sua conta, ligue a assinatura de webhook.
• Clique em Testar na linha messages e peça pro Claude ler o log do Worker, que é o registro do que ele recebeu.

Se o log mostrar "assinatura inválida", a chave gravada é a errada. Foi o que aconteceu comigo: grave de novo a chave secreta do app do Instagram.

Pronto quando: o aviso de teste chegou ao log do Worker sem erro de assinatura.

7. Publique o app

• No app, abra Configurações do app › Básico.
• Preencha o endereço da política de privacidade e o da página de exclusão de dados, e salve.
• Publique o app pelo botão de modo do app no topo do painel.
• Pela 2ª conta, comente a palavra num post seu.

Sem publicar, nenhum comentário chegou ao meu robô, nem o da minha própria conta. Com o app publicado e o acesso padrão, chegaram o comentário e o Direct da 2ª conta, que não tem papel no app. Veja em Perguntas e limites o que a Meta diz sobre a análise do app.

Pronto quando: o comentário da 2ª conta aparece no log, com a palavra achada.

8. Teste com a 2ª conta e ligue

• Peça pro Claude passar o robô pro modo teste, com a 2ª conta na lista de teste, e publicar de novo.
• Pela 2ª conta, comente a palavra num post seu e abra o Direct.
• Toque em Quero o guia sem seguir. Tem que chegar o convite com Já segui.
• Siga a conta principal e toque em Já segui. Tem que chegar o link.
• Volte no post e confira a resposta pública embaixo do comentário.
• Peça pro Claude passar o robô pro modo ligado e publicar.

Pronto quando: a 2ª conta recebeu o link e a resposta pública, e o robô está ligado.

Perguntas e limites

Preciso saber programar?

Não. Você precisa saber o que quer que ele faça e seguir os passos. Quem escreve e testa o código é o Claude Code. O que dá mais trabalho é o painel da Meta: menu em inglês, nome que muda e permissão que não vem marcada.

Quem não segue fica sem o guia?

Não. O convite pra seguir é uma regra minha, e eu decidi assim. Se a pessoa toca em Já segui sem seguir, ele convida de novo uma vez. No toque seguinte, o link vai mesmo assim. Seguir é convite, e não condição.

Preciso passar pela análise do app?

O meu robô funciona sem ela até aqui. A documentação da Meta se contradiz: uma página diz que o acesso padrão é suficiente pra quem só atende a própria conta, e a página de webhooks diz que comentário pede Acesso Avançado.

O Acesso Avançado sai pela análise do app e pede a verificação da empresa. Se os comentários não chegarem com o app publicado, é por aí. Veja a visão geral da Meta e a configuração dos webhooks.

Dá pra fazer sem programar?

Dá. Existem ferramentas prontas de automação de Direct que fazem o mesmo fluxo. Eu não testei nenhuma, então não indico uma. Antes de assinar, confira três coisas: se ela usa a API oficial da Meta, se só responde quem comentou ou escreveu primeiro e se respeita as 24 horas.

O token não vence?

Vence. O token de longa duração vale 60 dias, e o meu robô renova sozinho antes de vencer. Se a renovação falhar, ele me avisa no Telegram, e eu gero um token novo no painel.

O que eu não testei

Não testei o toque no botão com uma conta que nunca mandou Direct: a Meta diz que a leitura do perfil só vale depois que a pessoa manda mensagem. Se a conferência falhar nesse caso, o link vai no toque em Já segui.

Não refiz a criação do app numa conta nova, e o acesso padrão pode não ser suficiente na sua conta. Não testei ferramenta pronta de automação, nem rodei este pedido do zero numa pasta nova. Também não conferi se o meu robô usa o plano grátis ou o pago da Cloudflare.