Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Porque deixa de funcionar uma ligação à API do Instagram, e como a manter ativa

Uma ligação à API do Instagram deixa de funcionar quando a Meta deixa de aceitar o seu token ou quando a conta deixa de cumprir os requisitos: um token de longa duração não renovado durante 60 dias, uma alteração da palavra-passe, uma permissão ou a aplicação inteira removida pelo proprietário, a mudança para uma conta pessoal, ou uma restrição na conta. Cada caso devolve um erro próprio, e a maioria resolve-se com o proprietário a voltar a iniciar sessão.

A easyCoexistence vigia cada ligação ao Instagram em permanência: renova o token bem antes de os 60 dias terminarem, verifica a conta de 6 em 6 horas, envia-lhe um email uma só vez quando a Meta recusa o acesso e envia às plataformas o evento channel.disconnected, para que uma ligação interrompida volte com um único início de sessão.

60 days

Tokens do Instagram não renovados em 60 dias expiram e deixam de poder ser renovados.

460

Subcódigo da Graph API, sob o código 190, para uma sessão terminada por uma alteração da palavra-passe; a pessoa volta a iniciar sessão.

1 hour

De entregas falhadas de webhooks de mensagens, antes de a Meta os desativar e cancelar a subscrição da aplicação na conta.

28 days

A Meta pode terminar o acesso de uma aplicação a permissões ou funcionalidades que não tenha usado durante um período de 28 dias.

6 hours

Frequência com que a easyCoexistence verifica cada conta do Instagram ligada, renovando o token bem antes de os 60 dias terminarem.

Porque deixa de funcionar uma ligação à API do Instagram?

Porque a Meta deixa de aceitar o token, ou porque a conta deixa de poder usar a API. A documentação da Meta indica as causas, cada uma com o que a API devolve e o passo que restabelece o acesso. A maioria surge primeiro como uma chamada falhada, razão pela qual as verificações abaixo as procuram de forma agendada:

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 expira um token, e quando ainda pode ser renovado?

Com o Instagram Login, um token de longa duração dura 60 dias desde a última renovação. Uma renovação com grant_type=ig_refresh_token concede mais 60 dias, desde que tenha pelo menos 24 horas, não tenha expirado e o proprietário tenha concedido instagram_business_basic. Passados os 60 dias, as chamadas falham com o código 190 e só um novo início de sessão resolve. Com o Unified Login, a configuração define se o token chega a expirar.

O que fazem uma alteração da palavra-passe e uma permissão removida?

Uma alteração da palavra-passe pode terminar a sessão a que o token pertence: o guia de erros da Graph API da Meta indica-a como código 190 com subcódigo 460 e diz que a pessoa tem de voltar a iniciar sessão na aplicação. Uma permissão que nunca foi concedida ou que foi removida devolve o código 10, ou um código entre 200 e 299; nas mensagens diretas, o código 200 com subcódigo 2534041 significa que o proprietário desativou o acesso às mensagens. Os Termos da Plataforma da Meta também permitem que esta termine o acesso de uma aplicação a uma permissão ou funcionalidade não utilizada durante 28 dias.

O que acontece quando o proprietário remove a aplicação?

O acesso dela a dados não públicos termina. O proprietário remove a aplicação no Instagram em Permissões de sites Web, Aplicações e sites, Ativas, e a Meta chama o URL de callback de desautorização guardado nas definições de login empresarial da aplicação. O Centro de Ajuda do Instagram diz que, a partir daí, uma aplicação removida só pode aceder às informações públicas da conta, pelo que a ligação fica encerrada até o proprietário voltar a iniciar sessão.

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

