Como renovar o token de acesso do Instagram

A Meta documenta a regra assim: um token pode ser renovado desde que tenha pelo menos 24 horas desde a última emissão e ainda não tenha passado dos 60 dias de validade. Renovar não reinicia um contador a partir de zero por acaso — o token renovado ganha mais 60 dias contados a partir do momento da renovação, o que na prática permite manter uma conexão viva indefinidamente, desde que a renovação aconteça dentro da janela.

Passar dos 60 dias sem renovar é o ponto sem volta: o token expirado não pode mais ser trocado por um novo, e a integração cai de volta para exigir uma nova autorização OAuth completa.

A conta simplesmente para de aceitar publicações — chamadas que antes funcionavam passam a devolver um erro de autenticação. Para quem opera várias contas de clientes, isso costuma aparecer como um post agendado que silenciosamente não saiu, não como um alerta explícito, a menos que a integração monitore a validade do token de forma proativa.

Você não chama o endpoint de renovação da Meta diretamente. O PostGate expõe o estado da conexão pelo endpoint de saúde do perfil — incluindo expiração do token e a flag reconnect_required — para que o seu produto saiba, com antecedência, quando uma conta precisa de atenção.

Quando o fluxo do provedor permite, a reconexão preserva a identidade durável do perfil dentro do PostGate: o mesmo id de perfil continua valendo depois que o cliente reautoriza a conta, então o seu produto não precisa remapear nada internamente.

Rode uma checagem periódica (diária ou semanal) contra o endpoint de saúde de cada perfil conectado, e avise o cliente com folga antes do vencimento — não no dia em que o token expira. É mais barato pedir uma reconexão tranquila do que explicar depois por que um post agendado não saiu.