- O Instagram Feed exibe as últimas fotos do perfil do Instagram da sua loja diretamente na vitrine, em carrossel ou em grade.
- As imagens são sincronizadas automaticamente todo dia e cada foto leva o visitante ao post original no Instagram.
- Para funcionar, o módulo precisa de um token de acesso, gerado gratuitamente no painel de desenvolvedores da Meta — este guia mostra o processo completo, do início ao fim.
- Ajuda a transformar visitantes da loja em seguidores e a manter a página com conteúdo sempre atualizado.
Passo a Passo por Escrito
A configuração tem duas partes: primeiro você cria um aplicativo no painel da Meta e gera o token de acesso (passos 1 a 8); depois configura o módulo dentro da sua loja (passos 9 a 15).
A Meta atualiza a interface do painel de desenvolvedores com frequência. Se alguma tela estiver diferente do descrito aqui, procure a opção de nome mais parecido. Em caso de dúvida ou erro durante os passos no painel da Meta, acione primeiro o suporte da Meta (Central de Ajuda do painel de desenvolvedores); se não conseguir avançar, entre em contato com o nosso suporte.
1. Prepare as contas necessárias
Antes de começar, confirme que você possui:
- Uma conta do Instagram profissional (tipo Empresa ou Criador de conteúdo) — é o perfil cujas fotos serão exibidas na loja. Se sua conta ainda é pessoal, altere em Configurações → Tipo de conta dentro do próprio Instagram.
- Uma conta do Facebook com acesso a um portfólio empresarial (Meta Business), de preferência já verificado.
Sem uma conta do Instagram profissional vinculada a um portfólio empresarial, a Meta não permite gerar o token de acesso e o feed não funciona.
Resultado esperado: Conta do Instagram no modo profissional e conta do Facebook com portfólio empresarial prontas para uso.
2. Crie o aplicativo no painel da Meta
Acesse developers.facebook.com e faça login com a conta do Facebook da loja. No menu superior, clique em Meus Apps e depois em Criar aplicativo.
Preencha o nome do aplicativo (ex: o nome da sua loja) e o e-mail de contato.
Durante o processo, a Meta pode pedir sua senha novamente e um código de verificação em duas etapas. Tenha o celular vinculado à conta por perto.
Resultado esperado: A tela de criação do aplicativo avança para a escolha do caso de uso.
3. Selecione o caso de uso do Instagram
Na etapa de casos de uso, selecione a opção Gerenciar mensagens e conteúdo do Instagram e clique em Avançar.
Em seguida, vincule o seu portfólio empresarial ao aplicativo, avance pelas etapas seguintes (não é necessário marcar requisitos adicionais) e finalize a criação do aplicativo.
Não selecione outros casos de uso mais antigos relacionados ao Instagram — eles estão sendo descontinuados pela Meta e deixarão de funcionar.
Resultado esperado: O aplicativo é criado e o painel do app é exibido.
4. Adicione sua conta do Instagram como testadora
No painel do aplicativo, acesse Funções do app → Funções. Clique em Adicionar pessoas, selecione a opção Testador do Instagram e informe o usuário do Instagram da loja (a conta cujas fotos serão exibidas). Clique em Adicionar.
O convite ficará com o status pendente até ser aceito dentro do Instagram — é o próximo passo.
Resultado esperado: O usuário do Instagram aparece na lista de testadores com o status pendente.
5. Aceite o convite dentro do Instagram
Acesse o Instagram com a conta da loja (pelo navegador ou aplicativo). Vá em Configurações → Apps e sites → Convites do testador e clique em Aceitar no convite do aplicativo que você criou.
Resultado esperado: De volta ao painel da Meta, o usuário aparece como testador ativo (sem o status pendente).
6. Configure o domínio e as políticas do aplicativo
No painel do aplicativo, acesse Configurações do app → Básico. Role até o final da página e clique em Adicionar plataforma, selecione Website e informe o endereço da sua loja começando com https://.
Na parte superior da mesma tela, preencha:
- URL da Política de Privacidade — o link da página de política de privacidade da sua loja.
- URL de exclusão de dados — selecione a opção de informar uma URL e use o mesmo link da política de privacidade.
Clique em Salvar alterações.
O ideal é que sua loja tenha uma página de política de privacidade publicada. Se ainda não tiver, é possível usar temporariamente a URL da própria loja, mas recomendamos criar a página o quanto antes.
Resultado esperado: As configurações são salvas sem mensagens de erro e a plataforma Website aparece cadastrada.
7. Gere o token de acesso
No menu lateral esquerdo do painel do aplicativo, acesse Publicar de depois Gerenciar mensagens e conteúdo do Instagram e clice no menu Configuração da API com Login do Instagram.
Na seção Gerar tokens de acesso, localize a conta do Instagram vinculada (adicionada como testadora no passo 4), marque-a e clique em Gerar token. A Meta pedirá para você fazer login na conta do Instagram da loja e autorizar o acesso.
Na tela de permissões, mantenha somente a permissão de acesso ao conteúdo do perfil (Acessar e publicar conteúdos) — as permissões de mensagens e comentários não são necessárias para o feed.
Copie o token gerado e guarde em local seguro — ele será usado na configuração da loja.
Sem o token, o módulo não consegue buscar as imagens e o feed não é preenchido. Guarde o código com cuidado e não o compartilhe publicamente.
Resultado esperado: Um código longo de token é exibido e copiado para uso no passo 11.
8. Responda o questionário de tratamento de dados (se solicitado)
Em alguns casos, ao avançar pelo painel (opção Continuar para análise do app), a Meta exibe um questionário sobre o tratamento dos dados coletados. Se ele aparecer para você, responda:
- Finalidade de uso: exibição de imagens do Instagram no site da loja.
- Você tem operadores de dados do provedor com acesso à plataforma? — Não (somente você).
- País: Brasil.
- Nome da pessoa jurídica: a razão social da sua loja.
Nas demais perguntas obrigatórias, responda de acordo com a realidade do seu negócio.
Se aparecer uma mensagem de erro de verificação ao gerar o token ou avançar, procure na mesma tela a opção de adquirir todas as permissões necessárias, clique nela e tente novamente.
Resultado esperado: O questionário é concluído e o painel permite seguir normalmente, com o token já gerado e guardado.
9. Acesse as configurações do módulo no painel administrativo
Agora, dentro da sua loja: no menu superior, acesse Sistema → Configuração. No menu lateral esquerdo, dentro do grupo Serviços, clique em Instagram Feed.
Resultado esperado: A tela de configuração do Instagram Feed será exibida, com os grupos Gerenciar Token, Força atualização de imagens e Templates disponíveis.
10. Habilite o módulo
No grupo Gerenciar Token, no campo Habilitado, selecione a opção Habilitar.
Ao habilitar, os demais campos (Token, Id Usuario, Usuario) e os botões aparecem na tela.
Enquanto o módulo estiver desabilitado, o feed não aparece na loja e a sincronização automática das imagens não acontece.
Resultado esperado: Os campos de token e os botões passam a ser exibidos no grupo Gerenciar Token.
11. Informe o Token do Instagram
No campo Token, cole o token de acesso gerado no passo 7.
Sem um Token válido, o módulo não consegue buscar as imagens e o feed não é preenchido. Se o token não funcionar, repita o passo 7 para gerar um novo.
Resultado esperado: O campo Token fica preenchido com o código de acesso.
12. Obtenha os dados do seu perfil
Ainda no grupo Gerenciar Token, clique no botão Obtér dados do usuario.
A loja consulta o Instagram e preenche automaticamente os campos Id Usuario e Usuario com base no token informado.
O campo Usuario é o nome que aparece no título do feed na loja (ex: Instagram @sualoja). O campo Id Usuario fica oculto por segurança.
Se aparecer uma mensagem de erro em vez do preenchimento, revise o Token — provavelmente ele está inválido ou expirado.
Resultado esperado: Os campos Id Usuario e Usuario são preenchidos automaticamente e uma mensagem de sucesso com o nome do perfil é exibida.
13. Salve as configurações
Clique em Salvar Configuração, no canto superior direito da tela.
Após salvar, atualize o cache da loja para que as alterações entrem em vigor.
Resultado esperado: A mensagem "A configuração foi salva" é exibida no topo da tela.
14. Sincronize as imagens pela primeira vez
No grupo Força atualização de imagens, clique no botão Atualizar Agora.
A loja baixa as últimas publicações do seu Instagram e as guarda para exibição. A partir daí, a atualização passa a acontecer automaticamente todo dia.
A sincronização pode levar alguns segundos, dependendo da quantidade de fotos. Aguarde a mensagem de retorno antes de sair da tela.
Resultado esperado: A mensagem "Dados Atualizados" é exibida, indicando que as imagens foram sincronizadas.
15. Insira o feed na página desejada
Escolha em qual página o feed vai aparecer (normalmente a Home). Acesse CMS → Páginas, abra a página, vá até a aba Visual e localize o campo Atualização de Leiaute por XML.
Cole um dos modelos abaixo, conforme o formato desejado, e ajuste o número dentro de <value> para definir quantas fotos aparecem (máximo recomendado: 20).
Para exibir em carrossel (fotos que deslizam):
<reference name="content">
<block type="core/template" name="instagramwidget"
template="instagramfeed/instagramwidget.phtml">
<action method="setData"><name>limit</name><value>10</value></action>
</block>
</reference>
Para exibir em grade (fotos em blocos fixos):
<reference name="content">
<block type="core/template" name="instagramwidget_grid"
template="instagramfeed/instagramwidget_grid.phtml">
<action method="setData"><name>limit</name><value>10</value></action>
</block>
</reference>
O grupo Templates disponíveis, na própria tela de configuração do módulo, mostra esses mesmos modelos prontos para copiar.
Depois de salvar a página, atualize o cache da loja para o feed aparecer no site.
Resultado esperado: As últimas fotos do Instagram passam a ser exibidas na página escolhida, no formato selecionado.
Validação e Testes
Após concluir a configuração, execute os testes abaixo para confirmar o funcionamento correto.
Teste 1 — O feed aparece na loja
Ação: acesse a página onde inseriu o feed (ex: a Home) pelo site da loja, como um visitante.
Resultado esperado: As fotos do seu Instagram são exibidas, com o título Instagram @seuperfil acima delas.
Teste 2 — As fotos levam ao Instagram
Ação: clique em uma das fotos do feed.
Resultado esperado: Uma nova aba abre com a publicação original no Instagram.
Teste 3 — Uma foto nova é sincronizada
Ação: publique uma nova foto no seu Instagram, volte ao admin em Instagram Feed → Força atualização de imagens e clique em Atualizar Agora. Depois, atualize o cache e recarregue a página do feed na loja.
Resultado esperado: A nova publicação passa a aparecer entre as primeiras fotos do feed.
Teste 4 — Verificação em caso de falha
Se não funcionar, verifique:
- A conta do Instagram está no modo profissional (Empresa ou Criador de conteúdo).
- O convite de Testador do Instagram foi aceito dentro do Instagram (passo 5).
- O campo Habilitado está em Habilitar.
- O Token foi colado corretamente e não expirou (repita o passo 12 e confirme o preenchimento do Usuario; se der erro, gere um novo token repetindo o passo 7).
- Você clicou em Atualizar Agora ao menos uma vez para a primeira sincronização.
- O XML foi inserido na página certa e o cache foi atualizado após salvar.
- No formato carrossel, se as fotos aparecem empilhadas sem deslizar, teste o formato grade.
Pronto! Dessa forma realizamos a configuração do Instagram Feed em sua loja virtual Magento 1.
Observações Importantes
- Sincronização automática: depois da primeira atualização, as imagens são sincronizadas sozinhas todo dia. Você só precisa usar o Atualizar Agora quando quiser ver uma foto nova imediatamente.
- As imagens ficam na loja: as fotos são guardadas na sua loja, então o feed continua aparecendo mesmo que o Instagram esteja temporariamente fora do ar.
- Fotos removidas do Instagram somem do feed: se você apagar uma publicação no Instagram, ela é removida do feed na próxima sincronização.
- Validade do token: o token do Instagram tem validade de 60 dias e é renovado automaticamente todos os meses pela própria loja. Se o módulo ficar desabilitado por muito tempo, o token pode expirar — nesse caso, gere um novo token repetindo o passo 7 e cole-o novamente no campo Token.
- Interface da Meta muda com frequência: os nomes das telas e botões do painel de desenvolvedores podem variar. Procure sempre a opção equivalente e, em caso de dúvida nos passos da Meta, acione primeiro o suporte da própria Meta.
- Formato carrossel depende do tema: o formato carrossel usa um recurso visual que precisa estar disponível no tema da loja. Se as fotos não deslizarem, prefira o formato grade.
- Quantidade de fotos: o número exibido é definido pelo valor no XML da página (máximo recomendado: 20).
Referências e Relacionados
- Limpeza de cache da loja: toda alteração no módulo e na página só aparece depois de atualizar o cache. Aprenda a atualizar o cache da sua loja
- Edição de páginas no CMS: o feed é inserido pela edição de layout XML de uma página do CMS. Entenda como editar páginas e o campo de layout.
- Personalização visual da Home: o feed do Instagram costuma compor a vitrine junto de banners e destaques.
Caso tenha ficado alguma dúvida entre em contato com nosso time de suporte através do chat online dentro da sua loja virtual ou através do e-mail web@tryideas.com.br