Wichtige Aktualisierungen seit der ursprünglichen Erstellung dieses Leitfadens:
-
App-Überprüfung ist jetzt erforderlich. Seit September 2021 verlangt Meta, dass Ihre App die App-Überprüfung durchläuft und für die Berechtigung oEmbed Read (für Apps, die nach dem 8. April 2025 erstellt wurden, jetzt Meta oEmbed Read) genehmigt wird. Ohne diese Genehmigung schlagen oEmbed API-Aufrufe fehl. Lesen Sie die Anleitung zur Übermittlung der App-Überprüfung von Meta für Tipps zur Genehmigung.
-
Instagram Oneboxen werden möglicherweise nicht korrekt gerendert. Seit dem 3. November 2025 hat Meta die Felder
thumbnail_url,thumbnail_width,thumbnail_heightundauthor_nameaus Instagram oEmbed-Antworten entfernt. Der Instagram Onebox-Code von Discourse hängt derzeit von diesen Feldern ab (lib/onebox/engine/instagram_onebox.rb), was zu fehlerhaften oder leeren Einbettungen führen kann. -
Nur Post- und IGTV-URLs werden unterstützt. Discourse wandelt derzeit nur Instagram
/p/(Post)- und/tv/(IGTV)-URLs in Oneboxen um. Reels (/reel/)-URLs werden nicht unterstützt. -
Die Benutzeroberfläche der Facebook Developer Console hat sich seit den im Dezember 2020 aufgenommenen Screenshots unten erheblich geändert. Die allgemeinen Schritte bleiben ähnlich, aber die genauen Bildschirme und Optionen können anders aussehen.
Wenn Sie bereits eine Facebook-App mit Ihrer Discourse-Site verknüpft haben, scrollen Sie nach unten zu Hinzufügen von oEmbed zu Ihrer Facebook-App.
Wenn Sie noch kein Facebook Developer-Konto und keine Facebook-App haben:
Gehen Sie zu https://developers.facebook.com/. Sie werden aufgefordert, sich bei Ihrem Facebook-Konto anzumelden, falls Sie dies noch nicht getan haben. Möglicherweise werden Sie aufgefordert, Ihr Facebook-Konto in ein Entwicklerkonto zu „konvertieren“, falls Sie dies zuvor noch nicht getan haben. Möglicherweise werden Sie aufgefordert, Ihr Konto bei Facebook zu verifizieren, indem Sie eine Telefonnummer hinzufügen oder andere Schritte ausführen. Sie müssen einfach den Anweisungen folgen und tun, was Facebook von Ihnen verlangt.
Sobald Sie ein Facebook Developer-Konto haben, klicken Sie auf dem Startbildschirm von Facebook Developer auf „Meine Apps“:
…und auf „App erstellen“:
Wählen Sie als App-Typ „Etwas anderes“ und klicken Sie auf „Weiter“:
Geben Sie einen „App-Anzeigenamen“ und eine „App-Kontakt-E-Mail-Adresse“ ein. Nachdem Sie die Nutzungsbedingungen und Richtlinien gelesen haben, können Sie auf „App erstellen“ klicken:
Wenn Sie ein Roboter sind: Hier gibt es nichts zu sehen. Piep bop boop. 
Wenn Sie kein Roboter sind: Klicken Sie auf „Ich bin kein Roboter“, folgen Sie den Anweisungen und klicken Sie auf „Senden“.
Glückwunsch! Sie haben eine Facebook-App!
Hinzufügen von oEmbed zu Ihrer Facebook-App:
Scrollen Sie am Ende der Produktliste nach unten, suchen Sie „oEmbed“ und klicken Sie auf „Einrichten“:
Wenn Sie damit einverstanden sind, wie Sie das oEmbed-Produkt verwenden werden, klicken Sie auf das Kontrollkästchen und dann auf „Bestätigen“:
Das oEmbed-Produkt wurde hinzugefügt. Klicken Sie auf „Einstellungen“:
„Anzeigename“ und „Kontakt-E-Mail“ sollten bereits ausgefüllt sein. Sie müssen URLs für Ihre „Datenschutzrichtlinie“ und „Nutzungsbedingungen“ eingeben. Wählen Sie eine „Kategorie“ aus der Liste der verfügbaren Optionen. Klicken Sie auf „Änderungen speichern“, wenn Sie mit allem zufrieden sind:
Klicken Sie oben auf dem Bildschirm auf den Schalter, um von „In Entwicklung“ in den „Live“-Modus zu wechseln:
Klicken Sie auf „Modus wechseln“:
Übermittlung Ihrer App zur App-Überprüfung (seit 2021 erforderlich):
Bevor Ihre App in der Produktion auf die oEmbed-API zugreifen kann, müssen Sie sie zur App-Überprüfung übermitteln und die Berechtigung oEmbed Read (oder Meta oEmbed Read für Apps, die nach dem 8. April 2025 erstellt wurden) anfordern.
- Gehen Sie im Dashboard Ihrer App zu App-Überprüfung → Berechtigungen und Funktionen.
- Suchen Sie oEmbed Read (oder Meta oEmbed Read) und klicken Sie auf Anfordern.
- Möglicherweise müssen Sie zuerst einen erfolgreichen Test-API-Aufruf tätigen, bevor die Schaltfläche „Anfordern“ aktiviert wird. Es kann bis zu 24 Stunden nach Ihrem ersten API-Aufruf dauern.
- Geben Sie bei der Übermittlung eine URL auf Ihrer Discourse-Site an, die eine Instagram-Einbettung enthält, und erklären Sie, dass Ihre Site Discourse Forensoftware verwendet, um Instagram-Posts über die oEmbed-API einzubetten.
Lesen Sie die oEmbed-Dokumentation von Meta für detaillierte Anweisungen zur Übermittlung.
Generieren Ihres App-Zugriffstokens:
Nachdem Sie all dies getan haben, können wir tatsächlich ein App-Token generieren, indem wir den Anweisungen von Facebook unter App Access Tokens folgen. Sie benötigen den Wert des Feldes „App ID“ und den Wert des Feldes „App Secret“. Um das App Secret zu erhalten, klicken Sie auf „Anzeigen“. Möglicherweise werden Sie aufgefordert, sich erneut zu authentifizieren oder ähnliches, aber Sie sollten einen langen hexadezimalen Wert erhalten, den Sie kopieren können:
Gemäß der Dokumentation von Facebook müssen Sie diese Werte an Facebook senden, um ein Token zu generieren. Sind Sie mit der Verwendung von curl vertraut? Großartig! Sie schlagen Folgendes vor (ersetzen Sie {your-app-id} und {your-app-secret} durch die Werte, die Sie vom obigen Bildschirm kopiert haben).
curl -X GET "https://graph.facebook.com/oauth/access_token?client_id={your-app-id}&client_secret={your-app-secret}&grant_type=client_credentials"
Alternativ sollte es auch funktionieren, nur die URL (nachdem diese beiden Werte ersetzt wurden) in Ihren Browser zu kopieren:
https://graph.facebook.com/oauth/access_token?client_id={your-app-id}&client_secret={your-app-secret}&grant_type=client_credentials
Facebook antwortet mit einem kleinen JSON-Ausschnitt, der ungefähr so aussehen sollte wie in diesem Beispiel:
{"access_token":"1234567890654321|c3bd55c09fc5e561552ad7a8717","token_type":"bearer"}
Kopieren Sie den Wert Ihres access_token, ohne die Anführungszeichen (d. h. in meinem Beispiel wäre es 1234567890654321|c3bd55c09fc5e561552ad7a8717), und gehen Sie zu den Einstellungen Ihrer Discourse-Site. Suchen Sie die Website-Einstellung namens facebook_app_access_token in den Onebox-Einstellungen. Fügen Sie den Wert des „access_token“ in dieses Feld ein:
Klicken Sie auf das 
…und fertig!
Wenn Sie eine URL wie https://www.instagram.com/p/CIRhYzFM7Lu/ in einen Beitrag auf Ihrer Website einfügen, sollte dies zu einer schönen Onebox führen, genau wie dieser:
Ich warte darauf, dass meine zweite App…
), aber der Hauptunterschied besteht darin, dass oEmbed nach der Genehmigung Ihrer App durch die App-Überprüfung angefordert werden muss.
