Wie Sie Ihren Kunden ermöglichen, Instagram mit Ihrer App zu verbinden
Ihr Backend ruft POST /connect-sessions von easyCoexistence mit channel instagram auf und schickt den Kunden an die zurückgegebene url. Dort meldet er sich mit Instagram Login bei einem Business- oder Creator-Konto an. Anschließend kehrt er mit einer channel_id zu Ihrer redirect_url zurück, und GET /channels/{id}?credentials=1 liefert ein Token für graph.instagram.com, mit dem Ihre App veröffentlichen, Kommentare lesen und auf DMs antworten kann.
Über die API veröffentlichte Beiträge, die ein Instagram-Konto in einem gleitenden 24-Stunden-Fenster machen kann; ein Karussell zählt als einer.
Das einzige Bildformat, das Meta für die Veröffentlichung auf Instagram über die API unterstützt.
Standardfenster für Antworten auf eine Instagram-DM einer Person bei den meisten Nutzeraktionen; die Person muss zuerst schreiben.
Nachrichten, die ein Konto über eine private Antwort an einen Kommentierenden senden kann, innerhalb von 7 Tagen nach dem Kommentar.
Wie lange ein easyCoexistence-Verbindungslink gültig ist, bevor die Session abläuft.
Was muss der Kunde tun, um sich zu verbinden?
Er drückt einen Button. Ihre App erstellt die Session mit channel auf instagram, einer redirect_url und der id Ihres Kunden als external_ref und schickt den Kunden an die zurückgegebene url. Die gehostete Seite zeigt Ihren Namen und Mit Instagram fortfahren, was Instagrams eigene Anmeldung im selben Tab öffnet, sodass es auch auf dem Smartphone funktioniert. Der Kunde erteilt den Zugriff und landet auf Ihrer redirect_url mit status=connected und der channel_id, die Ihr Backend mit GET /connect-sessions/{id} bestätigt.
Welche Instagram-Konten können sich verbinden?
Professionelle Konten, Business oder Creator, also genau die, die Metas Instagram API bedient. Ein Konto, das bereits über einen anderen Dienst mit easyCoexistence verbunden ist, wird abgelehnt, und der last_error der Session weist darauf hin. Der Kunde entfernt es dort zuerst oder meldet sich mit einem anderen Konto an. Für DMs aktiviert das Konto außerdem Zugriff auf Nachrichten in der Instagram-App zulassen; der Leitfaden zur Instagram-Verbindung zeigt den Weg.
Welches Token erhält Ihre App?
Ein Instagram-Nutzer-Token für graph.instagram.com/v25.0, zusammen mit account_id_on_meta, der Instagram-ID des Kontos, aus GET /channels/{id}?credentials=1. easyCoexistence erneuert es lange bevor die 60 Tage ablaufen, und eine Erneuerung stellt ein neues Token aus. Holen Sie die Zugangsdaten deshalb zu Beginn jedes Jobs, statt eine Kopie aufzubewahren.
Wie veröffentlicht Ihre App auf dem Konto?
Mit POST /channels/{id}/posts. ig_type wählt IMAGE, CAROUSEL, REELS oder STORIES und wird aus den Medien abgeleitet, wenn Sie das Feld weglassen: Mehrere Dateien ergeben ein Karussell, ein Video ergibt einen Reel. Ein Karussell umfasst hier 2 bis 10 Elemente, Bilder müssen JPEG sein, der Text darf bis zu 2,200 Zeichen lang sein, und ein Instagram-Beitrag hat kein Link-Feld. Ohne publish_at geht er sofort online; mit publish_at geht er zu diesem Zeitpunkt online, bis zu 90 Tage im Voraus.
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: ig_post_2291" \
-d '{
"text": "Three looks for the weekend.",
"ig_type": "CAROUSEL",
"media": [
{ "url": "https://cdn.example.com/look-1.jpg", "type": "image" },
{ "url": "https://cdn.example.com/look-2.jpg", "type": "image" },
{ "url": "https://cdn.example.com/look-3.jpg", "type": "image" }
]
}'Wie erreichen Kommentare und DMs Ihre App?
Sobald Sie ein Ziel festlegen. PUT /channels/{id}/webhook mit Ihrer URL gibt das Signing-Secret dieses Kontos zurück, und ab dann werden seine Kommentare, Erwähnungen und DMs bei Eingang weitergeleitet, signiert mit X-EC-Signature. Der Body enthält platform, account_id, external_id und den Webhook-Eintrag von Meta unverändert, mit changes für Kommentare und Erwähnungen und messaging für DMs.
Wie antwortet Ihre App auf Kommentare und DMs?
Über Metas Instagram API unter graph.instagram.com, mit dem Token des Kunden, sodass jede Antwort vom Konto des Kunden kommt:
- Auf einen Kommentar antworten: POST /<
IG_COMMENT_ID>/replies mit dem Feld message. - Auf eine DM antworten: POST /<
IG_ID>/messages mit recipient auf die ID der Person und dem Nachrichtentext, innerhalb von 24 Stunden nach deren letzter Nachricht. - Private Antwort auf einen Kommentar: dieselbe messages-Edge mit recipient
comment_id, einmal pro Kommentar, innerhalb von 7 Tagen nach ihm. - Einen Kommentar ausblenden oder löschen: POST oder DELETE auf /<
IG_COMMENT_ID>.
Was passiert, wenn der Zugriff des Kunden endet?
Ihre Events-URL erhält channel.disconnected, wenn Instagram das Token ablehnt oder der Eigentümer den Zugriff in den Einstellungen von Instagram entzieht. Eine neue Connect-Session für diesen Kunden bringt das Konto zurück. Um es von Ihrer Seite zu beenden, widerruft DELETE /channels/{id} den Zugriff im Netzwerk und storniert die noch in der Warteschlange stehenden Beiträge, und die Abrechnung endet am Ende des Zyklus.
Häufige Fehler
- PNG- oder WebP-Bilder an Instagram senden. Meta veröffentlicht nur JPEG, daher wird der Beitrag abgelehnt, bevor er in die Warteschlange kommt; konvertieren Sie Bilder deshalb vorher.
- Ein Link-Feld in einen Instagram-Beitrag setzen. Instagram-Beiträge haben keinen Link, daher wird die Anfrage abgelehnt; schreiben Sie die URL in den Text.
- Einen Antworten-Button bei DMs anzeigen, die älter als 24 Stunden sind. Meta erlaubt Antworten nur innerhalb des Fensters, das die letzte Nachricht der Person geöffnet hat.
- Eine zweite private Antwort auf denselben Kommentar senden. Meta erlaubt eine; eine Folgenachricht wartet, bis die Person antwortet.
easyCoexistence lässt Ihre Kunden Instagram über eine gehostete Anmeldung mit Ihrer App verbinden und liefert Ihrem Backend danach ein erneuertes Token, einen Posts-Endpoint sowie deren Kommentare und DMs per Webhook, wobei jede Verbindung rund um die Uhr überwacht wird. Dieselben Aufrufe decken WhatsApp, Facebook, TikTok, YouTube, LinkedIn und weitere Kanäle ab. US$ 9 bis US$ 0.75 pro Verbindung und Monat, mit sinkendem Preis je weiterer Verbindung, und die ersten 3 Tage sind kostenlos.
Häufig gestellte Fragen
Brauche ich eine eigene Meta-App, um die Instagram-Konten meiner Kunden zu verbinden?
Nein. Kunden melden sich über die App von easyCoexistence an, und Ihr Backend erhält das Token für Metas Instagram API über den Aufruf mit credentials.
Kann ein Kunde mehrere Instagram-Konten verbinden?
Ja, eines pro Anmeldung. Erstellen Sie für jedes Konto eine Connect-Session mit derselben external_ref, und GET /channels?external_ref= listet alle für diesen Kunden auf.
Kann meine App Instagram-Stories planen?
Ja. Setzen Sie ig_type auf STORIES mit einem Bild oder Video und einer publish_at-Zeit, dann veröffentlicht die Warteschlange es zu diesem Zeitpunkt.
Was kostet easyCoexistence pro Instagram-Konto?
Jedes verbundene Konto kostet US$ 9 bis US$ 0.75 im Monat, je nach Staffel Ihrer gesamten Verbindungen, und die ersten 3 Tage sind kostenlos.
Weiterlesen
Verbinden Sie Ihren ersten Kanal in zwei Minuten.
Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.
- 3 Tage kostenlos
- Jederzeit kündbar
- Nur offizielle APIs
- Überwacht rund um die Uhr (24/7)
Verifiziert am