نظرة عامة على واجهة برمجة تطبيقات الرسائل

تتيح لك Messaging API إدارة الرسائل المباشرة (DM) للمراسلين الذين يتواصلون مع ملفات المستخدمين الخاصة بك. المراسل هو الشخص الذي يتواصل معه مستخدمك (User Profile). المحادثة هي سلسلة من الرسائل بين مستخدمك (User Profile) ومراسله.

• Messaging API مُضمَّنة في جميع خطط Ayrshare Business وكإضافة مدفوعة لخطط Premium.
• لكل من خطط Business وPremium، يجب عليك تفعيل المراسلة في صفحة Account في لوحة تحكم Ayrshare.
• تتوفر المراسلة لـ Facebook Messenger وInstagram Direct Messenger وX Direct Messages.

​

ميزات المراسلة الرئيسية

• أدر محادثات مستخدميك مع المراسلين.
• إرسال رسائل نصية وصور وفيديو ورموز تعبيرية نيابةً عن مستخدميك.
• استرجاع سجلات محادثات كاملة.
• إعداد ردود رسائل تلقائية.
• استلام تحديثات في الوقت الفعلي عبر webhooks للرسائل المُستلَمة، وتفاعلات الرسائل، وإيصالات القراءة.

​

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

​

تفعيل حساب Ayrshare وملفات المستخدمين

يجب عليك أولاً تفعيل المراسلة لحساب Ayrshare العام لديك لإدارة الرسائل المباشرة. في لوحة تحكم Ayrshare انتقل إلى صفحة Account وانقر فوق زر “Learn More” ثم “Enable”. عند هذه النقطة قمت بتفعيل المراسلة لحسابك العام، لكنك لم تُفعّل المراسلة لملفات المستخدمين الفرديين. يمكنك تفعيل المراسلة لملفات المستخدمين الفرديين إما في صفحة User Profiles بالنقر على مربع الاختيار “Messaging Active” لكل ملف تعريف أو باستخدام نقطة نهاية profiles لإنشاء أو تحديث. بعد تفعيل المراسلة لملف تعريف مستخدم، يجب عليك إعادة ربط الحساب الاجتماعي (Facebook وInstagram) في صفحة Social Accounts/Social Linking. بمجرد التفعيل، سترى شارة “Messaging” على الحساب الاجتماعي المرتبط.

​

تفعيل المراسلة في تطبيق Instagram

قد تحتاج إلى تفعيل المراسلة لحساب Instagram الخاص بك:

• انتقل إلى ملفك الشخصي في تطبيق Instagram للجوال واضغط على أيقونة القائمة ≡ في الزاوية العلوية اليمنى للانتقال إلى صفحة Settings and activity.
• مرر لأسفل إلى قسم How others can interact with you.
• انقر على Messages and story replies.
• اضغط على Message requests.
• ضمن Connected tool فعّل مفتاح Allow access to messages.

​

معلومات مهمة حول المراسلة

​

استرجاع سجل الرسائل لـ Facebook وInstagram

عندما تُفعّل المراسلة لأول مرة لملف تعريف مستخدم مع Facebook أو Instagram مرتبط، هناك قيود مهمة على الوصول إلى سجل المحادثات:

​

قيود الاتصال الأولي

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

​

بعد الإعداد الأولي

• بمجرد تفعيل المراسلة، ستكون جميع الرسائل الجديدة المُرسَلة والمُستقبَلة قابلة للوصول بالكامل
• يحتفظ Ayrshare بسجل محادثات كامل للمُضي قدمًا
• على سبيل المثال: إذا استرجعت في البداية 20 رسالة، ثم تم تبادل 100 رسالة جديدة، فستتمكن من الوصول إلى جميع الرسائل الـ 120 معًا

هذا القيد ينطبق فقط على الرسائل التاريخية التي كانت موجودة قبل تفعيل المراسلة — سيتم الحفاظ على جميع نشاط المحادثة المستقبلي لـ Facebook وInstagram وسيكون قابلًا للوصول بالكامل.

​

حد المحادثة والتسعير