Qualquer das duas situações retira a conta do que a API serve. A API da Meta só funciona com contas profissionais, e a tabela de resolução de problemas do Unified Login indica a mensagem (#10) Access is denied because the instagram account type is not business or creator para uma conta passada para pessoal; o proprietário volta a mudar a conta e depois volta a ligá-la. Uma conta restringida, inativa ou sujeita a verificação de segurança devolve o código 25 com subcódigo 2207050, que o proprietário resolve na aplicação do Instagram.

Como deixam de chegar os webhooks?

Através de um endpoint com falhas. A Meta volta a tentar uma notificação do Instagram durante até 36 horas, mas as entregas de mensagens são mais exigentes: ao fim de 15 minutos de falhas, um alerta vai para a conta de programador, e ao fim de uma hora a Meta envia um alerta Webhooks Disabled e cancela a subscrição da aplicação na conta. Assim que o endpoint voltar a funcionar, POST /<IG_ID>/subscribed_apps com os mesmos campos volta a ativar as notificações.

Como se deteta uma interrupção antes dos utilizadores?

Através da verificação da ligação de forma agendada, em vez de esperar que uma publicação falhe:

  • Guardar o expires_in de cada troca e renovação de token bem antes do dia 60, assim que o token tiver um dia.
  • Fazer uma chamada autenticada barata de forma agendada, como GET /me?fields=user_id,username, e tratar o código 190 ou 102 como sinal de reconexão.
  • Disponibilizar o URL de callback de desautorização, para que uma remoção nas definições do Instagram chegue de imediato.
  • Ler os Alertas do programador e o email empresarial da aplicação, onde a Meta envia avisos de webhooks e de revisão.
  • Registar o código, o subcódigo e o fbtrace_id de cada erro por conta, para que uma restrição se distinga de um pedido inválido.

Como se volta a ligar cada caso?

A maioria das causas termina no mesmo passo, um novo início de sessão pelo proprietário da conta, que emite um código e um token novos. As exceções são as definições que o proprietário altera na aplicação do Instagram:

  • Token expirado, alteração da palavra-passe, aplicação ou permissão removida: encaminhar o proprietário de novo para o início de sessão e deixá-lo aprovar as permissões.
  • Conta pessoal: voltar a mudar para Empresa ou Criador de conteúdos na aplicação do Instagram e depois iniciar sessão de novo.
  • Mensagens desativadas: ativar Permitir acesso às mensagens em Ferramentas ligadas; não é preciso um novo início de sessão.
  • Conta restringida: concluir o que a aplicação do Instagram pede; um novo início de sessão não muda nada.
  • Webhooks desativados: corrigir o endpoint e depois voltar a subscrever a conta.

O que faz a easyCoexistence para manter uma ligação ativa?

Vigia cada conta do Instagram ligada em permanência. Renova o token assim que restarem menos de 20 dos seus 60 dias, verifica a conta de 6 em 6 horas com GET /me, e marca a ligação como pendente de reconexão no momento em que a Meta recusa o token, quer nessa verificação quer numa chamada de ferramenta. Responde de imediato às entregas de webhooks da Meta e encaminha-as depois. Quando o proprietário remove a aplicação nas definições do Instagram, o callback de desautorização da Meta termina a ligação e retira-a da faturação.

Como a easyCoexistence avisa, e como se volta a ligar?

Uma vez, por email, indicando a conta, com um botão para a página do canal; as plataformas recebem também um evento channel.disconnected assinado. Enquanto o proprietário não agir, list_social_accounts mostra o estado e o último erro da Meta, e as ferramentas respondem que a conta precisa de ser ligada de novo. Voltar a ligar é um único início de sessão com a mesma conta do Instagram, que restabelece a mesma ligação com as suas definições.

Erros comuns

  • Renovar um token só depois de uma chamada falhar. Depois de expirado, a Meta recusa a renovação, por isso agende as renovações enquanto ainda é válido.
  • Enviar uma conta restringida de volta pelo início de sessão. O código 25 com subcódigo 2207050 é o estado da conta, que o proprietário corrige na aplicação do Instagram.
  • Deixar o URL de callback de desautorização por definir. Uma remoção nas definições do Instagram só aparece quando a chamada seguinte falha.
  • Corrigir um endpoint com falhas e esperar. Após um alerta Webhooks Disabled, as notificações ficam desligadas até a conta ser subscrita de novo com POST /<IG_ID>/subscribed_apps.
Fazer isto com a EasyCoexistence

De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias grátis.

Perguntas frequentes

Usar um token do Instagram impede-o de expirar?

Não. Só uma renovação prolonga um token de longa duração, e um que passe 60 dias sem renovação expira, por muito que tenha sido usado.

O Instagram remove uma aplicação empresarial após 90 dias sem uso?

Não. O Centro de Ajuda do Instagram diz que as aplicações com permissões para gerir contas empresariais e de criador de conteúdos não expiram após 90 dias de inatividade.

Uma conta desligada continua a contar na fatura da easyCoexistence?

Sim, até a voltar a ligar ou a remover. Uma conta cujo proprietário removeu a aplicação nas definições do Instagram sai da contagem assim que a Meta comunica a remoção.

Quanto custa monitorizar uma conta do Instagram com a easyCoexistence?

A monitorização vem incluída em cada ligação: de US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias grátis.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

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

Verificado em