Publit.Si
Dokumentation›Instagram verbinden

Plattformen

Instagram verbinden

Du erstellst eine eigene kleine App bei Meta. Sie bleibt im Entwicklungsmodus: Nur du nutzt sie, deshalb ist keine Meta-Prüfung nötig. Publit.Si veröffentlicht anschließend mit deinen eigenen Schlüsseln.

Das brauchst du

  • Ein Cloudflare-Tunnel
  • Ein Instagram-Konto, das du auf professionell umstellen kannst
  • Ein Meta-Login (Facebook) für developers.facebook.com und business.facebook.com

Konto auf professionell umstellen

  1. In der Instagram-App: Settings → Account type and tools → Switch to professional account (Creator oder Business). API-Veröffentlichung funktioniert nur mit professionellen Konten.

Neue Meta-App

Konto einem Unternehmensportfolio hinzufügen

  1. Öffne business.facebook.com und erstelle ein Unternehmensportfolio oder verwende dein vorhandenes.

  2. Settings → Accounts → Instagram accounts → Add: Melde dich bei deinem Instagram-Konto an.

Neue Meta-App

Meta-App erstellen

  1. Öffne developers.facebook.com → Create app (App erstellen).

    Meta for Developers, Create app mit ausgewähltem Anwendungsfall Manage messaging & content on Instagram
    1. 1:Manage messaging & content on Instagram
    Create app → Anwendungsfall Manage messaging & content on Instagram (Nachrichten und Inhalte verwalten).
  2. Anwendungsfall: Manage messaging & content on Instagram. Verbinde das Unternehmensportfolio aus dem vorherigen Schritt. Die App darf im Modus Development bleiben.

  3. Use cases → Customize → API setup with Unified login.

Neue Meta-App

Anmeldekonfiguration erstellen

  1. Facebook Login for Business → Configurations: Erstelle eine Konfiguration aus der Vorlage Instagram API (Unified Login).

  2. Token: System-user access token (Systemnutzer-Zugriffstoken), Ablauf Never (nie). Ressource: Instagram accounts.

  3. Behalte die Berechtigungen aus der Tabelle unten. Entferne Werbekonten sowie Anzeigen- und Nachrichtenberechtigungen; Publit.Si benötigt sie nicht.

  4. Eine Berechtigung fehlt? Füge sie zuerst dem Anwendungsfall hinzu: Use cases → Manage messaging & content on Instagram → Customize → Permissions and features → daneben Add. Öffne danach die Konfiguration erneut und wähle sie aus.

BerechtigungBenötigt?Aufgabe
instagram_content_publishErforderlichVeröffentlichen. Ohne diese Berechtigung lehnt Publit.Si die Verbindung ab.
instagram_basicErforderlichMeta erlaubt Veröffentlichungen nur zusammen mit dieser Berechtigung
instagram_manage_insightsOptionalAufrufe und Reichweite (INSTAGRAM_INSIGHTS=1)
instagram_manage_commentsOptionalKommentare lesen und beantworten (INSTAGRAM_COMMENTS=1)
business_managementOptionalPublit.Si kann das freigegebene Konto selbst finden; sonst benötigst du häufig die Konto-ID (nächster Abschnitt)
Neue Meta-App

Weiterleitungsadresse eintragen

  1. Öffne in Publit.Si Settings › Platform setup › Instagram und kopiere die Weiterleitungsadresse. Sie sieht etwa so aus: https://publish.example.com/oauth/instagram/callback.

    Publit.Si, Settings › Platform setup: Je Plattform eine Karte mit Prüfungen, Status und kopierbarer Weiterleitungsadresse
    1. 1:Plattformstatus
    2. 2:Weiterleitungsadresse kopieren
    Settings › Platform setup zeigt eingerichtete Werte je Plattform und die genaue Weiterleitungsadresse zum Kopieren.
  2. Meta: Facebook Login for Business → Settings → Valid OAuth Redirect URIs → einfügen → Save changes (Änderungen speichern).

Neue Meta-App

