EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Tokens de acesso do Instagram: tokens de longa duração, 60 dias e renovação

Um token de acesso de longa duração do Instagram é válido por 60 dias e pode ser renovado por mais 60, desde que tenha pelo menos 24 horas e não tenha expirado. Com o Instagram Login, o login gera um token de acesso de usuário do Instagram de curta duração, válido por uma hora, que o servidor do app troca pelo de longa duração.

O easyCoexistence mantém o token do Instagram atualizado para você: renova o acesso antes que os 60 dias terminem, verifica a conta a cada 6 horas e envia um e-mail quando é preciso reconectar, para que Claude, ChatGPT ou seu próprio código chamem a API oficial da Meta com um token sempre atual.

1 hour

Por quanto tempo um token de acesso de usuário do Instagram de curta duração, obtido no login, permanece válido.

60 days

Por quanto tempo um token de longa duração renovado fica válido, contado a partir da data da renovação.

24 hours

Idade mínima de um token de longa duração para que a Meta aceite renová-lo.

Once

Quantas vezes o código de autorização de um login pode ser trocado; ele é válido por 1 hora.

Qual token o Instagram Login usa?

Um token de acesso de usuário do Instagram. Segue o OAuth 2.0, é restrito ao app, e contém o app, a data de expiração, o ID de usuário do Instagram da conta e as permissões concedidas; ele acompanha cada chamada feita a graph.instagram.com. O Facebook Login usa tokens de acesso de Usuário ou Página do Facebook, e o Unified Login, um token de acesso de System User do Business Integration.

Como um app obtém um token de longa duração?

Em duas trocas após o login, ambas feitas no servidor. O login redireciona com um código, válido por uma hora e utilizável uma única vez. POST https://api.instagram.com/oauth/access_token, com o ID e a chave secreta do app do Instagram, o converte em um token de curta duração, no ID de usuário da conta restrito ao app e nas permissões concedidas. GET https://graph.instagram.com/access_token com grant_type=ig_exchange_token e a chave secreta do app então retorna o token de longa duração, com expires_in em segundos.

1LoginRedirect with a code, valid 1 hour, usable once
2Short-lived tokenFrom api.instagram.com/oauth/access_token, valid 1 hour
3Long-lived tokenFrom graph.instagram.com/access_token, valid 60 days
4RefreshFrom graph.instagram.com/refresh_access_token, 60 more days

Como um token de longa duração é renovado?

Com GET https://graph.instagram.com/refresh_access_token, grant_type=ig_refresh_token e o token de longa duração atual. A resposta traz um token válido por 60 dias a partir da renovação. A Meta só renova quando três condições são atendidas:

  • O token é de longa duração e tem pelo menos 24 horas de idade.
  • Ele não expirou.
  • O titular da conta concedeu instagram_business_basic.
Refreshing a long-lived token
GET https://graph.instagram.com/refresh_access_token
  ?grant_type=ig_refresh_token
  &access_token=<LONG_LIVED_TOKEN>

{
  "access_token": "<NEW_LONG_LIVED_TOKEN>",
  "token_type": "bearer",
  "expires_in": 5183944
}

O que acontece quando um token expira?

Ele deixa de funcionar de vez. Um token de longa duração que não é renovado dentro de seus 60 dias expira e não pode mais ser renovado, e as chamadas feitas com ele falham com o erro 190 da Graph API, access token expired. A única saída é um novo login feito pelo titular da conta, que reinicia a troca.

Por que as trocas precisam rodar em um servidor?

Porque elas carregam a chave secreta do app. A Meta diz que as requisições de tokens de longa duração devem ficar em código do lado do servidor, nunca em código do cliente ou em um binário do app que possa ser descompilado, e que a chave secreta não deve ser compartilhada, enviada a um cliente nem armazenada em um dispositivo.

Como chamar o Instagram pelo easyCoexistence sem lidar com o token?

Pelas ferramentas MCP. publish_instagram_post, list_social_posts, list_social_comments, reply_to_comment, hide_comment, send_social_dm e get_social_insights agem como a conta, e o easyCoexistence adiciona o token do lado dele. Os tokens do Instagram nunca são entregues (termos da Meta), então get_social_credentials retorna apenas o ID da conta do Instagram e a base da API; o token e a sua renovação ficam com o easyCoexistence.

Erros comuns

  • Trocar tokens em um navegador ou app mobile. As chamadas levam a chave secreta do app, que a Meta diz que deve ficar em código do servidor.
  • Renovar um token no primeiro dia. A Meta só renova tokens de longa duração quando eles têm pelo menos 24 horas.
  • Reutilizar um código de autorização. Ele é válido por uma hora e funciona uma única vez; uma segunda troca é recusada.
  • Usar o ID e a chave secreta do app da Meta no Instagram Login. O Business Login for Instagram usa o ID e a chave secreta do app do Instagram, nas configurações do Instagram no App Dashboard.
Fazendo isso com o EasyCoexistence

De US$ 9 a US$ 0.75 por conexão por mês, com redução conforme você adiciona conexões, e os primeiros 3 dias são 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

Quanto tempo dura um token de acesso do Instagram?

Um token de curta duração dura uma hora. Um de longa duração dura 60 dias e pode ser renovado por mais 60.

Por quanto tempo vale o código de autorização do Instagram?

Uma hora, e ele só pode ser trocado uma vez; uma segunda troca com o mesmo código é recusada.

Qual ID e chave secreta o Instagram Login usa?

O ID e a chave secreta do app do Instagram exibidos nas configurações do Instagram no App Dashboard. O Business Login for Instagram usa esses, e não o ID e a chave secreta do app da própria Meta, para a URL de login e para as trocas de tokens.

O easyCoexistence renova tokens do Instagram?

Sim. Ele renova o acesso antes da expiração, verifica cada conta a cada 6 horas e envia um e-mail quando alguma precisa ser reconectada.

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