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 ainda não tenha expirado. Com o Instagram Login, ao iniciar sessão obtém-se um token de acesso de utilizador do Instagram de curta duração, válido por uma hora, que o servidor da aplicação troca pelo de longa duração.
O easyCoexistence mantém o token do Instagram atualizado por si: renova o acesso antes de os 60 dias terminarem, verifica a conta de 6 em 6 horas e envia-lhe um email quando é preciso voltar a ligar, para que o Claude, o ChatGPT ou o seu próprio código chamem a API oficial da Meta com um token sempre atualizado.
Quanto tempo se mantém válido um token de acesso de utilizador do Instagram de curta duração, obtido no início de sessão.
Quanto tempo é válido um token de longa duração renovado, contado a partir da data da renovação.
Idade mínima de um token de longa duração antes de a Meta o renovar.
Quantas vezes pode ser trocado o código de autorização de um início de sessão; é válido durante 1 hora.
Que token usa o Instagram Login?
Um token de acesso de utilizador do Instagram. Segue o OAuth 2.0, está limitado à aplicação e contém a aplicação, a validade, o ID de utilizador do Instagram da conta e as permissões concedidas; acompanha cada chamada a graph.instagram.com. O Facebook Login usa, em vez disso, tokens de acesso de utilizador ou de Página do Facebook, e o Unified Login usa um token de acesso do Business Integration System User.
Como obtém uma aplicação um token de longa duração?
Em duas trocas após o início de sessão, ambas feitas a partir do servidor. O início de sessão redireciona com um código, válido durante uma hora e utilizável uma só vez. POST https://api.instagram.com/oauth/access_token, com o ID e o segredo da aplicação do Instagram, transforma-o num token de curta duração, no ID de utilizador da conta limitado à aplicação e nas permissões concedidas. GET https://graph.instagram.com/access_token com grant_type=ig_exchange_token e o segredo da aplicação devolve então o token de longa duração, com expires_in em segundos.
Como se renova um token de longa duração?
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 se verificam três condições:
- O token é de longa duração e tem pelo menos 24 horas.
- Não expirou.
- O proprietário da conta concedeu
instagram_business_basic.
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?
Deixa de funcionar de forma definitiva. Um token de longa duração que não seja renovado dentro dos seus 60 dias expira e deixa de poder ser renovado, e as chamadas feitas com ele falham com o erro 190 da Graph API, access token expired. Só há uma forma de voltar atrás: um novo início de sessão feito pelo proprietário da conta, que recomeça a troca.
Porque é que as trocas têm de correr num servidor?
Porque transportam o segredo da aplicação. A Meta indica que os pedidos de tokens de longa duração devem ficar no código do servidor, nunca no código do cliente nem num binário da aplicação que possa ser descompilado, e que o segredo não deve ser partilhado, enviado para um cliente nem guardado num dispositivo.
Como chama o Instagram através da easyCoexistence sem tratar do token?
Através das ferramentas MCP. publish_instagram_post, list_social_posts, list_social_comments, reply_to_comment, hide_comment, send_social_dm e get_social_insights atuam como a conta, e a easyCoexistence acrescenta o token do seu lado. Os tokens do Instagram nunca são entregues (termos da Meta), pelo que get_social_credentials devolve apenas o ID da conta do Instagram e a base da API; o token e a sua renovação ficam com a easyCoexistence.
Erros comuns
- Trocar tokens num browser ou numa aplicação móvel. As chamadas levam o segredo da aplicação, que a Meta indica que deve ficar no código do servidor.
- Renovar um token no primeiro dia. A Meta só renova tokens de longa duração quando têm pelo menos 24 horas.
- Reutilizar um código de autorização. É válido durante uma hora e funciona uma só vez; uma segunda troca é recusada.
- Usar o ID e o segredo da aplicação Meta no Instagram Login. O Business Login for Instagram recebe o ID e o segredo da aplicação do Instagram, nas definições do Instagram do App Dashboard.
De US$ 9 a US$ 0.75 por ligação por mês, com descida à medida que acrescenta ligações, e os primeiros 3 dias grátis.
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.
Quanto tempo é válido o código de autorização do Instagram?
Uma hora, e só pode ser trocado uma vez; uma segunda troca com o mesmo código é recusada.
Que ID e segredo de aplicação usa o Instagram Login?
O ID e o segredo da aplicação do Instagram indicados nas definições do Instagram no App Dashboard. O Business Login for Instagram usa esses, e não o ID e o segredo da própria aplicação Meta, para o URL de início de sessão e as trocas de tokens.
O easyCoexistence renova os tokens do Instagram?
Sim. Renova o acesso antes de expirar, verifica cada conta de 6 em 6 horas e envia um email quando uma precisa de ser ligada de novo.
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