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.
Tokens do Instagram não renovados em até 60 dias expiram e não podem mais ser renovados.
Subcódigo da Graph API, dentro do código 190, para uma sessão encerrada por troca de senha; a pessoa faz login novamente.
Das entregas de webhook de mensagens com falha, antes de a Meta desativá-las e cancelar a inscrição do app na conta.
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.
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 returns | What restores it | |
|---|---|---|
| Token not refreshed for 60 days | Code 190; a refresh is no longer possible | The owner signs in again |
| Password changed | Code 190 with subcode 460 | The owner signs in again |
| Permission missing or removed | Code 10, or a code from 200 to 299 | A new sign-in that grants it |
| App removed in Instagram's settings | A call to the app's deauthorize callback | A 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 off | Code 200 with subcode 2534041, on DMs | The owner turns the setting back on |
| Account restricted, inactive or checkpointed | Code 25 with subcode 2207050 | The owner acts in the Instagram app |
| Webhook endpoint failing for an hour | A Webhooks Disabled alert, the account unsubscribed | A 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_inde 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_idde 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.
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