Embed social quebrado no WordPress: como corrigir

Tipo Outros erros

Nome do erro Embed do Instagram e Facebook quebrado EN: Broken Instagram and Facebook embeds

Severidade Atenção

Descrição O embed social quebrado no WordPress (posts do Instagram e Facebook) acontece porque a Meta descontinuou o oEmbed automático e passou a exigir app e token de acesso. A correção é usar o plugin oficial Smash Balloon para autenticar a incorporação com token válido.

O que é o embed do Instagram e Facebook quebrado?

Embed quebrado do Instagram e Facebook é quando você cola o link de um post dessas redes no editor do WordPress e, em vez do conteúdo incorporado, aparece só o link cru ou um espaço em branco. Antes, o WordPress incorporava esses posts automaticamente por oEmbed. Em outubro de 2020, a Meta encerrou o oEmbed público: hoje qualquer incorporação de Instagram ou Facebook exige um app registrado na plataforma e um token de acesso. Sem essa autenticação, o WordPress não tem como buscar o conteúdo e o embed falha.

Como identificar

Ao colar o link de um post do Instagram ou Facebook, o editor mostra só a URL como texto, sem incorporar o conteúdo.
Embeds que funcionavam há anos pararam todos de uma vez, sem você ter mexido em nada no site.
No lugar do post aparece a mensagem “Sorry, this content could not be embedded” no bloco.
O console do navegador (F12) mostra erro de requisição ao endpoint de oEmbed da Meta com status de não autorizado.

Antes de começar: Trate o token de acesso da Meta como uma senha. Nunca cole o token em comentários, em código público ou em prints, pois ele dá acesso à leitura do conteúdo da conta conectada e pode ser usado por terceiros.

Como prevenir

Use um plugin oficial como o Smash Balloon para qualquer incorporação de Instagram ou Facebook, em vez de colar o link cru
Mantenha a conta do Instagram como profissional ou de criador, exigência da API para gerar e renovar o token
Reconecte a conta no plugin periodicamente para renovar o token antes que ele expire e quebre os embeds

Causa

A Meta descontinuou o oEmbed público de Instagram e Facebook em outubro de 2020, então a incorporação automática por link deixou de existir.
A incorporação atual exige um app registrado no Facebook for Developers e um token de acesso, que o site não possui.
O token de acesso configurado num plugin expirou ou foi revogado, e a Meta passou a recusar as requisições de embed.
A conta do Instagram não foi conectada como conta profissional ou de criador, condição exigida pela API atual para gerar o token.
Um plugin de incorporação antigo, baseado no oEmbed extinto, continua instalado e falha em silêncio a cada requisição.

Como resolver

Entenda que o link cru não basta mais: confirme que colar o link parou de funcionar para todos os posts dessas redes. Como a Meta encerrou o oEmbed público, nenhum embed por link puro volta a funcionar sem autenticação por token.
Instale um plugin oficial de feed: instale o Smash Balloon (Instagram Feed ou Custom Facebook Feed), que é o caminho recomendado. Ele cuida do app e do token pelo próprio fluxo de conexão, sem você editar código.
Conecte a conta e gere o token: no plugin, clique em conectar conta do Instagram ou do Facebook e autorize o acesso. A conta do Instagram precisa ser profissional ou de criador. O plugin gera e guarda o token de acesso automaticamente.
Insira o conteúdo pelo bloco do plugin: no editor, use o bloco ou shortcode do plugin para exibir o post ou o feed, em vez de colar o link cru. O plugin usa o token autenticado para buscar o conteúdo direto da API da Meta.
Renove tokens expirados: se o embed parar de novo depois de semanas, o token expirou. Volte às configurações do plugin e reconecte a conta para gerar um token novo, restaurando a incorporação.

PHP

// functions.php do tema filho — converte URL crua de post do Instagram em um clique para o plugin
// Util quando posts antigos ainda tem o link cru salvo no conteudo
add_filter( 'the_content', function ( $content ) {
    $padrao = '#https?://(www.)?instagram.com/(p|reel)/([A-Za-z0-9_-]+)/?#';
    return preg_replace_callback( $padrao, function ( $m ) {
        // delega ao shortcode do Smash Balloon (instagram-feed), que usa o token
        return do_shortcode( '[instagram-feed feed=1 num=1 type=public post="' . esc_attr( $m[3] ) . '"]' );
    }, $content );
}, 9 );

Perguntas frequentes

Por que parei de conseguir incorporar posts do Instagram colando o link?

