إرسال رسالة

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

On July 23, 2024 we launched the new Instagram API with Instagram Login. An Instagram professional account – Business or Creator account – will no longer need to be linked to a Facebook Page in order to have conversations with customers, followers, or Instagram users interested in their business or Instagram account, manage comments, or publish media. Learn more about this new version in our blog post.

See our Instagram API with Instagram Login to learn more.

إخبار المستخدمين بأنك توفر تجربة تلقائية

عندما يقتضي القانون ذلك، يجب أن تفصح تجارب الدردشة التلقائية عن أن الشخص يتفاعل مع خدمة تلقائية:

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

يجب أن تولي تجارب الدردشة التلقائية التي تخدم المجموعات التالية عناية خاصة لهذا المتطلب:

سوق كاليفورنيا أو المستخدمون في كاليفورنيا
السوق الألماني أو المستخدمون في ألمانيا

وقد تتضمن عمليات الإفصاح، على سبيل المثال لا الحصر، ما يلي: "أنا البرنامج التلقائي لصفحة [اسم الصفحة]"، أو "أنت تتفاعل مع تجربة تلقائية"، أو "أنت تتحدث إلى برنامج تلقائي"، أو "أنا برنامج تلقائي للدردشة."

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

تفضل بزيارة سياسات المطوّرين لمزيد من المعلومات.

مكونات الرسائل

يجب أن تتضمن كل طلبات Send API المطلوبة لإرسال رسالة في تطبيقك ما يلي:

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

لمزيد من المعلومات حول مكونات الرسالة، تفضل بزيارة مرجع Send API.

نافذة المراسلة القياسية

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

قد تحتوي الرسائل المرسلة خلال النافذة الممتدة حتى 24 ساعة على محتوى ترويجي.

إجراءات المستخدم التي تفتح نافذة المراسلة القياسية

تفتح إجراءات المستخدم التالية نافذة المراسلة التي تستغرق 24 ساعة:

يرسل الشخص رسالة إلى الصفحة أو الحساب الاحترافي على Instagram
ينقر الشخص على زر دعوة لاتخاذ إجراء مثل "البدء المحادثة"
ينقر الشخص على إعلان النقر لفتح محادثة في Messenger ثم يرسل رسالة إلى الصفحة أو الحساب الاحترافي على Instagram
يرسل الشخص رسالة إلى الصفحة عبر المكون الإضافي، مثل المكون الإضافي "إرسال إلى Messenger" أو "مربع الاختيار"
ينقر الشخص على رابط m.me الذي ينقله إلى محادثة موجودة بين الشخص والصفحة
ينقر الشخص على رابط ig.me ينقله إلى محادثة موجودة بين الشخص والحساب الاحترافي على Instagram
يتفاعل الشخص على رسالة، مثل رسالة تسويقية
يعلق الشخص على منشور في الصفحة أو الحساب الاحترافي على Instagram
ينشر الشخص منشور زائر على الصفحة

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

معرفات المستلم

يتم تعيين معرف الشخص متلقي الرسالة في معلمة الكائن recipient ويمكن أن يكون أحد أنواع المعرفات التالية:

المعرف على مستوى الصفحة (PSID) – المعرف الذي يتم تخصيصه للشخص في أول مرة يرسل رسالة إلى الصفحة. يمثل هذا المعرف الفريد التفاعلات بين الصفحة والشخص.
مرجع المستخدم – المعرف الذي يتم تخصيصه للشخص الذي استخدم المكون الإضافي أو زر الرد الجاهز لإرسال رسالة إلى الصفحة.
معرف المنشور أو التعليق: المعرف الذي يتم تخصيصه إلى الشخص الذي نشر منشورًا على الصفحة أو علق على منشور ما. ويُستخدم لإرسال رد خاص إلى الشخص.

يُرجى ملاحظة أن عمليات دمج معرف المستخدم من تسجيل دخول فيسبوك تكون على مستوى التطبيق ولن تعمل مع منصة Messenger.

