Instagram Graph API: o que as empresas podem e não podem fazer

Toda ferramenta séria do Instagram, de agendadores a automação de DM, se apoia na mesma base: a API do Instagram da Meta, muitas vezes chamada de Instagram Graph API. Saber o que ela pode e não pode fazer evita que você compre ferramentas que prometem o impossível e que gaste semanas construindo algo que a plataforma não permite.

Este guia é para donos de negócio e desenvolvedores. Não precisa de código para acompanhar.

Com quais contas ela funciona

A API funciona com contas profissionais: contas comerciais e de criador. Contas pessoais não têm suporte para publicação, mensagens nem métricas. Mudar uma conta para profissional é grátis e leva um minuto no app do Instagram. Nossa comparação entre conta comercial e de criador mostra qual escolher.

Duas formas de conectar

A Meta oferece dois fluxos de login, e eles levam a versões ligeiramente diferentes da API.

Para a maioria dos criadores e pequenas empresas, o Instagram Login é mais simples: sem Página do Facebook, sem configurar o Business Manager. As ferramentas que o aceitam conectam em poucos cliques.

O que a API permite

Com as permissões certas, um app pode:

• Publicar conteúdo: imagens únicas, carrosséis e reels, inclusive um primeiro comentário logo depois de publicar.
• Ler e gerenciar comentários: listar comentários na sua mídia, responder publicamente e ocultá-los ou excluí-los.
• Enviar e receber DMs: dentro das regras da janela de mensagens de 24 horas, inclusive botões, respostas rápidas e carrosséis de produtos.
• Responder a comentários em particular: uma mensagem por comentário, que é a base da automação de comentário para DM. O Chat33 tenta botões de verdade com o Instagram Login e envia texto simples com o Facebook Login.
• Receber webhooks: notificações em tempo real quando alguém comenta, manda mensagem ou responde ao seu story.
• Ler métricas: métricas da conta e da mídia da sua própria conta.
• Ler o seu próprio perfil e mídia: legendas, URLs de mídia, data e hora e contagens básicas.

Cada recurso corresponde a uma permissão que o dono da conta aprova ao conectar, como instagram_business_basic, instagram_business_manage_messages, instagram_business_manage_comments, instagram_business_content_publish e instagram_business_manage_insights.

Se a parte de que você precisa é a de mensagens, o guia da API de DM do Instagram cobre o envio e a automação de DMs em detalhe.

O que ela nunca vai fazer

Igualmente importante, e a origem da maior parte do marketing enganoso:

• Sem DMs a frio. Um app não pode iniciar uma conversa com alguém que não interagiu com você.
• Sem seguir, deixar de seguir nem curtir em seu nome.
• Sem acesso a dados privados de outras contas, como a lista de seguidores ou as DMs de outra pessoa.
• Sem contas pessoais.
• Sem burlar limites, como o número de publicações que uma conta pode publicar pela API em 24 horas (100 na data em que escrevemos).

Se uma ferramenta oferece qualquer um dos quatro primeiros, ela não usa a API oficial. Está entrando como você, e é exatamente isso que faz as contas serem restringidas. O artigo sobre as regras da automação explica a diferença.

Análise de apps: por que as ferramentas demoram a lançar recursos

Um app pode usar qualquer permissão em contas que tenham uma função no app, como os próprios desenvolvedores e testadores. Para usar uma permissão nas contas de todo o resto do mundo, o app precisa de acesso avançado, o que significa passar pela análise de apps da Meta para essa permissão.

A análise de apps pede uma demonstração funcionando, uma gravação de tela de cada permissão em uso e uma explicação de por que o app precisa dela. As análises podem levar dias ou semanas, e as recusas são comuns na primeira tentativa.

Para uma empresa que avalia ferramentas, isso importa: um recurso que a ferramenta mostra numa demonstração só está disponível para você se o app foi aprovado para a permissão por trás dele.

Tokens e conexões

Quando você conecta uma conta, o app recebe um token de acesso. O Instagram Login emite tokens de longa duração que valem cerca de 60 dias e podem ser renovados enquanto ainda forem válidos. Um app bem feito os renova em segundo plano.

Uma conexão ainda pode quebrar: se você muda a senha, remove o app nas configurações do Instagram ou o token expira sem ser renovado. Quando isso acontece, reconectar a restaura; as automações e configurações na ferramenta costumam ser mantidas.

Construindo por conta própria

Se você é desenvolvedor e está pensando numa integração direta, planeje:

1. Um app de desenvolvedor da Meta com o produto Instagram adicionado.
2. Infraestrutura de webhooks que verifica assinaturas e responde rápido.
3. Armazenamento e renovação de tokens, criptografados em repouso.
4. Análise de apps para cada permissão de que você precisa em contas de clientes.
5. Manutenção contínua, porque a API tem versões e as mais antigas são desativadas num cronograma.

É perfeitamente possível, e também são várias semanas de trabalho antes de o primeiro cliente se beneficiar. Para muitas equipes, usar uma ferramenta que já fez isso é o caminho mais rápido.

Automação do Instagram no Chat33

Conecte pelo Instagram Login e tenha DMs por palavra-chave, comentário para DM e automação de resposta a stories na API oficial.