Social Feed para TYPO3

Feeds de redes sociais no site ficam bonitos, mas quebram regularmente por mudanças de API

Equipes de marketing querem exibir posts do Instagram, publicações do Facebook ou tweets do Twitter/X no site da empresa. A ideia é compreensível: conteúdo atual sem esforço editorial, prova social por posts reais, valorização visual por material fotográfico. A prática é diferente. Meta, Twitter/X e TikTok alteram suas APIs regularmente, restringem direitos de acesso ou encerram endpoints gratuitos completamente. Twitter/X aboliu o acesso gratuito à API em 2023 e exige desde então pelo menos 100 USD/mês para direitos de leitura. A Instagram Basic Display API foi substituída pela Instagram Graph API em 2024. Quem opera uma integração de feed social precisa acompanhar essas mudanças ou o feed fica vazio.

pxa_social_feed (desenvolvido pela Pixelant) é a extensão TYPO3 mais conhecida para feeds de redes sociais. Suporta Instagram, Facebook e Twitter/X, armazena dados do feed localmente (em cache) e os renderiza como elemento de conteúdo TYPO3. A extensão é open source e mantida pela comunidade.

Cenários típicos de uso

Sites corporativos com feed Instagram na página inicial. Uma empresa publica 3 a 5 vezes por semana no Instagram e quer exibir os últimos 6 a 12 posts como galeria de imagens na página inicial. pxa_social_feed busca os posts via cronjob (por exemplo, a cada 30 minutos), armazena imagens, legendas e links localmente e os renderiza em um grid configurável. A vantagem sobre um embed (iframe): sem requests externos ao carregar a página, sem pixels de rastreamento, tempo de carregamento mais rápido.

Páginas de eventos com feed ao vivo. Conferências, feiras ou festas corporativas usam uma hashtag (ex: #GosignSummit2026). O feed exibe todos os posts públicos com essa hashtag em tempo real (ou quase tempo real com cache de 5 minutos). A moderação ocorre no backend TYPO3: posts individuais podem ser ocultados antes de aparecerem no site.

Páginas de employer branding. Departamentos de RH exibem na página de carreiras momentos do cotidiano de trabalho que colaboradores postam no Instagram ou LinkedIn. A integração coleta posts de uma ou várias contas e os curadoria editorialmente. Particularidade: LinkedIn não oferece API aberta para integração de feed, portanto a automação se limita a Instagram e Facebook.

Arquitetura técnica

pxa_social_feed utiliza as APIs das respectivas plataformas: Instagram Graph API (via token de app Facebook), Facebook Graph API e Twitter/X API v2. Cada plataforma requer autenticação própria: Facebook e Instagram precisam de um Long-Lived User Token (válido por 60 dias, deve ser renovado regularmente), Twitter/X precisa de um Bearer Token (Application-only Auth).

A extensão armazena dados do feed em uma tabela TYPO3 local. Imagens são baixadas e armazenadas como referências FAL. Ao carregar a página, apenas dados locais são renderizados - sem chamadas de API externas. Uma tarefa scheduler busca novos posts e exclui antigos (configurável: manter últimos 50 posts, remover mais antigos).

A saída ocorre via templates Fluid, configurados por TypoScript. Layouts padrão: grid (3-4 colunas), masonry, slider (via inclusão própria de JavaScript). O HTML/CSS pode ser completamente personalizado sem alterar o código da extensão.

Para conformidade com a LGPD, o cache local é decisivo: como imagens e textos ficam no próprio servidor, nenhum dado é transmitido ao Meta ou Twitter/X ao carregar a página. Sem pixel de rastreamento, sem necessidade de consentimento de cookies para o feed em si.

Problemas frequentes e soluções

Token do Instagram expira, feed fica vazio. O Long-Lived Token tem vida útil de 60 dias. Se ninguém o renova, a importação para. Solução: configurar um cronjob que renova o token automaticamente via chamada de API. pxa_social_feed oferece desde a versão 4.x uma função de Token-Refresh no backend.

Feed do Twitter/X não funciona após mudança de API. Desde 2023 a API Twitter/X é paga. O plano Basic (100 USD/mês) permite ler 10.000 tweets/mês. Para a maioria dos sites corporativos isso é suficiente, mas a relação custo-benefício deve ser avaliada. Solução: verificar se o feed Twitter/X realmente traz tráfego ou engajamento. Se não, remover o canal e manter apenas Instagram/Facebook.

Imagens não carregam ou ficam pixeladas. A Instagram Graph API entrega imagens em diferentes tamanhos. pxa_social_feed armazena por padrão a versão entregue pela API. Solução: na configuração da extensão, definir tamanho da imagem como “original” e no template Fluid gerar variantes responsivas via <f:image>.

Migração e compatibilidade de versões

pxa_social_feed suporta TYPO3 v11 e v12. A compatibilidade com TYPO3 v13 está em desenvolvimento comunitário (status abril 2026), mas ainda não foi oficialmente liberada. Para projetos em TYPO3 v13 existem duas opções: aguardar a atualização oficial ou construir uma integração de feed própria como middleware, independente da versão TYPO3.

A Gosign recomenda fundamentalmente pensar integrações de feed social como componente desacoplado: um microserviço ou Cloudflare Worker busca os feeds, armazena como JSON, TYPO3 lê o JSON e renderiza. Isso elimina a dependência de uma extensão TYPO3 e qualquer mudança de API é corrigida em um só lugar, independentemente do CMS.

O esforço total para uma integração de feed social (Instagram, com cache, em conformidade com a LGPD, com moderação no backend) fica entre 2 e 5 dias de desenvolvimento, dependendo se pxa_social_feed é suficiente ou se uma solução personalizada é necessária.