أنواع المراسلة

يتم تعيين نوع الرسالة الذي ترسله في المعلمة messaging_type. تُعد هذه المعلمة طريقة أكثر وضوحًا لضمان امتثال الرسائل إلى سياسات المراسلة وتفضيلات المستلم.

يتم دعم أنواع الرسائل التالية:

الاستجابة – تُعد الرسالة التي ترسلها استجابةً لرسالة تم استلامها. يمكن أن تتضمن الرسالة محتوى ترويجيًا وغير ترويجي ويجب إرسالها أثناء التواجد في نافذة المراسلة القياسية.
التحديثات – يتم إرسال الرسالة التي ترسلها بشكل استباقي وليس ردًا على رسالة مستلمة. يمكن أن تتضمن الرسالة محتوى ترويجيًا وغير ترويجي ويجب إرسالها أثناء التواجد في نافذة المراسلة القياسية.
الرسالة التي تحتوي على إشارة – يتم إرسال الرسالة التي ترسلها خارج نافذة الرسائل القياسية. يجب أن تتضمن هذه الرسالة إشارة الرسالة التي تطابق حالة الاستخدام المسموح بها للإشارة وتحتوي على محتوى غير ترويجي.

إشارات الرسائل

تسمح لك إشارات الرسائل بإرسال رسالة خارج نافذة الرسائل القياسية. تُعد هذه الرسائل تحديثات ذات صلة بالنسبة للشخص. على سبيل المثال، يمكنك إرسال تحديثات حول الشحن والتسليم أو مواعيد الحجوزات أو رحلات الطيران القادمة أو تنبيهات بشأن حساب العميل. بالنسبة إلى تدفقات المراسلة التي تتطلب مسار تصعيد، تسمح إشارة الوكيل البشري لممثل النشاط التجاري بالرد يدويًا على رسائل الشخص خلال 7 أيام.

لا يجوز استخدام إشارات الرسائل في إرسال محتوى ترويجي، بما في ذلك على سبيل المثال لا الحصر الصفقات والعروض والقسائم والخصومات. قد يؤدي استخدام إشارات الرسائل خارج حالات الاستخدام المعتمدة إلى فرض قيود على إمكانية الصفحة أو حساب Instagram لإرسال الرسائل. راجع سياسة منصة Messenger وAPI المراسلة في Instagram لمزيد من التفاصيل.

يتعين على الأنشطة التجارية التي تستخدم منصة Messenger وتريد إرسال رسائل ترويجية خارج إطار المراسلة القياسية الذي يبلغ 24 ساعة، استخدام الرسائل المُموَّلة أو الإشعارات لمرة واحدة.

أنواع المحتوى

قد تتضمن الرسالة التي ترسلها أنواع المحتوى التالية:

مقطع صوتي
الأزرار
الملفات

القوائم
صور GIF
الصور

القوالب
النص
مقاطع الفيديو

إرسال نص أساسي

لإرسال رسالة نصية أساسية إلى الشخص الذي أرسل رسالة إلى الصفحة، أرسل طلب POST إلى نقطة النهاية /PAGE-ID/messages، مع تعيين recipient لمفتاح الكائن id الحرفي على معرف الشخص على مستوى الصفحة (PSID)، وتعيين المعلمة message_type على RESPONSE وتعيين text كائن المعلمة message على نص الرسالة.

عينة من الطلب

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"{PSID}"
  },
  "messaging_type": "RESPONSE",
  "message":{
    "text":"Hello, world!"
  }
}' "https://graph.facebook.com/v21.0/{PAGE-ID}/messages?access_token={PAGE-ACCESS-TOKEN}"

في حالة نجاح العملية، سيتلقى التطبيق استجابة JSON التالية التي تتضمن معرف المستلم ومعرف الرسالة.

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U..."
}

إرسال مرفق وسائط

لإرسال رسالة تتضمن وسائط، مثل صورة GIF أو صورة أو قالب، يمكنك إضافة المحتوى إلى طلب API في كائن مرفق رسالة JSON.

