Novo Módulo - Instagram Feed
Patch Notes - Instagram Feed
Descrição da atualização
Disponibilizamos o módulo Instagram Feed, desenvolvido para integrar o feed do Instagram diretamente na vitrine da loja Magento. Com ele, o lojista exibe automaticamente as imagens mais recentes do seu perfil do Instagram sem precisar atualizar manualmente o conteúdo do site, o próprio módulo sincroniza as imagens e as mantém sempre atualizadas.
O módulo opera de forma automática e transparente: após a configuração inicial, as imagens são buscadas diretamente na API do Instagram, armazenadas localmente e exibidas na loja com o layout escolhido, sem qualquer intervenção manual recorrente.
A solução foi desenvolvida para lojas que utilizam o Instagram como canal de comunicação e desejam aproveitar esse conteúdo para enriquecer a experiência de compra, garantindo:
- Exibição automática e atualizada do feed do Instagram na loja;
- Sincronização diária sem necessidade de ação manual;
- Renovação automática do token de acesso da API;
- Compatibilidade com dois layouts de exibição: carrossel e grade.
O que o módulo faz
- Busca automaticamente as imagens mais recentes do perfil do Instagram via Instagram Graph API, armazenando-as localmente no servidor da loja;
- Exibe as imagens no frontend em dois formatos à escolha do lojista: carrossel (com rolagem automática) ou grade estática;
- Ordena as imagens por data de publicação, exibindo sempre as mais recentes primeiro;
- Salva localmente os arquivos de imagem e seus metadados (legenda, link para o post original, data de publicação);
- Remove automaticamente as imagens que foram apagadas do Instagram, mantendo a exibição sempre sincronizada com o perfil;
- Cada imagem exibida na loja é clicável e redireciona o visitante diretamente para o post original no Instagram;
- Atualiza o feed diariamente de forma automática via agendamento (cron), sem necessidade de ação manual;
- Renova o token de acesso à API do Instagram automaticamente uma vez por mês, evitando interrupções na integração;
- Permite forçar uma atualização manual das imagens diretamente pelo painel administrativo, sem aguardar o agendamento;
- Suporta configuração de limite de imagens exibidas (até 20 por bloco).
Funcionamento
O módulo opera por meio da integração com a Instagram Graph API, seguindo o fluxo abaixo:
1. O agendamento diário (ou a ação manual do lojista) dispara a sincronização;
2. O módulo consulta a API do Instagram utilizando o token configurado e recupera os IDs das mídias do perfil;
3. Compara as mídias retornadas com as já armazenadas no banco de dados da loja;
4. Para cada imagem nova, busca os detalhes (URL, legenda, permalink, data) e realiza o download do arquivo para o servidor;
5. Registra os metadados no banco de dados;
6. Remove do banco e do servidor as imagens que não existem mais no perfil do Instagram;
7. No frontend, as imagens são carregadas a partir do servidor local e exibidas com o template configurado.
O token de acesso é renovado automaticamente todo dia 1º do mês, garantindo que a integração permaneça ativa sem intervenção do lojista.
Onde fica
Sistema → Configuração → Serviços → Instagram Feed
Configurações disponíveis
Habilitado:
Ativa ou desativa todo o funcionamento do módulo. Quando desativado, nenhuma sincronização ocorre e nenhuma imagem é exibida.
Token:
Token de acesso gerado na Instagram Graph API. Necessário para autenticar a conexão com o perfil do Instagram.
Usuário:
Nome de usuário do perfil do Instagram que será exibido na loja (utilizado como título do bloco de imagens).
Id Usuário:
ID numérico da conta de negócios do Instagram. Utilizado internamente para as chamadas à API.
Obter dados do usuário:
Botão que consulta a API e preenche automaticamente os dados do usuário (nome e ID) com base no token informado.
Forçar atualização de imagens:
Botão que dispara imediatamente a sincronização das imagens com o Instagram, sem aguardar o agendamento automático.
Principais vantagens
- Exibição automática e sempre atualizada do conteúdo do Instagram na vitrine da loja;
- Sem necessidade de intervenção manual recorrente após a configuração inicial;
- Renovação automática do token de API, eliminando o risco de interrupção da integração;
- Dois layouts de exibição disponíveis (carrossel e grade), adaptáveis ao design da loja;
- Imagens armazenadas localmente no servidor, garantindo carregamento rápido independente da disponibilidade da API;
- Sincronização inteligente que baixa apenas imagens novas e remove as apagadas do perfil