‏منصة Messenger‏

الردود الخاصة

يوضح لك هذا المستند كيفية إضافة الردود الخاصة برمجيًا إلى تجربة المراسلة.

طريقة العمل

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

عند استلام إشعار webhooks للحدث comments أو live_comments عبر واجهة Instagram Graph API، يفيد بأن شخص ما قد قام بالتعليق على منشور حسابك الاحترافي على Instagram أو منشور إعلانات أو مقطع ريلز أو قصة في بث مباشر، يمكنك استخدام معرف التعليق لإرسال رد خاص مباشرةً إلى هذا الشخص. سيتم تسليم هذا الرد في مجلد البريد الوارد للشخص، إذا كان الشخص يتابع الحساب الاحترافي على Instagram للنشاط التجاري أو تسليمه في المجلد طلب إذا كان الشخص لا يتابع الحساب.

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

Webhooks

  • عند استضافة قصة Instagram Live، تأكد من قدرة الخادم على معالجة الحمل الزائد للإشعارات التي يتم تشغيلها بواسطة أحداث webhooks عبر Instagram API لـ live_comments وأن النظام يمكنه التمييز بين إشعارات live_comments وcomments.
  • ستتضمن واجهة Instagram Graph API إشعارات webhooks للحدث comments في منشورات الإعلانات معرف الإعلان وعنوانه. قد تحتاج إلى تحديث خادم أحداث webhooks لمعالجة هذه الحقول الجديدة.

    سيتم إرجاع ad_id وad_title في كائن الوسائط عندما يعلِّق الشخص على منشور تم ترويجه على Instagram أو منشور إعلانات على Instagram. قد يؤدي هذا إلى تكرار إشعارات webhook.

التقييدات

  • لا يمكن إرسال سوى رسالة واحدة إلى الشخص الذي قام بالتعليق
  • يجب إرسال الرسالة في غضون 7 أيام من وقت إنشاء التعليق بالنسبة للتعليقات على المنشور أو منشور الإعلانات أو مقطع ريلز
  • نظرًا للطبيعة المؤقتة لقصص Instagram Live Stories، لا يمكن إرسال الردود الخاصة على تعليقات قصة Instagram Live إلا أثناء البث المباشر. بمجرد انتهاء البث المباشر، لا يمكن إرسال الردود الخاصة.
  • لا يمكنك متابعة المحادثة خلال فترة المراسلة التي تبلغ 24 ساعة إلا عندما يرد شخص على الرسالة الخاصة.
  • لا يمكن لتطبيقات الوصول القياسي الوصول سوى لبيانات الأشخاص الذين يتوفر لديهم دور في التطبيق
  • الردود الخاصة في تعليقات IGTV غير مدعومة
  • تحتاج API بالإصدار 7.0 أو الإصدارات الأقدم إلى ميزة الوكيل البشري وإشارة رسالة الوكيل البشري لإرسال الردود الخاصة

قبل البدء

يفترض هذا العرض التوضيحي أنك قرأت نظرة عامة على منصة Messenger ونظرة عامة على المراسلة في Instagram وقمت بتنفيذ المكونات المطلوبة.

ستحتاج إلى ما يلي:

  • معرف صفحة فيسبوك المرتبطة بحسابك الاحترافي على Instagram
  • معرف التعليق الذي نشره الشخص الذي ترسل إليه الرد الخاص. يمكن الحصول على المعرف من أحداث webhooks لـ comments في Instagram، للمنشورات ومنشورات الإعلانات ومقاطع ريلز وأحداث webhooks لـ live_comments في Instagram بالنسبة للقصص في البث المباشر (موصى بها لتجنب تقييد معدلات الاستدعاء) أو من خلال إرسال استدعاء API لنقطة النهاية /page/feed
  • الإذنان instagram_manage_comments وpages_messaging، اللذان يتم الحصول عليهما عبر تسجيل دخول فيسبوك
  • رمز وصول الصفحة الذي تم طلبه بواسطة الشخص الذي يمكنه تنفيذ المهمة MESSAGING في صفحة فيسبوك المرتبطة بحسابك الاحترافي على Instagram
  • ميزة الوكيل البشري
  • الوصول المتقدم

إرسال رد خاص

لإرسال رد خاص لشخص قام بالتعليق على منشور أو مقطع ريلز أو قصة في بث مباشر، أرسل طلب POST إلى نقطة النهاية /PAGE-ID/messages حيث تحتوي المعلمة recipient على معرف التعليق وتحتوي المعلمة message على النص الذي تود إرساله.

تم التنسيق لإمكانية القراءة.
curl -i -X POST "https://graph.facebook.com/PAGE-ID/messages
  ?recipient: { comment_id: COMMENT-ID }
  &message: { "text": "Thanks for reaching out, how can I help?" }
  &access_token=PAGE-ACCESS-TOKEN"
GraphRequest request = GraphRequest.newPostRequest(
  accessToken,
  "/1353269864728879/messages",
  new JSONObject("{\"recipient\":\"{comment_id: 18000158536435933}\",\"message\":\"{\\\"text\\\": \\\"It is cool\\\"}\"}"),
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});
request.executeAsync();
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/1353269864728879/messages"
           parameters:@{ @"recipient": @"{comment_id: 18000158536435933}",@"message": @"{"text": "It is cool"}",}
           HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];
FB.api(
  '/1353269864728879/messages',
  'POST',
  {"recipient":"{comment_id: 18000158536435933}","message":"{\"text\": \"It is cool\"}"},
  function(response) {
      // Insert your code here
  }
);

عند نجاح العملية، سيتلقى تطبيقك الاستجابة التالية:

{
  "recipient_id": "526...",   // The Instagram-scoped ID 
  "message_id": "aWdfZ..."    // The message ID for your private reply
}

راجع أيضًا

دعم المطوّر

  • استخدم أداة حالة Meta للتحقق من حالة منتجات الأنشطة التجارية في Meta وحالات الانقطاع.
  • استخدم أداة دعم مطوّر Meta للإبلاغ عن الأخطاء وعرض الأخطاء التي تم الإبلاغ عنها والحصول على المساعدة بشأن الإعلانات أو مدير الأعمال والمزيد.
  • تفضل بزيارة موارد الدعم في منصة Messenger لعرض المزيد من الموارد المخصصة لدعم منصة Messenger.