لإرسال رسالة تتضمن صورة إلى الشخص الذي أرسل رسالة إلى الصفحة، أرسل طلب POST إلى نقطة النهاية /PAGE-ID/messages، مع تعيين recipient لمفتاح الكائن id الحرفي على معرف الشخص على مستوى الصفحة (PSID)، وتعيين المعلمة message_type على RESPONSE وتعيين مفتاح type للكائن attachment في المعلمة message على image وتعيين مفتاح url للكائن payload على عنوان URL للصورة.

عينة من الطلب

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"1254459154682919"
  },
  "message":{
    "attachment":{
      "type":"image", 
      "payload":{
        "url":"http://www.messenger-rocks.com/image.jpg", 
        "is_reusable":true
      }
    }
  }
}' "https://graph.facebook.com/v21.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

في حالة نجاح العملية، سيتلقى التطبيق استجابة JSON التالية التي تتضمن معرف المستلم ومعرف الرسالة.

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U..."
}

سيتم استخدام التنسيق ذاته عند إرسال مقطع صوتي أو فيديو أو ملف من عنوان URL.

كما يمكنك إرسال الوسائط من الخادم أو من المحتوى الذي قمت بتحميله مسبقًا إلى خادم Meta. تعرف على المزيد حول تحميل الملفات باستخدام API تحميل المرفقات.

أفضل الممارسات

الرسائل النصية

اجعل الرسالة موجزة. ويجب مراعاة حجم الشاشة وسلوك التمرير؛ حيث تُعد متابعة الرسائل المدمجة أسهل بالنسبة للأشخاص. حاول إرسال بضع رسائل منفصلة بدلاً من رسالة واحدة طويلة.

لا تستخدم النص كبديل للصور والجداول والمخططات. قد تتناسب الرسائل ذات البنية المحددة أو طريقة عرض الويب مع احتياجاتك بشكل أفضل.

لا تكتب حوارات مطولة. إذا كنت بحاجة إلى توصيل معلومات متعددة، فحاول إرسال بعض الرسائل المنفصلة بدلاً من إرسال رسالة واحدة طويلة.

المرفقات

اهتم بالجودة. واستخدم صورًا ملونة بدقة عالية لجذب الانتباه إلى رسائلك.

اتبع معايير نسبة العرض إلى الارتفاع. وراجع كيف يمكن أن يتم اقتصاص صورتك عندما تظهر في فقاعة الرسالة.

لا تحاول تضمين قدرًا كبيرًا من النصوص في صورتك. استخدم رسالة نصية بدلاً من ذلك، أو ادمج الصور والنص مع قالب عام.

الخطوات التالية

تعرف على المكونات التي يمكنك إضافتها إلى الرسائل في المحادثات.

معرفة المزيد

تعرف على المزيد حول إرسال الرسائل باستخدام منصة Messenger.

مرجع API تحميل المرفقات – تعرف على المزيد حول تحميل الوسائط وإرسالها.
مرجع Send API – تعرف على المزيد حول كل الإشارات والمحتوى والمرفقات التي يمكنك إرسالها.
تقييدات معدلات الاستدعاء – تعرف على تقييدات معدلات الاستدعاء لإرسال الرسائل باستخدام منصة Messenger.

دعم المطوّر

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

إرسال رسالة

إخبار المستخدمين بأنك توفر تجربة تلقائية

مكونات الرسائل

نافذة المراسلة القياسية

معرفات المستلم

أنواع المراسلة

إشارات الرسائل

أنواع المحتوى

إرسال نص أساسي

عينة من الطلب

إرسال مرفق وسائط

عينة من الطلب

أفضل الممارسات

الرسائل النصية

المرفقات

المزيد من أنواع الرسائل

الرسائل الإخبارية (قيد التطوير)

الإشعارات لمرة واحدة

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

الرسائل التسويقية

الرسائل المُموَّلة

الخطوات التالية

معرفة المزيد

دعم المطوّر