グラフAPIバージョン

スレッド/{conversation-id}

利用者と、FacebookページまたはInstagramプロアカウントとの間のMessengerスレッド。

読み取り

グラフAPIエクスプローラ
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
}];

アクセス許可

Instagramメッセージの場合は、以下も必要です。

制限

  • このエンドポイントでInstagramメッセージをクエリすると、このスレッドのすべてのメッセージが返されます。ただし、クエリできる対象は、スレッド内の最新のメッセージ20件のデータだけです。メッセージが最新20件の中に含まれていない場合、当該メッセージが削除されたことを示すエラーが返されます。

フィールド

名前 説明

id

文字列

スレッドのID

messages

文字列

スレッド内のメッセージ

participants

オブジェクト

id


email

ページメッセージのみ

name

ページメッセージのみ

username

Instagramメッセージのみ

スレッド内の参加者


利用者のInstagramスコープIDまたはページスコープID、あなたのInstagramプロアカウントのInstagram IDまたはページID。

利用者またはページのメールアドレス


利用者またはページの名前


利用者のInstagramユーザー名、またはあなたのInstagramプロアカウントのInstagramユーザー名

updated_time

日付時刻

最後のメッセージがスレッドに追加された時刻

スレッド内の特定のメッセージについての情報を取得するには、メッセージエンドポイントにリクエストを送信します。

公開

このエッジを使用して公開することはできません。

テンプレートクイック返信、その他を送信する場合は、Messengerプラットフォームを使用します。

削除

このエッジを使って削除することはできません。

更新

このエッジを使って更新することはできません。

エッジ

名前 説明 公開する対象

/messages

スレッド内のすべてのメッセージのリスト

返信(ページによる返信のみ)