إصدار ‏‎Graph API‎‏

المحادثة /{conversation-id}

محادثة على Messenger بين شخص وصفحة فيسبوك أو حساب Instagram احترافي.

القراءة

مستكشف Graph 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

string (سلسلة)

معرف المحادثة

messages

string (سلسلة)

الرسائل ضمن المحادثة

participants

object (كائن)

id


email

المراسلة على الصفحة فقط

name

المراسلة على الصفحة فقط

username

المراسلة على Instagram فقط

المشاركون في المحادثة


المعرف على مستوى Instagram والمعرف على مستوى الصفحة لشخص ما أو معرف Instagram لحساب Instagram الاحترافي لديك أو معرف الصفحة.

البريد الإلكتروني للشخص أو الصفحة


اسم الشخص أو الصفحة


اسم المستخدم على Instagram لشخص ما أو حساب Instagram الاحترافي لديك

updated_time

datetime (تاريخ/وقت)

يمثل وقت إضافة آخر رسالة إلى المحادثة

للحصول على معلومات حول رسالة محددة ضمن المحادثة، أرسل طلبًا إلى نقطة نهاية الرسالة.

النشر

لا يمكنك النشر باستخدام عنصر الربط هذا.

استخدم منصة Messenger لإرسال القوالب والردود السريعة والمزيد.

الحذف

لا يمكنك الحذف باستخدام عنصر الربط هذا.

التحديث

لا يمكنك التحديث باستخدام عنصر الربط هذا.

عناصر الربط

الاسم الوصف يُستخدم في النشر

/messages

يمثل قائمة بكل الرسائل الموجودة في المحادثة

الردود (من جانب الصفحات فقط)