Graph API-Version

Nachrichtenverlauf /{thread-id}

Der Verlauf einer Facebook-Nachrichten-Unterhaltung. Dieser Endpunkt ist nur Nutzern zugänglich, die Entwickler der App sind, welche die Anfrage stellt.

Seiten sollten den Unterhaltungs-Endpunkt verwenden.

Lesen

Einen Nachrichtenverlauf abrufen

Berechtigungen

Beispiel

Graph API Explorer
GET /v19.0/{thread-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(
    '/{thread-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(
    "/{thread-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{thread-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:@"/{thread-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Felder

Name Beschreibung Typ

id

Die eindeutige ID für diesen Nachrichtenverlauf

string

comments

Die Nachrichten in diesem Nachrichtenverlauf

Message[]

to

Profile, die diesen Nachrichtenverlauf abonniert haben

Profile[]

unread

Die Anzahl der Nachrichten, die vom Sitzungsprofil nicht gelesen wurden

integer

unseen

Die Anzahl der Nachrichten, die vom Sitzungsprofil nicht gesehen wurden

integer

updated_time

Gibt an, wann der Nachrichtenverlauf zuletzt aktualisiert wurde

datetime

can_reply

Kann die Seite im Nachrichtenverlauf antworten

boolean

linked_group

ID der Workplace-Gruppe, mit welcher der Nachrichtenverlauf verknüpft ist (nur Workplace)

string

Edges

Name Beschreibung

messages

Liste der einzelnen Nachrichten im Nachrichtenverlauf Siehe Nachrichten

Filtern von Nachrichten

Die messages-Verbindung kann gefiltert werden, um zu vermeiden, dass Text von Messenger-Apps abgerufen wird, der Teil von Nachrichtenverlaufswarnungen ist. Dazu kann der Filter source verwendet werden, in dem möglicherweise nur Teilnehmer ausgewählt sind.

Wenn dieser Filter nicht angewendet wird, werden auch Admin-Textnachrichten abgerufen (im Nachrichtenverlauf von Messenger wird grauer Text angezeigt).

Beispiel

Mit diesem Aufruf werden die letzten 3 Nachrichten abgerufen, die nur von den Teilnehmern erstellt wurden.

curl -i -X GET \
 "https://graph.facebook.com/v4.0/t_10155839492600149?fields=id,messages.source(PARTICIPANTS).limit(3)&access_token=<Access Token>"

Veröffentlichung

Diesen Vorgang kannst du nicht für diesen Endpunkt ausführen.

Löschen

Diesen Vorgang kannst du nicht für diesen Endpunkt ausführen.

Aktualisieren

Diesen Vorgang kannst du nicht für diesen Endpunkt ausführen.