Como usar a plataforma

Playbook operacional de automação para Instagram. Escrito a partir de uma implantação real, com as armadilhas que apareceram no caminho.

A plataforma conecta uma conta profissional do Instagram a um painel de atendimento. Com ela você responde mensagens, cria respostas automáticas, reage a comentários em publicações e organiza contatos com etiquetas e campos próprios.

A lógica é sempre a mesma: alguma coisa acontece (a pessoa comenta, manda mensagem, escreve uma palavra) e a plataforma responde (manda um direct, aplica uma etiqueta, chama um atendente). Entender esse par é o suficiente para montar quase tudo.

Conectar o Instagram

A conexão tem duas frentes: preparar a conta no Instagram e criar um aplicativo no painel de desenvolvedores da Meta. O aplicativo é o intermediário que permite a plataforma ler comentários e enviar mensagens em nome do perfil.

Passo a passo

1. Deixe a conta como Comercial. No app do Instagram: Configurações e privacidade, Tipo de conta e ferramentas, Mudar para conta profissional, e escolha Comercial. Não precisa conectar uma Página do Facebook.
2. Crie o aplicativo em developers.facebook.com, com a opção "Gerenciar mensagens e conteúdo no Instagram". Essa escolha define todo o resto do processo.
3. Pegue as credenciais em Instagram, Configuração da API com login do Instagram, Configurar o login empresarial do Instagram. Ali aparecem o ID e a chave secreta.
4. Cadastre a URL de redirecionamento que a plataforma informa, na mesma tela das credenciais.
5. Configure o webhook com a URL e o token que a plataforma fornece. É por ele que os comentários e mensagens chegam.
6. Adicione as contas como testadoras em Funções do app, Funções, Testadores do Instagram. Cada pessoa aceita o convite no próprio celular, em Configurações, Apps e sites, Convites de testador.
7. Publique o aplicativo. Sem isso as mensagens não chegam. Veja o alerta abaixo.
8. Conecte a conta na plataforma, escolhendo a opção de login pelo Instagram.

Armadilhas da conexão

Todas as quatro abaixo aconteceram de verdade. Nenhuma delas mostra mensagem de erro clara, o que faz perder horas.

Conta de Criador de conteúdo não funciona

Você autoriza, clica em Permitir e a tela volta para a escolha de canal sem dizer nada. Parece falha da plataforma.

O Instagram devolve o tipo MEDIA_CREATOR para contas de Criador, e a plataforma aceita apenas BUSINESS e CREATOR. A solução é usar conta Comercial. Para automação de mensagens, Comercial é o tipo adequado de qualquer forma.

Existem dois App ID diferentes

A Meta mostra um ID na tela inicial do aplicativo e outro ID dentro da configuração do Instagram. São números distintos.

Para o login pelo Instagram vale o segundo, que fica em Configurar o login empresarial do Instagram. Usar o da tela inicial faz o processo de autorização falhar.

O aplicativo precisa estar publicado

Em modo de desenvolvimento, a Meta não entrega as mensagens de quem não tem função no aplicativo. O efeito é cruel: confirmações de leitura chegam, então tudo parece configurado, mas nenhuma mensagem aparece.

Publicar resolve na hora. Publicar não é a análise do aplicativo, é só uma chave que você liga. Para liberar, a Meta pede política de privacidade, termos de serviço, instruções de exclusão de dados, domínio e ícone.

A análise do aplicativo costuma ser dispensável

Quando o aplicativo atende apenas contas que você mesmo possui ou administra, o acesso padrão basta e não há análise nenhuma. A própria Meta avisa isso na etapa 5.

A análise passa a ser obrigatória em um caso: quando você conecta contas de terceiros, ou seja, quando isso vira serviço prestado a clientes. Aí entra também a verificação do negócio.

O que cada peça faz

Como combinar

As peças isoladas resolvem pouco. O valor aparece no encadeamento.

Comentário para etiqueta para sequência

Alguém comenta uma palavra e recebe o material no direct. A automação aplica a etiqueta "interessado". Um gatilho enxerga a etiqueta e inscreve a pessoa numa sequência que manda uma segunda mensagem no dia seguinte. É a esteira de captação completa e roda sozinha.

Palavra-chave para campo para condição

A pessoa escreve "orçamento" e o fluxo pergunta a cidade. A resposta vai para um campo personalizado. Um bloco de condição olha o campo e manda uma mensagem diferente para cada região.

Bot para humano

O fluxo resolve as perguntas comuns. Quando a pessoa pede para falar com alguém, ou quando a IA não entende duas vezes seguidas, a conversa é atribuída a um atendente e aparece na caixa de entrada.

Receita: comentário vira direct

A automação mais usada. A pessoa comenta uma palavra combinada na publicação e recebe no privado o link, o material ou a instrução.