Porque a Meta encerrou o oEmbed público de Instagram e Facebook em outubro de 2020. Desde então, colar o link cru não incorpora mais nada. A incorporação atual exige um app registrado na Meta e um token de acesso, normalmente gerenciados por um plugin oficial.

Meus embeds antigos pararam todos de uma vez. Por quê?

Porque eles dependiam do oEmbed público que a Meta desativou. Como a mudança foi do lado da plataforma, todos os embeds por link puro quebram juntos, sem você ter alterado o site. A solução é refazê-los por um plugin que use token de acesso autenticado.

Qual a forma recomendada de incorporar Instagram e Facebook hoje?

Usar um plugin oficial como o Smash Balloon. Ele cuida do app na Meta e do token de acesso pelo próprio fluxo de conexão, sem editar código. Você conecta a conta, autoriza o acesso e exibe o post ou o feed por bloco ou shortcode do plugin.

Preciso de conta profissional no Instagram para o embed funcionar?

Sim, na maioria dos casos. A API atual da Meta exige que a conta do Instagram seja profissional ou de criador para gerar o token de acesso usado na incorporação. Converta a conta nas configurações do Instagram antes de conectá-la ao plugin de feed.

O embed funcionou por um tempo e quebrou de novo. O que houve?

Provavelmente o token de acesso expirou ou foi revogado. Os tokens da Meta têm validade. Quando expiram, a API recusa as requisições e o embed para. Volte às configurações do plugin, reconecte a conta e gere um token novo para restaurar a incorporação.

Posso incorporar sem plugin, registrando o app eu mesmo?

Pode, mas é trabalhoso. Você precisa criar um app no Facebook for Developers, configurar permissões, gerar o token e tratar a renovação por código. Para a maioria dos sites, um plugin oficial faz tudo isso de forma mais segura e com menos manutenção.

Crítico

Como corrigir a integração Stripe/PayPal que não processa pagamentos no WPForms

O pagamento Stripe ou PayPal não processa no WPForms quando o formulário envia mas a cobrança não acontece, é recusada ou fica pendente. As causas reais costumam ser SSL ausente na página, modo Teste ligado em produção, AJAX desabilitado, licença Pro inativa ou o campo de pagamento faltando no formulário.

Grave

Como corrigir a lógica condicional que não funciona no WPForms

A lógica condicional WPForms não funciona quando as regras Smart Logic não executam no frontend e os campos deixam de aparecer ou esconder conforme a resposta do usuário. A causa quase sempre esta no JavaScript do formulário que não carrega.

Atenção

Como corrigir o course archive que não exibe todos os cursos no Tutor LMS

O Tutor LMS course archive não mostra todos os cursos quando há cursos fora do status Publicado, paginação limitando a quantidade exibida, cache servindo uma versão antiga da página ou um filtro de categoria ativo escondendo parte da lista.

Atenção

Como corrigir imagens que não aparecem no WordPress

Imagens que não aparecem no WordPress costumam vir de permissões erradas na pasta wp-content/uploads, de miniaturas que nunca foram geradas ou de URLs em HTTP num site HTTPS. A correção passa por ajustar as permissões para 755 nas pastas e 644 nos arquivos, regenerar as miniaturas e alinhar as URLs ao protocolo do site.

Grave

Como corrigir instrutores sem permissão para criar cursos no Tutor LMS

A falta de permissão de instrutor no Tutor LMS faz o usuário abrir o painel sem o botão Create a New Course ou receber acesso negado ao salvar. A causa quase sempre é o Marketplace desligado, a conta de instrutor ainda Pending ou a role tutor_instructor não aplicada ao usuário.

Informativo

Como corrigir o erro de conformidade GDPR no WPForms

O WPForms GDPR checkbox não aparece quando a opção GDPR Enhancements esta desativada nas configurações do plugin: sem ela, o campo GDPR Agreement fica oculto no construtor e o consentimento não e coletado nem registrado na entrada.

Setores

Extensões

Integrações

Como corrigir o embed do Instagram e Facebook quebrado no WordPress

O que é o embed do Instagram e Facebook quebrado?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir a integração Stripe/PayPal que não processa pagamentos no WPForms

Como corrigir a lógica condicional que não funciona no WPForms

Como corrigir o course archive que não exibe todos os cursos no Tutor LMS

Como corrigir imagens que não aparecem no WordPress

Como corrigir instrutores sem permissão para criar cursos no Tutor LMS

Como corrigir o erro de conformidade GDPR no WPForms

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos