EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Por que uma conexão com a API do Instagram para de funcionar e como mantê-la ativa

Uma conexão com a API do Instagram para de funcionar quando a Meta deixa de aceitar o token ou a conta deixa de se qualificar: um token de longa duração não renovado por 60 dias, uma troca de senha, uma permissão ou o app inteiro removido pelo dono, a mudança para uma conta pessoal ou uma restrição na conta. Cada uma retorna um erro próprio, e a maioria é resolvida com o dono fazendo login novamente.

O easyCoexistence monitora cada conexão do Instagram o tempo todo: renova o token bem antes de os 60 dias acabarem, verifica a conta a cada 6 horas, envia um e-mail a você uma vez quando a Meta recusa o acesso e avisa as plataformas com channel.disconnected, então uma conexão caída volta com um único login.

60 days

Tokens do Instagram não renovados em até 60 dias expiram e não podem mais ser renovados.

460

Subcódigo da Graph API, dentro do código 190, para uma sessão encerrada por troca de senha; a pessoa faz login novamente.

1 hour

Das entregas de webhook de mensagens com falha, antes de a Meta desativá-las e cancelar a inscrição do app na conta.

28 days

A Meta pode encerrar o acesso de um app a permissões ou recursos que não foram usados em um período de 28 dias.

6 hours

Com que frequência o easyCoexistence verifica cada conta do Instagram conectada, renovando o token bem antes de os 60 dias acabarem.

Por que uma conexão com a API do Instagram para de funcionar?

Porque a Meta deixa de aceitar o token, ou a conta deixa de se qualificar para a API. A documentação da Meta nomeia as causas, cada uma com o que a API retorna e a etapa que restaura o acesso. A maioria aparece primeiro como uma chamada que falha, por isso as verificações mais abaixo as procuram em uma agenda:

