مرجع API الإرسال
API الإرسال هي API الرئيسية المستخدمة في إرسال الرسائل إلى المستخدمين، بما في ذلك نص الرسالة والمرفقات والقوالب وإجراءات المرسلين وغير ذلك الكثير.
الإنشاء
أنشئ رسائل وأرسلها إلى عملائك أو الأشخاص المهتمين بصفحتك على فيسبوك.
قبل البدء
ستحتاج إلى ما يلي:
- رمز وصول الصفحة الذي يطلبه شخص يمكنه تنفيذ المهمة
MESSAGEبالصفحة - الإذن
pages_messaging - يجب أن يكون مستلم الرسالة قد أرسل إلى صفحتك رسالة خلال آخر 24 ساعة أو وافق على تلقي رسائل من صفحتك خارج فترة المراسلة القياسية التي مدتها 24 ساعة
التقييدات
- لا يمكن استخدام إشارات الرسائل في إرسال محتوى ترويجي
لاحظ أن API الإرسال لا تتضمن recipient_id في الاستجابة للرسائل المرسلة باستخدام recipient.user_ref أو recipient.phone_number لتحديد مستلم الرسالة.
عينة من الطلب
لإرسال رسالة إلى شخص، أرسل طلب POST إلى نقطة نهاية /PAGE-ID/messsages مع تعيين المعلمتان messaging_type وrecipient، ومحتوى الرسالة.
يمثل المثال التالي استجابة لرسالة شخص، عندما تكون الرسالة التي ترسلها صفحتك هي رسالة نصية فقط.
curl -X POST "https://graph.facebook.com/v21.0/{PAGE_ID}/messages" \
-d "recipient={'id':'{PSID}'}" \
-d "messaging_type=RESPONSE" \
-d "message={'text':'hello, world'}" \
-d "access_token={PAGE_ACCESS_TOKEN}"
عند نجاح العملية، سيتلقى تطبيقك استجابة JSON التالية:
{
"recipient_id": "PAGE-SCOPED-ID",
"message_id": "AG5Hz2U..."
}
المعلمات
| المعلمة | الوصف |
|---|---|
| نوع الرسالة التي ترسلها صفحتك. يجب تعيين
|
مطلوب | نوع الرسالة التي يتم إرسالها
|
| نوع الإشعار المباشر الذي سيتلقاه الشخص
|
مطلوب | الشخص الذي سيتلقى الرسالة التي ترسلها صفحتك
|
| أيقونة الإجراءات التي تظهر في نافذة المراسلة والتي تمثل الإجراء الذي اتخذته الصفحة بشأن رسالة تلقتها الصفحة من جانب شخص ما.
لا يمكن أن تُرسَل إلّا باستخدام المعلمة |
| إشارة تمكّن صفحتك من إرسال رسالة إلى شخص ما خارج فترة المراسلة القياسية التي تبلغ 24 ساعة.
|
حالات استخدام إشارة الرسالة
يتضمن الجدول التالي أنواع المراسلة لكل إشارة رسالة.
| إشارة الرسالة | الاستخدام |
|---|---|
| الاستخدامات المسموح بها
الاستخدامات غير المسموح بها (على سبيل المثال لا الحصر)
غير متوفرة لـ API المراسلة في Instagram. |
| الاستخدامات المسموح بها
الاستخدامات غير المسموح بها (على سبيل المثال لا الحصر)
غير متوفرة لـ API المراسلة في Instagram. |
| الاستخدامات المسموح بها
الاستخدامات غير المسموح بها (على سبيل المثال لا الحصر)
غير متوفرة لـ API المراسلة في Instagram. |
| الاستخدامات المسموح بها
الاستخدامات غير المسموح بها (على سبيل المثال لا الحصر)
مطلوب لـ API المراسلة في Instagram. |
| الاستخدامات المسموح بها
الاستخدامات غير المسموح بها (على سبيل المثال لا الحصر)
غير متوفرة لـ API المراسلة في Instagram. |
القراءة
لا يمكنك إجراء تلك العملية على نقطة النهاية هذه.
للحصول على معلومات حول المحادثات التي تُعد صفحتك جزءًا منها، تفضل بزيارة مرجع محادثات الصفحة.
التحديث
لا يمكنك إجراء تلك العملية على نقطة النهاية هذه.
الحذف
لا يمكنك إجراء تلك العملية على نقطة النهاية هذه.
راجع أيضًا
دعم المطوّر
- استخدم أداة حالة Meta
للتحقق من حالة منتجات الأنشطة التجارية في Meta وحالات الانقطاع.
- استخدم أداة دعم مطوّر Meta للإبلاغ عن الأخطاء وعرض الأخطاء التي تم الإبلاغ عنها والحصول على المساعدة بشأن الإعلانات أو مدير الأعمال والمزيد.
- تفضل بزيارة موارد الدعم في منصة Messenger لعرض المزيد من الموارد المخصصة لدعم منصة Messenger.