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.
Tokens do Instagram não renovados em 60 dias expiram e deixam de poder ser renovados.
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.
De entregas falhadas de webhooks de mensagens, antes de a Meta os desativar e cancelar a subscrição da aplicação na conta.
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.
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 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 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_inde 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_idde 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.
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