‏‎Graph API‎‏
إصدار ‏‎Graph API‎‏

الرسالة

رسالة فردية في محادثة مراسلات على Messenger أو Instagram.

للحصول على معرف رسالة، استخدم نقطة نهاية المحادثة أو أحداث Webhooks لاستعادة معرفات الرسائل الفردية.

القراءة

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

المتطلبات

النوعالوصف

مراجعة التطبيقات

مطلوب للوصول إلى بيانات الأشخاص الذين ليس لديهم دورًا في تطبيقك، مثل مطور أو مختبِر أو مسؤول

الميزات

غير متوفر

الرموز المميزة

رمز وصول الصفحة من شخص يمكنه أداء مهمة MODERATE أو مهمة MESSAGING في الصفحة التي يتم الاستعلام عنها أو ربطها بحساب Instagram الاحترافي.

الأذونات

الإذنان pages_messaging وpages_manage_metadata

الإذنان instagram_basic وinstagram_manage_messagingمطلوبان أيضًا لمراسلات Instagram

التقييدات

لمراسلات Instagram

  • لا يمكن الوصول إلى نقطة النهاية هذه إلا لحسابات Instagram الاحترافية التي لها صفحة فيسبوك مرتبطة.
  • عند الاستعلام عن نقطة النهاية هذه، سيتم إرجاع جميع الرسائل الخاصة بهذه المحادثة. ومع ذلك، لن تتمكن من الاستعلام عن البيانات سوى لأحدث 20 رسالة في المحادثة. إذا لم تكن الرسالة ضمن أحدث 20 رسالة، فسيتم إرجاع خطأ يشير إلى أنه تم حذف الرسالة.

الحقول

إذا كان الحقل لا يحتوي على بيانات، فلن يتم إرجاعه في استجابة JSON.

الاسمالوصف

attachments.data

(array) مصفوفة
file_url
generic_template
id
image_data
name
video_data

الوسائط المرفقة بالرسالة، مثل عنوان URL لشبكة توفير المحتوى لصورة أو مقطع فيديو أو ملف.


عنوان URL للملف المرفق بالرسالة

عنوان URL للصورة المرفقة بالرسالة. يمكن أن يتضمن أزواج القيم الأساسية التالية:

  • cta: object (كائن) مع title وtype وurl
  • medial_url: string (سلسلة)، عنوان URL الصورة
  • subtitle: string (سلسلة)، بالبيكسل
  • title: string (سلسلة)،

معرف المرفق

عنوان URL للصورة المرفقة بالرسالة. يمكن أن يتضمن أزواج القيم الأساسية التالية:

  • animated_gif_preview_url: string (سلسلة)، عنوان URL لمعاينة صورة GIF
  • animated_gif_url: string (سلسلة)، عنوان URL لصورة GIF
  • height: int (عدد صحيح)، بالبيكسل
  • max_height: int (عدد صحيح)، بالبيكسل
  • max_width: int (عدد صحيح)، بالبيكسل
  • preview_url: string (سلسلة)، معاينة عنوان URL
  • render_as_sticker: bool (قيمة منطقية)، حقيقي أو زائف
  • url: string (سلسلة)، عنوان URL الصورة
  • width: int (عدد صحيح)، بالبيكسل

اسم المرفق

عنوان URL لمقطع الفيديو المرفق بالرسالة

created_time

datetime

وقت إنشاء الرسالة

from

object (كائن)
id
email
name
username

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

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

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

اسم شخص أو صفحة فيسبوك. المراسلة على الصفحة فقط

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

"from": {
    "username": "INSTAGRAM-USERNAME",
    "id": "ID"
  }

id

string (سلسلة)

معرف الرسالة

is_unsupported

boolean (قيمة منطقية)

لا يتم إرجاعها إلا عندما تكون true؛ رسالة تحتوي على محتوى غير مدعوم.

message

string (سلسلة)

المحتوى النصي للرسالة. إذا لم يكن هناك نص كجزء من الرسالة، فسيكون هذا فارغًا.

reactions

مصفوفة
data array (مصفوفة)
reaction رمز تعبيري
users مصفوفة كائنات
id

username

أنواع التفاعلات التي تلقتها الرسالة مع قائمة بجميع الأشخاص الذين تفاعلوا بهذا النوع من التفاعل.

مصفوفة كائنات التفاعل

نوع الرمز التعبيري للتفاعل

قائمة بالأشخاص الذين تفاعلوا مع الرسالة


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

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

"reactions":
  {
    "reaction": "❤️",
    "users" : [
      {
        "username": "INSTAGRAM-USERNAME",
        "id": "ID", 
      },
    ]
  }

shares

array (مصفوفة)

مشاركات الوسائط، مثل منشور أو قالب منتج، المضمنة في الرسالة. يرجى ملاحظة أنه بالنسبة لكائن المشاركات، فإنك تحتاج إلى طلب الحقول الفرعية أيضًا لاسترداد البيانات.

"shares": {
  "data": [{
    "template": {
      "payload":{
        "product": {
           "elements":{     //Can contain multiple products if applicable
             "data": [
              {
                "id" : "PRODUCT-ID",    // 0 if business can't see this product
                "retailer_id": "ID-ASSIGNED-BY-THE-RETAILER", 
                "image_url" : "IMAGE-URL", 
                "name" : "PRODUCT-NAME",
                "price" : "$10"
              },
            ],
          }
        }
      }
    }
  }]
}

story

array (مصفوفة)

رابط القصة ومعرفها. عمليات الذكر والردود هما المدعومان فقط.

StoryReply: 
{
    "link": "CDN-URL",
    "id": "STORY-ID"
}

StoryMention: 
{
    "link": "CDN-URL",
    "id": "STORY-ID"
}

tags

object (كائن)

مصفوفة data تحتوي على أسماء علامات تشير إلى مجلد الرسالة ومصدر الرسالة.

  • بالنسبة لصفحات فيسبوك، فإن name يمكن أن يكون inbox، read، source:chat،

to

كائن
data array (مصفوفة)
id
email
name
username

معلومات حول متلقي الرسالة



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

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

اسم شخص أو صفحة فيسبوك. المراسلة على الصفحة فقط

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

"to": {
  "data": [
    { 
      "username": "INSTAGRAM-USERNAME", 
      "id": "ID" 
    }
  ]
}

عناصر الربط

الاسم الوصف

/attachments

الملفات المرفقة بالرسالة.

/shares

يمثل العناصر التي تمت مشاركتها، بما في ذلك الروابط والصور ومقاطع الفيديو والملصقات والمنتجات.

الإنشاء

لا يمكنك إجراء تلك العملية على نقطة النهاية هذه.

التحديث

لا يمكنك إجراء تلك العملية على نقطة النهاية هذه.

الحذف

لا يمكنك إجراء تلك العملية على نقطة النهاية هذه.