Messenger-Plattform

Private Antworten

In diesem Dokument erfährst du, wie du private Antworten programmgesteuert zu deinem Messaging-Erlebnis hinzufügst.

So funktioniert’s

Über private Nachrichten kann ein professionelles Instagram-Konto eine einzige Nachricht an eine Person senden, die einen Beitrag, einen Werbebeitrag, ein Reel oder eine Live-Story deines professionellen Instagram-Kontos kommentiert hat.

Wenn du über die Instagram Graph API eine comments- oder live_comments-Webhook-Benachrichtigung erhältst, dass eine Person einen Beitrag, einen Werbebeitrag, ein Reel oder eine Live-Story deines professionellen Instagram-Kontos kommentiert hat, kannst du die Kommentar-ID verwenden, um eine private Antwort direkt an diese Person zu senden. Diese Antwort wird an das Postfach dieser Person zugestellt, wenn die Person dem professionellen Instagram-Konto des Unternehmens folgt, oder an den Ordner Anfrage der Person, wenn sie dem Konto nicht folgt.

Du kannst diese private Antwort innerhalb von 7 Tagen nach der Erstellung des Kommentars senden, ausgenommen Instagram Live-Beiträge, bei denen du eine private Antwort nur während der Live-Übertragung senden kannst. Die Nachricht enthält einen Link zu dem Beitrag, den die Person kommentiert hat.

Webhooks

  • Wenn du eine Instagram Live Story hostest, stelle sicher, dass dein Server die erhöhte Benachrichtigungslast verarbeiten kann, die durch live_comments-Webhook-Events über die Instagram API ausgelöst wird, und dass dein System zwischen live_comments- und comments-Benachrichtigungen unterscheiden kann.
  • comments-Webhook-Benachrichtigungen der Instagram Graph API für Werbebeiträge enthalten die ID und den Titel für die Werbeanzeige. Möglicherweise musst du deinen Webhooks-Server aktualisieren, um diese neuen Felder zu verarbeiten.

    Die ad_id und der ad_title werden im media-Objekt zurückgegeben, wenn eine Person einen beworbenen Instagram-Beitrag oder einen Instagram-Werbebeitrag kommentiert. Das kann zu doppelten Webhook-Benachrichtigungen führen.

Einschränkungen

  • Es kann immer nur eine Nachricht an die Person gesendet werden, die einen Kommentar erstellt hat.
  • Die Nachricht muss innerhalb von 7 Tagen nach dem Erstellen des Kommentars zu einem Beitrag, Werbebeitrag oder Reel gesendet werden.
  • Da Instagram Live Stories nur vorübergehend verfügbar sind, können private Antworten auf Kommentare zu Instagram Live Stories ausschließlich während der Live-Übertragung gesendet werden. Sobald die Live-Übertragung endet, können keine privaten Antworten mehr gesendet werden.
  • Du kannst eine Unterhaltung nur fortführen, wenn eine Person innerhalb des 24-Stunden-Messaging-Zeitfensters auf die private Nachricht antwortet.
  • Apps mit Standardzugriff können nur auf Daten von Personen zugreifen, die eine Rolle in der App haben.
  • Für IGTV-Kommentare werden private Antworten nicht unterstützt.
  • In API v7.0 oder älter sind die „Human Agent“-Funktion und das Human Agent Message Tag für private Antworten erforderlich.

Bevor du beginnst

Dieses Tutorial setzt voraus, dass du die Übersicht über die Messenger-Plattform und die Übersicht über Instagram Messaging gelesen und die erforderlichen Komponenten implementiert hast.

Voraussetzungen:

  • Die ID der Facebook-Seite, die mit deinem professionellen Instagram-Konto verknüpft ist
  • Die ID des Kommentars, der von der Person verfasst wurde, der du die private Antwort sendest. Die ID kann für Beiträge, Werbebeiträge und Reels von den Instagram comments-Webhooks abgerufen werden und für Live Stories von den Instagram live_comments-Webhooks (wird empfohlen, um Durchsatzratenbegrenzungen zu vermeiden) oder über einen API-Aufruf an den /page/feed-Endpunkt.
  • Die instagram_manage_comments- und die pages_messaging-Berechtigung, die über Facebook Login erteilt werden
  • Ein Seiten-Zugriffsschlüssel, der von einer Person angefordert wurde, die die MESSAGING-Aufgabe auf der Facebook-Seite ausführen kann, die mit deinem professionellen Instagram-Konto verknüpft ist
  • Die „Human Agent“-Funktion
  • Erweiterter Zugriff

Private Antwort senden

Um eine private Antwort an eine Person zu senden, die deinen Beitrag, dein Reel oder deine Live Story kommentiert hat, sende eine POST-Anfrage an den /PAGE-ID/messages-Endpunkt, bei der der recipient-Parameter die Kommentar-ID und der message-Parameter den Text enthält, den du senden möchtest.

Für Lesbarkeit formatiert.
curl -i -X POST "https://graph.facebook.com/PAGE-ID/messages
  ?recipient: { comment_id: COMMENT-ID }
  &message: { "text": "Thanks for reaching out, how can I help?" }
  &access_token=PAGE-ACCESS-TOKEN"
GraphRequest request = GraphRequest.newPostRequest(
  accessToken,
  "/1353269864728879/messages",
  new JSONObject("{\"recipient\":\"{comment_id: 18000158536435933}\",\"message\":\"{\\\"text\\\": \\\"It is cool\\\"}\"}"),
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});
request.executeAsync();
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/1353269864728879/messages"
           parameters:@{ @"recipient": @"{comment_id: 18000158536435933}",@"message": @"{"text": "It is cool"}",}
           HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];
FB.api(
  '/1353269864728879/messages',
  'POST',
  {"recipient":"{comment_id: 18000158536435933}","message":"{\"text\": \"It is cool\"}"},
  function(response) {
      // Insert your code here
  }
);

Wenn der Vorgang erfolgreich verläuft, erhält deine App diese Antwort:

{
  "recipient_id": "526...",   // The Instagram-scoped ID 
  "message_id": "aWdfZ..."    // The message ID for your private reply
}

Siehe auch

Unterstützung für Entwickler*innen