القنوات والمتابعات

إعدادان يحددان متى يتحدث ذكاء وكيلك الاصطناعي من تلقاء نفسه: القنوات التي يرد عليها، وهل يتابع العملاء الذين توقفوا عن الرد. عبر الواجهة البرمجية العامة تغيّر الاثنين من أنظمتك، كإيقاف الرد على التعليقات أثناء حملة، أو إيقاف المتابعات خارج ساعات العمل.

ما القنوات التي أتحكّم فيها؟

كل قناة متصلة بالوكيل: صفحات فيسبوك، وحسابات إنستجرام، وأرقام واتساب، ومنها المفصولة (active: false) التي تستطيع عرضها لا تغييرها (409 connection_inactive). اعرضها لتحصل على معرّف كل اتصال وإعداداته الحالية.

curl https://api.mojeeb.app/v1/agents/YOUR_AGENT_ID/connections \
  -H "Authorization: Bearer mk_live_YOUR_KEY_HERE"

كل اتصال يبيّن respond_to_messages وrespond_to_comments. يبقى ربط القناة وفصلها في لوحة التحكم لأنهما يحتاجان تسجيل الدخول عبر ميتا. راجع مرجع عرض القنوات المتصلة.

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

كيف أوقف الذكاء الاصطناعي في التعليقات أو الرسائل؟

أرسل PATCH إلى الاتصال بالإعداد الذي تريده. أرسل واحداً أو الاثنين.

curl -X PATCH https://api.mojeeb.app/v1/agents/YOUR_AGENT_ID/connections/CONNECTION_ID \
  -H "Authorization: Bearer mk_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{ "respond_to_comments": false }'

مع إيقاف الرسائل، تصل الرسائل الواردة إلى لوحة التحكم ويرد عليها فريقك، ولا يرد عليها الذكاء الاصطناعي. لكن المتابعات تستمر على تلك القناة: المجدولة مسبقاً تُرسَل، وبعد رد أحد أعضاء الفريق قد يكتب الذكاء الاصطناعي مرة أخرى حين تنتهي مدة الإيقاف الخاصة بالوكيل. ومع تشغيل التعليقات، قد يرسل رد الذكاء الاصطناعي على تعليقٍ رسالةً خاصة واحدة لصاحبه. ومع إيقاف التعليقات، لا يرد الذكاء الاصطناعي على تعليقات تلك القناة. فإن كان الإخفاء التلقائي للتعليقات مفعّلًا للوكيل، يظل مجيب يسجّلها ويُخفي السلبي منها (راجع التعليقات والإخفاء التلقائي)؛ ومع إيقاف الإخفاء التلقائي أيضًا يتجاهلها مجيب: ما يصل منها أثناء إيقاف الاثنين لا يُسجَّل، وإعادة التشغيل لا تجلبه. تنطبق التعليقات على فيسبوك وإنستجرام. راجع التعليقات الاجتماعية لترى كيف تعمل الردود على التعليقات.

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

إعادة ربط القناة من لوحة التحكم، ومنها حين تطلب ميتا تسجيل الدخول من جديد، تضبط الإعدادين حسب شاشة الربط (مُفعَّلان افتراضياً)، فأرسل إعداداتك عبر الواجهة البرمجية مرة أخرى بعدها.

كيف تعمل المتابعات؟

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

كيف أغيّر إعدادات المتابعة؟

أرسل PATCH بالأجزاء التي تريد تغييرها فقط: enabled أو platforms أو steps. تحل platforms محل القائمة كلها، فأرسل كل منصة تريد أن تعمل عليها المتابعات. وحين ترسل steps تحل محل كل الخطوات، ويرتّبها مجيب حسب التأخير.

curl -X PATCH https://api.mojeeb.app/v1/agents/YOUR_AGENT_ID/follow-up-settings \
  -H "Authorization: Bearer mk_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{ "enabled": true, "platforms": ["whatsapp", "instagram"], "steps": [ { "delay_minutes": 60 }, { "delay_minutes": 1380 } ] }'

يتحقق مجيب من كل شيء قبل أن يغيّر أي شيء. المنصة غير المعروفة تُعيد 422 invalid_follow_up_platform، والتأخيرات المكرّرة أو خارج النطاق تُعيد 422 invalid_follow_up_steps. راجع مرجع تحديث إعدادات المتابعة.

أسئلة شائعة

ما القنوات التي تستخدمها المتابعات؟

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

ما حدود الخطوات؟

حتى ثلاث خطوات، ولا تتشارك خطوتان التأخير نفسه، وكل خطوة 23 ساعة على الأكثر بعد آخر رد للذكاء الاصطناعي، وهو الحد نفسه في لوحة التحكم. لا توصل ميتا الرسائل المرسلة بعد مرور 24 ساعة على آخر رسالة من العميل، والتأخير يُحسب من رد الذكاء الاصطناعي الذي يأتي بعد تلك الرسالة، فالساعة الأخيرة هامش أمان يُبقي كل متابعة داخل النافذة. والتأخير الأطول يعيد 422 invalid_follow_up_steps مع رسالة توضّح السبب.

هل يحذف إيقاف المتابعات خطواتي؟

لا. "enabled": false يوقف المتابعات ويحتفظ بالخطوات، فإعادة تشغيلها تستعيد التوقيت نفسه.

هل تعمل المتابعات بعد 24 ساعة؟

لا. يسمح واتساب وفيسبوك وإنستجرام بالرسائل الحرة خلال 24 ساعة فقط من آخر رسالة للعميل، ولهذا لا تتجاوز الخطوة 23 ساعة. وإن حان موعد متابعة بعد 24 ساعة رغم ذلك، كأن يأتي رد الذكاء الاصطناعي بعد رسالة العميل بوقت طويل، فلا تُسلَّم: على واتساب يتخطاها مجيب، وعلى فيسبوك وإنستجرام ترفضها ميتا.