Schlüssel eintragen

  1. Kopiere App ID und App secret aus App settings → Basic sowie die ID der zuvor erstellten Konfiguration.

  2. Trage sie in Publit.Si unter Settings › Platform setup › Enter credentials oder in .env ein:

    INSTAGRAM_UNIFIED_APP_ID=…
    INSTAGRAM_UNIFIED_APP_SECRET=…
    INSTAGRAM_UNIFIED_CONFIG_ID=…
    INSTAGRAM_INSIGHTS=1
    INSTAGRAM_COMMENTS=1
    Publit.Si-Formular Enter credentials mit eingetragener Google-Client-ID und leerem Secret-Feld
    1. 1:Client ID (Client-ID)
    2. 2:Save and apply (speichern und anwenden)
    Enter credentials trägt Schlüssel in .env ein und startet die Dienste neu. Zugangsdaten werden nie erneut angezeigt.
Neue Meta-App

Wenn Meta das Konto nicht nennt

Bei Systemnutzer-Tokens nennt Meta oft nicht das freigegebene Instagram-Konto. Publit.Si meldet das beim Verbinden. Hinterlege einmal die Konto-ID:

  1. Meta Business Suite → Settings → Accounts → Instagram accounts → dein Konto: Kopiere seine ID (nur Ziffern).

  2. Trage sie in .env ein, starte neu und verbinde erneut. Publit.Si prüft die ID anhand deines Logins.

    INSTAGRAM_UNIFIED_ACCOUNT_ID=17841400000000000
Ältere Meta-App

Ältere App: API setup with Instagram login

  1. In deiner App: Use cases → Customize → API setup with Instagram login. Das bieten nur vor Ende Oktober 2026 erstellte Apps.

  2. Ergänze instagram_business_basic und instagram_business_content_publish. Für Aufrufe und Reichweite zusätzlich instagram_business_manage_insights, zum Lesen von Kommentaren in Publit.Si instagram_business_manage_comments.

    Instagram-API-Anwendungsfall: API setup with Instagram login mit Instagram-App-ID, verborgenem Secret und Berechtigungen
    1. 1:API setup with Instagram login
    2. 2:Instagram app ID (App-ID)
    3. 3:App secret (Show): Secret anzeigen
    4. 4:Permissions (Berechtigungen)
    API setup with Instagram login zeigt Instagram-App-ID, Secret hinter Show und Berechtigungen. Nur Apps von vor Ende Oktober 2026 bieten dies; neuere nutzen Unified login. Manche Menüs erscheinen in deiner Browsersprache.
Ältere Meta-App

Dich als Tester hinzufügen

  1. App roles → Roles → Add People → Instagram Tester → Instagram-Nutzernamen eingeben. Tester erscheinen unter All roles.

    App roles › Roles: Tabelle All roles mit Instagram-Testern und Schaltfläche Add People
    1. 1:App roles › Roles (App-Rollen)
    2. 2:Add People (Personen hinzufügen)
    3. 3:Instagram Tester
    App roles → Roles → Add People → Instagram Tester: Lade dein Konto ein.
  2. Nimm die Einladung in Instagram an: Settings → Website permissions → Apps and websites → Tester Invites → Accept. Im Web: instagram.com/accounts/manage_access.

    Instagram-Einstellungen, Apps and websites, Reiter Tester Invites mit Publit.Si-App
    1. 1:Tester Invites (Tester-Einladungen)
    2. 2:Deine App
    Instagram → Apps and websites → Tester Invites → annehmen. Danach erscheint die App wie hier als autorisiert.
Ältere Meta-App

Weiterleitungsadresse eintragen

  1. Kopiere die Weiterleitungsadresse aus Publit.Si, Settings › Platform setup › Instagram.

  2. Meta: Unter API setup with Instagram login, Schritt Set up Instagram business login → Business login settings → OAuth redirect URIs → einfügen → Save.

    Business login settings mit ausgefüllter OAuth-Weiterleitungsadresse des Tunnels
    1. 1:OAuth redirect URIs (Weiterleitungsadressen)
    2. 2:Save (speichern)
    Business login settings → OAuth redirect URIs: Weiterleitungsadresse aus Publit.Si einfügen → Save.
