Instagram: contas e tokens
Exiba o feed do Instagram em uma grade — tokens por conta, renovação automática, cache e opções do widget.
Nesta página
O widget Instagram exibe as publicações recentes de uma conta profissional conectada ao seu site.
Conectando contas
Em Converto → Integrações → Instagram, em Contas do Instagram, adicione um item por conta:
| Campo | O que informar |
|---|---|
| Rótulo | Nome para identificar a conta no painel (não precisa ser o @usuário). |
| Access Token | Token de acesso da conta (formato IGAA…), gerado pelo login do Instagram no painel de desenvolvedor da Meta. |
Use Add Conta para incluir outra conta e Delete Conta para remover a atual.
Cada token é vinculado a uma conta profissional. As contas ficam disponíveis no seletor do widget.
Renovação automática do token
Tokens do Instagram duram cerca de 60 dias. O Converto roda uma tarefa diária que renova todo token que está a menos de 10 dias de expirar (ou cuja validade é desconhecida) e grava o novo token no lugar do antigo. Tokens com menos de 24 horas não podem ser renovados pela API; a tentativa é repetida no dia seguinte.
Cache e carregamento
- O feed é carregado do Instagram e guardado por 30 minutos.
- Um endpoint de leitura do tema entrega as publicações em páginas (padrão 10 por vez, no máximo 50); o token nunca é exposto ao navegador.
- Contas não cadastradas no painel recebem resposta "Conta do Instagram não reconhecida".
No editor
No widget, o botão Sincronizar contas renova tokens perto de expirar, busca novamente as contas na API e recarrega o editor ao terminar. Depois, escolha a Conta, a Quantidade de linhas (1 a 4) e a ação ao clicar (Ir para Instagram ou Não fazer nada). Veja Instagram (widget).
Problemas comuns
| Sintoma | Solução |
|---|---|
| "Não foi possível carregar o feed do Instagram." | Token inválido ou expirado: gere um novo e salve. |
| Conta não aparece no seletor | Salve o token e use Sincronizar contas no widget. |
| Feed não atualiza | O cache dura 30 minutos; aguarde esse tempo. |