Atualizações importantes desde que este guia foi escrito originalmente:
-
A Revisão de Aplicativos agora é obrigatória. Desde setembro de 2021, a Meta exige que seu aplicativo passe pela Revisão de Aplicativos e seja aprovado para a permissão oEmbed Read (agora chamada Meta oEmbed Read para aplicativos criados após 8 de abril de 2025). Sem isso, as chamadas da API oEmbed falharão. Consulte as orientações de envio para Revisão de Aplicativos da Meta para obter dicas sobre como ser aprovado.
-
Os oneboxes do Instagram podem não ser renderizados corretamente. A partir de 3 de novembro de 2025, a Meta removeu os campos
thumbnail_url,thumbnail_width,thumbnail_heighteauthor_namedas respostas oEmbed do Instagram. O código onebox do Instagram do Discourse depende atualmente desses campos (lib/onebox/engine/instagram_onebox.rb), o que pode resultar em embeds quebrados ou vazios. -
Apenas URLs de postagens e IGTV são suportadas. O Discourse atualmente só gera oneboxes para URLs de postagens
/p/(post) e/tv/(IGTV) do Instagram. URLs de Reels (/reel/) não são suportadas. -
A interface do Console de Desenvolvedor do Facebook mudou significativamente desde que as capturas de tela abaixo foram tiradas em dezembro de 2020. As etapas gerais permanecem semelhantes, mas as telas e opções exatas podem parecer diferentes.
Se você já tem um Aplicativo do Facebook associado ao seu site Discourse, role para baixo até Adicionando o oEmbed ao seu Aplicativo do Facebook.
Se você não tem uma conta de Desenvolvedor do Facebook e um Aplicativo do Facebook:
Acesse https://developers.facebook.com/. Você será solicitado a fazer login em sua conta do Facebook se não estiver logado. Você pode ser solicitado a ‘converter’ sua conta do Facebook para uma conta de desenvolvedor se não o fez anteriormente. Você pode ser solicitado a verificar sua conta com o Facebook adicionando um número de telefone ou concluindo outras etapas. Você precisará apenas seguir as instruções e fazer o que o Facebook exigir de você.
Depois de ter uma conta de Desenvolvedor do Facebook, clique em ‘Meus Aplicativos’ na tela inicial do Desenvolvedor do Facebook:
…e em ‘Criar Aplicativo’:
Selecione um tipo de aplicativo ‘Outro’ (Something Else) e clique em ‘Continuar’ (Continue):
Insira um ‘Nome de Exibição do Aplicativo’ (App Display Name) e um ‘Email de Contato do Aplicativo’ (App Contact Email). Depois de ler os Termos e Políticas deles, você pode clicar em ‘Criar Aplicativo’ (Create App):
Se você for um robô: não há nada para ver aqui. Bip bop boop. 
Se você não for um robô: clique em “Não sou um robô” (I’m not a robot), siga as instruções e clique em ‘Enviar’ (Submit).
Parabéns! Você tem um Aplicativo do Facebook!
Adicionando o oEmbed ao seu Aplicativo do Facebook:
Role até o final da lista de Produtos, encontre ‘oEmbed’ e clique em ‘Configurar’ (Set Up):
Se você concorda com a forma como usará o produto oEmbed, marque a caixa de seleção e clique em ‘Confirmar’ (Confirm):
O produto oEmbed foi adicionado. Clique em ‘Configurações’ (Settings):
‘Nome de Exibição’ (Display Name) e ‘Email de Contato’ (Contact Email) já devem estar preenchidos. Você precisará inserir URLs para sua ‘Política de Privacidade’ (Privacy Policy) e ‘Termos de Serviço’ (Terms of Service). Selecione uma ‘Categoria’ (Category) na lista de opções disponíveis. Clique em ‘Salvar Alterações’ (Save Changes) quando estiver satisfeito com tudo:
Clique no botão de alternância na parte superior da tela para mudar de ‘Em desenvolvimento’ (In development) para o modo ‘Ao vivo’ (Live):
Clique em ‘Mudar Modo’ (Switch Mode):
Envie seu aplicativo para Revisão de Aplicativos (obrigatório desde 2021):
Antes que seu aplicativo possa acessar a API oEmbed em produção, você deve enviá-lo para Revisão de Aplicativos e solicitar a permissão oEmbed Read (ou Meta oEmbed Read para aplicativos criados após 8 de abril de 2025).
- No painel do seu aplicativo, vá para Revisão de Aplicativos (App Review) → Permissões e Recursos (Permissions and Features).
- Encontre oEmbed Read (ou Meta oEmbed Read) e clique em Solicitar (Request).
- Você pode precisar primeiro fazer uma chamada de teste de API bem-sucedida antes que o botão de solicitação fique ativo. Pode levar até 24 horas após sua primeira chamada de API.
- Ao enviar, forneça um URL no seu site Discourse que contenha um embed do Instagram e explique que seu site usa o software de fórum Discourse para incorporar posts do Instagram usando a API oEmbed.
Consulte a documentação do oEmbed da Meta para obter orientações detalhadas de envio.
Gere seu Token de Acesso ao Aplicativo:
Tendo feito tudo isso, podemos gerar um Token de Aplicativo seguindo as instruções do Facebook sobre Tokens de Acesso ao Aplicativo. Você precisará do valor do campo ‘ID do Aplicativo’ (App ID) e do valor do campo ‘Segredo do Aplicativo’ (App Secret). Para obter o Segredo do Aplicativo, clique em ‘Mostrar’ (Show). Você pode ser solicitado a se reautenticar ou algo semelhante, mas deverá obter um longo valor hexadecimal que poderá copiar:
Conforme a documentação do Facebook, você precisa enviar esses valores ao Facebook para gerar um token. Você está familiarizado com o uso do curl? Ótimo! Eles sugerem o seguinte (substituindo {your-app-id} e {your-app-secret} pelos valores que você copiou da tela acima).
curl -X GET "https://graph.facebook.com/oauth/access_token?client_id={your-app-id}&client_secret={your-app-secret}&grant_type=client_credentials"
Alternativamente, copiar apenas o URL (após substituir esses dois valores) para o seu navegador também deve funcionar:
https://graph.facebook.com/oauth/access_token?client_id={your-app-id}&client_secret={your-app-secret}&grant_type=client_credentials
O Facebook responderá com um pequeno bloco de JSON, que deve se parecer com este exemplo:
{"access_token":"1234567890654321|c3bd55c09fc5e561552ad7a8717","token_type":"bearer"}
Copie o valor do seu access_token, excluindo as aspas (ou seja, no meu exemplo seria 1234567890654321|c3bd55c09fc5e561552ad7a8717), e vá para as Configurações do seu site Discourse. Encontre a configuração do site chamada facebook_app_access_token nas configurações do Onebox. Cole o valor do ‘access_token’ neste campo:
Clique no 
…e pronto!
Colar um URL como https://www.instagram.com/p/CIRhYzFM7Lu/ em uma postagem no seu site deve resultar em um onebox adorável, assim como este:
waiting for my second app to be…
), mas a principal diferença é que o oEmbed deve ser solicitado depois que seu aplicativo for aprovado na Revisão do Aplicativo.