Ältere Meta-App

Schlüssel eintragen

  1. Kopiere Instagram app ID und Instagram app secret (hinter Show) aus API setup with Instagram login. Verwende nicht die Facebook-App-ID oben auf der Seite.

  2. Trage sie in Publit.Si unter Settings › Platform setup › Enter credentials oder in .env ein. Lasse INSTAGRAM_UNIFIED_* leer; sobald ein solcher Wert gesetzt ist, nutzt Publit.Si Unified login.

    INSTAGRAM_APP_ID=…
    INSTAGRAM_APP_SECRET=…
    INSTAGRAM_INSIGHTS=1   # if you added the insights permission
    INSTAGRAM_COMMENTS=1   # if you added the comments permission

Ergebnis prüfen

Settings › Platform setup › Instagram zeigt alle Punkte als eingerichtet. Die dortige Anleitung richtet sich nach deiner .env (Unified login oder älterer Weg). Wenn du deinen ersten Beitrag veröffentlichst, zeigt die Verbindung dein Konto.

Fehlersuche

redirect_uri_mismatch
Die Weiterleitungsadresse im Dashboard muss exakt übereinstimmen, einschließlich http/https und Port.
Instagram: „Insufficient developer role“
Das Konto hat die Tester-Einladung nicht angenommen oder Chrome ist bei einem anderen Konto angemeldet.
Instagram: „Invalid scope“
Älterer Weg (SETUP.md, 4b): Eine Berechtigung aus Schritt 4b.3 fehlt. Schalte Instagram: views and reach unter Settings › Platforms › Statistics and comments aus (oder setze INSTAGRAM_INSIGHTS=0 und starte neu), danach erneut verbinden.
Meta: „API setup with Instagram login is not available for newer apps“
Deine App ist neu. Richte sie mit Unified login ein (SETUP.md, Schritt 4a).
Instagram: „Invalid platform app“ oder „Invalid Scopes“
Die Anmeldung lief trotz neuer App über den älteren Weg. Setze INSTAGRAM_UNIFIED_APP_ID, INSTAGRAM_UNIFIED_APP_SECRET und INSTAGRAM_UNIFIED_CONFIG_ID (SETUP.md, Schritt 4a.6), starte neu und verbinde erneut.
Instagram: „Meta did not say which Instagram account you shared“
Setze INSTAGRAM_UNIFIED_ACCOUNT_ID auf die Konto-ID (SETUP.md, Schritt 4a.7), starte neu und verbinde erneut. Oder ergänze die optionale Berechtigung business_management (Schritt 4a.4); dann findet Publit.Si das Konto meist selbst.
Instagram: „… is not reachable with this login“
Die ID in INSTAGRAM_UNIFIED_ACCOUNT_ID ist falsch oder das Konto wurde im Meta-Dialog nicht gewählt. Prüfe die ID unter Meta Business Suite → Settings → Instagram accounts.
Instagram: „publishing permission is missing“
Unified login (SETUP.md, 4a): instagram_content_publish fehlt in der Anmeldekonfiguration oder wurde im Meta-Dialog abgewählt. Nicht angeboten? Ergänze sie zuerst unter Use cases → Manage messaging & content on Instagram → Customize → Permissions and features (Schritt 4a.4). Verbinde danach erneut und erlaube alles.
Metas Konfigurationsvorlage möchte ein Werbekonto erstellen
Entferne Werbekonten und Anzeigenberechtigungen aus der Konfiguration (SETUP.md, Schritt 4a.4). Publit.Si benötigt sie nicht.
Instagram kann Medien nicht laden
Bot Fight Mode ist für den Tunnel-Host noch eingeschaltet. Schalte ihn im Cloudflare-Dashboard aus.

Du kommst nicht weiter? Suche in der Fehlersuche oder schreibe uns . Teile keine Zugangsdaten oder Tokens.