• يمكن لكل ملف تعريف مستخدم في Ayrshare أن يحتوي على ما يصل إلى 1,000 محادثة نشطة لكل دورة فوترة. عدد المحادثات النشطة هو الإجمالي عبر جميع شبكات التواصل الاجتماعي.
• خطة Premium: المراسلة إضافة ثابتة بسعر 49 دولارًا شهريًا لكل حساب.
• خطط Launch وBusiness: تُحسب فاتورة المراسلة بسعر 0.09 دولار لكل محادثة نشطة عبر فوترة Stripe المُقاسة. تتوفر خصومات حسب الحجم؛ تواصل مع ممثل حساب Ayrshare للحصول على التفاصيل.
• تُعد المحادثة نشطة لدورة الفوترة عندما ترسل رسالة إلى مستلم. الرسائل الواردة من مستلم لا تجعل، بمفردها، محادثة نشطة.
• إذا تم الوصول إلى حد 1,000 محادثة، يمكنك لا تزال تلقي الرسائل، لكنك لن تتمكن من الرد حتى بداية دورة الفوترة التالية.
• عدد الرسائل، المُرسَلة أو المُستقبَلة، في محادثة نشطة غير محدود.
• إذا كنت بحاجة إلى زيادة حد المحادثة، يرجى الاتصال بممثل حساب Ayrshare الخاص بك.

يمكنك رؤية عدد المحادثات الحالي مع نقطة نهاية user.

​

مشكلات التحكم في المراسلة على Facebook وInstagram

يستخدم Meta (Facebook وInstagram) نظام “thread control” لمحادثات المراسلة. هذا يعني أنه يمكن لتطبيق واحد فقط إرسال الرسائل في محادثة في وقت واحد، بينما يمكن للتطبيقات الأخرى فقط استقبال الرسائل.

​

ماذا يعني هذا؟

إذا رأيت الخطأ “Message failed to send because another app is controlling this thread now”، فهذا يعني:

• تطبيق طرف ثالث مختلف يتحكم حاليًا في تلك المحادثة
• يستطيع Ayrshare فقط استقبال الرسائل في تلك المحادثة
• لا يستطيع Ayrshare إرسال الرسائل حتى يستعيد التحكم

​

كيفية إصلاح هذه المشكلة

للسماح لـ Ayrshare بإرسال الرسائل مرة أخرى، يجب عليك إزالة تطبيق الطرف الثالث الذي يتحكم في المحادثة. يرجى ملاحظة أن Meta (Facebook وInstagram) قد يُحدّث عملية إزالة تطبيقات الطرف الثالث، لذا استخدم الخطوات التالية كإرشاد عام. لصفحات Facebook:

1. انتقل إلى Facebook.com وسجّل الدخول إلى حسابك
2. انقر على القائمة (☰) في أعلى اليمين ← Settings & Privacy ← Settings
3. في الشريط الجانبي الأيسر، انقر على Apps and Websites
4. ابحث عن تطبيق الطرف الثالث الذي يتحكم في مراسلتك
5. انقر على Remove بجانب هذا التطبيق
6. أكّد الإزالة

لحسابات Instagram Business:

1. افتح تطبيق Instagram على هاتفك
2. انتقل إلى Profile ← اضغط على القائمة (☰) ← Settings and Privacy
3. اضغط على Apps and Websites
4. ابحث عن تطبيق الطرف الثالث وأزله

بديل لـ Instagram:

1. انتقل إلى business.facebook.com
2. انتقل إلى Business Settings
3. تحت Accounts، انقر على Instagram Accounts
4. اختر حساب Instagram الخاص بك
5. تحقق من التطبيقات المتصلة وأزل التطبيق الذي يسبب المشكلة

​

بعد الإزالة

بمجرد إزالة تطبيق الطرف الثالث:

• سيعود التحكم في المحادثة تلقائيًا إلى Ayrshare
• يجب أن تكون قادرًا على إرسال الرسائل بشكل طبيعي مرة أخرى
• لا يلزم اتخاذ أي إجراء آخر من جانبك

إذا استمرت في مواجهة مشكلات بعد إزالة التطبيق، يرجى الاتصال بفريق الدعم.

​

Webhooks الرسائل

راجع Webhooks الرسائل لتلقّي الرسائل أو إيصالات القراءة أو التفاعلات تلقائيًا.