Graph API-Version

Unterhaltung /{conversation-id}

Eine Messenger-Unterhaltung zwischen einer Person und einer Facebook-Seite oder einem professionellen Instagram-Konto.

Lesen

Graph API Explorer
GET /v21.0/{conversation-id} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{conversation-id}',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "/{conversation-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{conversation-id}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{conversation-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Berechtigungen

Für Nachrichten auf Instagram benötigst du außerdem:

Einschränkungen

  • Wenn du diesen Endpunkt für Nachrichten auf Instagram abfragst, werden alle Nachrichten für diese Unterhaltung zurückgegeben. Du kannst jedoch nur Daten zu den letzten 20 Nachrichten in der Unterhaltung abrufen. Wenn eine Nachricht nicht zu den letzten 20 Nachrichten zählt, wird ein Fehler zurückgegeben, der besagt, dass die Nachricht gelöscht wurde.

Felder

Name Beschreibung

id

String

Die ID der Unterhaltung

messages

String

Nachrichten in der Unterhaltung

participants

Objekt

id


email

Nur Seitennachrichten

name

Nur Seitennachrichten

username

Nur Instagram-Nachrichten

Teilnehmer*innen in der Unterhaltung


Instagram-spezifische ID oder seitenspezifische ID für eine Person oder Instagram-ID dein professionelles Instagram-Konto oder die Seiten-ID.

E-Mail-Adresse für die Person oder Seite


Name der Person oder Seite


Instagram-Benutzer*innenname für eine Person oder dein professionelles Instagram-Konto

updated_time

datetime

Die Uhrzeit zu der die letzte Nachricht in der Unterhaltung hinzugefügt wurde.

Um Informationen über eine bestimmte Nachricht innerhalb einer Unterhaltung abzurufen, sende eine Anfrage an den Messenger-Endpunkt.

Veröffentlichen

Mit dieser Edge ist das Veröffentlichen nicht möglich.

Verwende die Messenger-Plattform, um Vorlagen, Schnellantworten und mehr zu senden.

Löschen

Mit dieser Edge ist das Löschen nicht möglich.

Aktualisieren

Mit dieser Edge sind keine Aktualisierungen möglich.

Edges

Name Beschreibung Zum Veröffentlichen von

/messages

Liste aller Nachrichten der Unterhaltung

Antworten (nur durch Seiten)