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

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

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

​

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

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

​

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

​

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

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

​

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

اربط WhatsApp Business Account عبر تدفق embedded signup من Meta مباشرةً من لوحة تحكم Ayrshare:

• ستحتاج إلى حساب Meta Business Manager وWhatsApp Business Account (WABA) ورقم هاتف مؤهَّل. تتحقق Meta من الحساب ورقم الهاتف أثناء embedded signup.
• في صفحة Social Accounts، انقر على Link في بطاقة WhatsApp. يُطلق Ayrshare نافذة embedded signup المنبثقة من Meta التي تُرشد العميل خلال اختيار/إنشاء Business Manager وWABA ورقم الهاتف، وقبول شروط Meta.
• عند انتهاء signup، يتحقق Ayrshare من ملكية WABA ورقم الهاتف المحدَّدَين، ويُكمل التسجيل، ويشترك الحساب في webhooks WhatsApp. لا تُدخل PIN تسجيل منفصلًا في لوحة تحكم Ayrshare.

​

سلوك خاص مهم بـ WhatsApp

• المستلمون هم أرقام هواتف، وليسوا معرّفات. يُعرِّف WhatsApp المراسلين برقم هاتف بصيغة E.164 (أرقام فقط، بدون +). كما أن معرّفات المحادثات التي يعيدها Ayrshare هي أيضًا رقم هاتف المراسل — لا توجد معرّفات محادثة مبهمة كتلك التي يستخدمها Facebook وInstagram.
• نافذة خدمة العملاء لمدة 24 ساعة. يسمح WhatsApp Business فقط بإرسال رسائل حرة الشكل خلال 24 ساعة من آخر رسالة أرسلها المراسل. خارج هذه النافذة ترفض Meta الإرسال. الرسائل القالبية خارج نافذة الـ 24 ساعة غير مدعومة حاليًا عبر Ayrshare.
• خاطب المستلم مباشرةً عبر API. مرّر رقم هاتف المستلم إلى Send Message. لا تُسلِّم Meta الرسالة حرة الشكل إلا عندما يكون هذا المستلم داخل نافذة خدمة العملاء لمدة 24 ساعة. القوالب المُعتمدة مطلوبة للتواصل البارد، ولا يُتيح Ayrshare حاليًا إرسال القوالب.
• حالة التسليم تستخدم حقلًا واحدًا. عند توفرها على رسالة صادرة مخزَّنة، يعيد Get Messages قيمة status كـ sent أو delivered أو read أو failed. تحديثات حالة التسليم وتفاعلات WhatsApp لا يتم دفعها حاليًا إلى عنوان URL الخاص بـ webhook المسجَّل لديك.
• أنواع الوسائط وأحجامها تتّبع حدود WhatsApp Cloud API المنشورة من Meta — الصور حتى 5 ميغابايت، والصوت والفيديو حتى 16 ميغابايت، والمستندات حتى 100 ميغابايت وقت كتابة هذا النص.

​

وسائط WhatsApp المدعومة

• صورة: .jpg, .jpeg, .png
• فيديو: .mp4, .3gp
• صوت: .aac, .amr, .mp3, .m4a, .ogg
• مستند: .txt, .pdf, .ppt, .pptx, .doc, .docx, .xls, .xlsx

​

تفعيل المراسلة في تطبيق 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 الرسائل لتلقّي الرسائل أو إيصالات القراءة أو التفاعلات تلقائيًا.