1. Abra a área de automação de comentários e crie uma automação.
2. Dê um nome que você reconheça depois, como "post do curso, palavra AULA".
3. Em onde vale, escolha entre todas as publicações ou uma específica. Publicação específica é melhor quando cada post tem uma oferta.
4. Em resposta no direct, escolha mensagem de texto e escreva o que a pessoa vai receber.
5. Em responder a, escolha contém e adicione a palavra que aciona.
6. Ligue a opção de responder só uma vez por pessoa em cada post. Sem isso, quem comentar três vezes recebe três mensagens.
7. Se quiser, ligue também a resposta pública, algo como "te mandei no direct". Isso mostra para os outros que a automação funciona e puxa mais comentários.
8. Salve e teste comentando de outra conta.

Receita: palavra-chave no direct

Responde automaticamente quem manda mensagem com um termo específico.

1. Monte antes o fluxo com a resposta, ou escolha responder com texto simples.
2. Vá em Palavras-chave e crie uma resposta automática.
3. Adicione as variações que as pessoas realmente escrevem: preço, valor, quanto custa, orçamento.
4. Aponte para o fluxo ou escreva o texto.
5. Teste mandando cada variação de outra conta.

Vale revisar essa lista depois de duas semanas. A caixa de entrada mostra o que as pessoas perguntam de um jeito que você não previu.

Receita: menu de atendimento

Quem manda a primeira mensagem recebe opções em vez de texto corrido.

1. Crie um fluxo com um bloco de mensagem.
2. Escreva uma saudação curta e adicione botões, um para cada assunto.
3. Ligue cada botão a um bloco diferente, com a resposta daquele assunto.
4. Deixe um botão para falar com uma pessoa, que atribui a conversa a um atendente.
5. Publique o fluxo e ligue ele à resposta padrão do espaço de trabalho.

Três ou quatro botões costumam funcionar melhor que uma lista longa. Se um assunto quase não é clicado, tire.

Receita: sequência de follow-up

Para quem demonstrou interesse e parou de responder.

1. Crie uma sequência e dê o nome do objetivo dela.
2. Adicione a primeira mensagem com intervalo de um dia.
3. Adicione a segunda com intervalo de três dias, com abordagem diferente da primeira.
4. Ligue a opção de sair ao responder, para parar de cobrar quem já voltou.
5. Defina o horário de envio, evitando madrugada.
6. Inscreva na sequência por gatilho, quando a etiqueta de interesse for aplicada.

Receita: passar para humano

1. No fluxo, adicione a ação de passar conversa para atendente.
2. Coloque essa ação atrás de um botão claro, e também depois de duas tentativas frustradas da IA.
3. Configure a atribuição automática, ou escolha a pessoa responsável.
4. Avise no texto que alguém vai responder, e em quanto tempo.

Enquanto a conversa está com um atendente, o bot para de responder. Ele volta quando a conversa é devolvida para o bot.

O que não dá para fazer

Mandar mensagem para quem começou a seguir

O Instagram informa quantos seguidores a conta tem, nunca quem são. Não existe endereço na API que devolva a lista, e não existe aviso de novo seguidor. Sem saber quem seguiu, não há para quem escrever.

Ferramentas que anunciam esse recurso usam um acesso que a Meta libera caso a caso para parceiros comerciais, em fase de testes e com limite de uma mensagem por pessoa por semana. Não é algo que se resolva programando melhor.

O caminho que funciona é fazer a pessoa iniciar: peça o comentário na legenda, use resposta a story, ou coloque o link direto de conversa na biografia.

Enviar mensagem para quem nunca interagiu

Não existe envio frio no Instagram. A conversa sempre começa por uma ação da pessoa.

Automatizar curtida e seguir

A API cobre mensagens e comentários. Curtir perfis, seguir pessoas e postar em nome de terceiros não fazem parte, e ferramentas que prometem isso costumam usar automação de navegador, o que arrisca o bloqueio da conta.

Desenhar fluxo por comando

O desenho do fluxo, com blocos e ligações, é feito no editor visual. A API lista e dispara fluxos, mas não monta o desenho. Detalhes na seção do Claude Code.

Janelas de mensagem

Esta tabela explica a maioria das mensagens recusadas.

Cada mensagem nova da pessoa reinicia as 24 horas. É por isso que fluxos com pergunta funcionam melhor que fluxos que só informam: a resposta dela mantém a conversa aberta.

Conectar o Claude Code

A plataforma expõe um servidor MCP, o mesmo protocolo que o Claude Code usa para ganhar ferramentas novas. Conectado, ele passa a operar a plataforma por comando em português.

Como conectar

1. Pegue o token em Configurações, Integrações, Token do espaço de trabalho. Clique em Gerar e depois em Salvar.
2. Rode o comando abaixo no terminal, trocando o token e o endereço pelos seus.
3. Confira com claude mcp list. O servidor precisa aparecer sem aviso de autenticação pendente.

claude mcp add automacao -t sse -s user \
  -H "x-workspace-token: SEU_TOKEN_AQUI" \
  https://ENDERECO_DO_SERVIDOR_MCP/sse

O que dá para pedir

Coisas do tipo "lista os fluxos", "cria uma etiqueta chamada Lead Quente", "quantos contatos entraram esta semana", "mostra os erros de ontem", "aplica a etiqueta X em quem tem o campo cidade igual a Campinas".

Onde usar IA, onde ir na mão

Uma regra prática: o que é estrutura se faz na tela, o que é volume ou consulta se pede para a IA.

Perguntas frequentes