What the API returnsWhat restores it
Token not refreshed for 60 daysCode 190; a refresh is no longer possibleThe owner signs in again
Password changedCode 190 with subcode 460The owner signs in again
Permission missing or removedCode 10, or a code from 200 to 299A new sign-in that grants it
App removed in Instagram's settingsA call to the app's deauthorize callbackA new sign-in, if the owner wants it back
Switched to a personal account(#10) Access is denied because the instagram account type is not business or creator.Back to Business or Creator, then a new sign-in
Allow access to messages offCode 200 with subcode 2534041, on DMsThe owner turns the setting back on
Account restricted, inactive or checkpointedCode 25 with subcode 2207050The owner acts in the Instagram app
Webhook endpoint failing for an hourA Webhooks Disabled alert, the account unsubscribedA working endpoint, then a new subscription

Quando um token expira e quando ainda pode ser renovado?

Com o Instagram Login, um token de longa duração vale 60 dias a partir da última renovação. Uma renovação com grant_type=ig_refresh_token lhe dá mais 60 dias, desde que ele tenha pelo menos 24 horas, não tenha expirado e o dono tenha concedido instagram_business_basic. Passados os 60 dias, as chamadas falham com o código 190 e só um novo login resolve. Com o Unified Login, a configuração define se o token expira.

O que fazem a troca de senha e a permissão removida?

Uma troca de senha pode encerrar a sessão à qual o token pertence: o guia de erros da Graph API da Meta a registra como código 190 com subcódigo 460 e diz que a pessoa precisa fazer login novamente no app. Uma permissão que nunca foi concedida ou foi removida retorna o código 10, ou um código de 200 a 299; em DMs, o código 200 com subcódigo 2534041 significa que o dono desativou o acesso às mensagens. As Políticas da Plataforma da Meta também permitem que ela encerre o acesso de um app a uma permissão ou recurso não usado por 28 dias.

O que acontece quando o dono remove o app?

O acesso dele a dados não públicos termina. O dono remove o app no Instagram em Permissões de sites, Apps e sites, Ativos, e a Meta chama a URL de callback de desautorização salva nas configurações de login comercial do app. A Central de Ajuda do Instagram diz que um app removido só pode acessar as informações públicas da conta a partir de então, por isso a conexão termina até o dono fazer login novamente.

O que acontece quando a conta muda de tipo ou é restringida?

Qualquer uma das duas tira a conta do que a API atende. A API da Meta funciona apenas com contas profissionais, e a tabela de solução de problemas do Unified Login dá a mensagem (#10) Access is denied because the instagram account type is not business or creator para uma conta trocada para pessoal; o dono volta para o tipo profissional e conecta novamente. Uma conta restringida, inativa ou com checkpoint retorna o código 25 com subcódigo 2207050, que o dono resolve no app do Instagram.

Como os webhooks deixam de chegar?

Por meio de um endpoint que falha. A Meta tenta reenviar uma notificação do Instagram por até 36 horas, mas as entregas de mensagens são mais rígidas: após 15 minutos de falhas, um alerta vai para a conta de desenvolvedor, e após uma hora a Meta envia um alerta Webhooks Disabled e cancela a inscrição do app na conta. Quando o endpoint voltar a funcionar, POST /<IG_ID>/subscribed_apps com os mesmos campos reativa as notificações.

Como perceber uma queda antes dos usuários?

Verificando a conexão em uma agenda, em vez de esperar uma publicação falhar:

  • Guarde o expires_in de cada troca e renovação de token e renove bem antes do dia 60, quando o token já tiver um dia.
  • Faça uma chamada autenticada barata em uma agenda, como GET /me?fields=user_id,username, e trate o código 190 ou 102 como necessidade de reconexão.
  • Sirva a URL de callback de desautorização, para que uma remoção nas configurações do Instagram chegue a você imediatamente.
  • Leia os Alertas do Desenvolvedor e o e-mail comercial do app, onde a Meta envia avisos de webhook e de revisão.
  • Registre o código, o subcódigo e o fbtrace_id de cada erro por conta, para que uma restrição se distinga de uma requisição inválida.

Como reconectar cada caso?

A maioria das causas termina na mesma etapa, um novo login feito pelo dono da conta, que emite um novo código e token. As exceções são configurações que o dono altera no app do Instagram:

  • Token expirado, troca de senha, app ou permissão removidos: envie o dono pelo login novamente e deixe que ele aprove as permissões.
  • Conta pessoal: volte para Business ou Creator no app do Instagram e faça login novamente.
  • Mensagens desativadas: ative Permitir acesso às mensagens em Ferramentas conectadas; não é preciso novo login.
  • Conta restringida: conclua o que o app do Instagram pedir; um novo login não resolve nada.
  • Webhooks desativados: corrija o endpoint e depois inscreva a conta novamente.

O que o easyCoexistence faz para manter uma conexão ativa?

Ele monitora cada conta do Instagram conectada o tempo todo. Renova o token assim que restarem menos de 20 dos seus 60 dias, verifica a conta a cada 6 horas com GET /me e marca a conexão para reconexão no momento em que a Meta recusa o token, seja nessa verificação ou em uma chamada de ferramenta. Responde às entregas de webhook da Meta imediatamente e as encaminha depois, e quando o dono remove o app nas configurações do Instagram, o callback de desautorização da Meta encerra a conexão e a tira da cobrança.

Como o easyCoexistence avisa você, e como reconectar?

Uma vez, por e-mail, citando a conta, com um botão para a página do canal; as plataformas também recebem um evento assinado channel.disconnected. Até o dono agir, list_social_accounts mostra o status e o último erro da Meta, e as ferramentas respondem que a conta precisa ser reconectada. Reconectar é um único login com a mesma conta do Instagram, que restabelece a mesma conexão com suas configurações.

Erros comuns

  • Renovar um token somente depois que uma chamada falha. Quando ele já expirou, a Meta recusa a renovação, então agende as renovações enquanto ele ainda é válido.
  • Mandar uma conta restringida de volta pelo login. O código 25 com subcódigo 2207050 é o estado da conta, que o dono corrige no app do Instagram.
  • Deixar o callback de desautorização sem configurar. Uma remoção nas configurações do Instagram então só aparece quando a próxima chamada falha.
  • Corrigir um endpoint que falhou e esperar. Após um alerta Webhooks Disabled, as notificações continuam desligadas até a conta ser inscrita novamente com POST /<IG_ID>/subscribed_apps.
Fazendo isso com o EasyCoexistence

De US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os primeiros 3 dias grátis.

O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.

Perguntas frequentes

Usar um token do Instagram impede que ele expire?

Não. Somente uma renovação estende um token de longa duração, e um token que passa 60 dias sem renovação expira, não importa com que frequência tenha sido usado.

O Instagram remove um app comercial após 90 dias sem uso?

Não. A Central de Ajuda do Instagram diz que apps com permissões para gerenciar contas business e creator não expiram após 90 dias de inatividade.

Uma conta desconectada ainda conta na cobrança do easyCoexistence?

Sim, até você reconectá-la ou removê-la. Uma conta cujo dono removeu o app nas configurações do Instagram sai da contagem assim que a Meta informa a remoção.

Quanto custa o easyCoexistence para monitorar uma conta do Instagram?

O monitoramento vem com cada conexão: de US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os primeiros 3 dias grátis.

Continue lendo

Conecte seu primeiro canal em dois minutos.

Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorado 24/7

Verificado em