التوثيق

التطبيقات والتكاملات

اربط الأدوات التي يستخدمها فريقك بالفعل — Stripe وShopify وMailchimp وMailerLite وJira وTracio. تعرض التطبيقات المثبَّتة بيانات العملاء الحية كبطاقات في لوحة المحادثة داخل صندوق الوارد، بجوار الدردشة مباشرة.

نظرة عامة#

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

تثبيت على مستوى مساحة العمل

مجموعة واحدة من بيانات الاعتماد لكل مساحة عمل. تثبيت تطبيق أو تحريره أو إزالته يؤثر على الجميع دفعة واحدة.

بطاقات في صندوق الوارد

يرسم كل تطبيق مثبَّت بطاقة في لوحة المحادثة ببيانات حية عن الشخص الذي تتحدث معه.

لا حشو

كل ما هو مدرج في الكتالوج يمكن تثبيته اليوم — لا يوجد قسم "قريباً". تتيح لك بطاقة الطلب إخبارنا بالخدمة الناقصة.

تتطلب إدارة التطبيقات صلاحية تثبيت التطبيقات وتهيئتها (مضمَّنة في دوري المالك والمسؤول افتراضياً، ويمكن منحها للأدوار المخصصة). أعضاء الفريق الذين لا يملكونها يستمرون في رؤية بطاقات التطبيقات في المحادثات — لكنهم لا يستطيعون تثبيت أي شيء أو إعادة تهيئته.

كتالوج التطبيقات#

ستة تطبيقات متاحة اليوم:

التطبيقالفئةما يراه موظفو الدعم في المحادثة
Stripeالمدفوعاتالاشتراك والمدفوعات الأخيرة للشخص الذي تتحدث معه
Shopifyالتجارةالطلبات الأخيرة مع حالة الدفع والتنفيذ
Mailchimpالتسويقحالة الاشتراك والجمهور والوسوم للشخص الذي تتحدث معه
MailerLiteالتسويقحالة الاشتراك والمجموعات وتاريخ التسجيل للشخص الذي تتحدث معه
Jiraتتبع المشكلاتالمشكلات المرتبطة بهذه المحادثة، ونقرة واحدة لفتح مشكلة أخرى
Tracioالأمانبشري أم بوت: حكم Tracio على زائر أداة الدردشة

تبحث عن رابط بسيط إلى نظامك الخلفي الخاص؟ هذا لا يحتاج حساباً ولا رمزاً، لذا يقع في الإعدادات ← عام ← روابط إلى أنظمتك بدلاً من كتالوج التطبيقات.

تثبيت تطبيق#

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

الخطوةالوصف
1. راجع المعاينةقبل أن تلصق أي شيء، تعرض صفحة التهيئة عيّنة من البطاقة الدقيقة التي سيراها موظفو الدعم — مبنية ببيانات مختلَقة، لتعرف ما ستشاركه مع مساحة العمل قبل تخزين أي بيانات اعتماد.
2. أدخل بيانات الاعتمادالصق مفتاح API أو الرمز. تُشذَّب القيم تلقائياً — مسافة زائدة أو سطر جديد من النسخ واللصق لن يكسر التثبيت.
3. احفظ واختبرالحفظ يخزّن التهيئة؛ واختبار الاتصال يجري استدعاءً حقيقياً إلى المزوّد وهو ما يحوّل شارة الحالة إلى اللون الأخضر.

تحمل كل بطاقة تطبيق شارة حالة تخبرك أين يقف التثبيت:

الحالةالمعنى
لم يُختبربيانات الاعتماد مخزَّنة، لكن التطبيق لم يجب عن طلب حقيقي بعد.
متصلالمزوّد أجاب فعلاً — الاتصال متحقَّق منه، وليس محفوظاً فحسب.
يحتاج انتباهاًرفض المزوّد بيانات الاعتماد المخزَّنة (مفتاح مُلغى أو منتهي الصلاحية). تتوقف البطاقات عن الاتصال بالمزوّد حتى يحفظ المسؤول التطبيق أو يعيد اختباره.
خطأفشل شيء آخر — انظر التلميح.
معطَّلأوقف مسؤولٌ التطبيق. تختفي البطاقة من صندوق الوارد دون حذف بيانات الاعتماد.

بيانات الاعتماد والأمان#

بيانات اعتماد التطبيقات ملك لمساحة العمل، وتحفظها بضع قواعد آمنة:

  • مشفَّرة أثناء التخزين. الحقول السرية (مفاتيح API والرموز) تُشفَّر لكل مفتاح في التخزين ولا تُعرض مرة أخرى بعد الحفظ أبداً.
  • أدنى الصلاحيات حيثما يسمح المزوّد. ينبغي ربط Stripe بمفتاح مقيَّد يمكنه قراءة Customers وSubscriptions وCharges وInvoices — مع صلاحية كتابة Refunds فقط إذا كان موظفو الدعم سيستردون المدفوعات من المحادثة. إذا لصقت مفتاحاً كامل الصلاحيات فسيعمل أيضاً، لكن صفحة الإعدادات ستنصحك باستبداله.
  • نقل الوجهة يعيد طلب السر. تحرير حقل مرتبط ببيانات الاعتماد — نطاق متجر Shopify أو عنوان موقع Jira — يتطلب إدخال الرمز مجدداً، فلا يمكن أبداً إعادة توجيه بيانات اعتماد محفوظة إلى مضيف لم تكن مخصصة له.
  • الإلغاء يؤثر على مساحة العمل كلها. هناك تثبيت واحد لكل تطبيق لكل مساحة عمل: إذا دوّرت المفتاح أو ألغيته لدى المزوّد، تتوقف بطاقة كل عضو فريق عن العمل حتى يحدّثه مسؤول في الإعدادات ← التطبيقات.

بطاقات التطبيقات في صندوق الوارد#

بعد التثبيت، يظهر كل تطبيق كأداة في لوحة تفاصيل المحادثة داخل صندوق الوارد. فتح المحادثة يجلب بطاقة حية من المزوّد: من هو هذا العميل في Stripe، وطلباته الأخيرة في Shopify، وحالة اشتراكه في النشرة البريدية، ومشكلات Jira المرتبطة بالخيط، أو حكم Tracio على الزائر. تشير معظم البطاقات أيضاً إلى السجل المطابق في لوحة تحكّم المزوّد نفسه — أما حكم Tracio فيعيش بكامله داخل اللوحة.

البطاقات صادقة حين لا يوجد ما تعرضه. إذا لم يُعثر على العميل — أو لم تكن للمحادثة هوية قابلة للاستخدام — تقول البطاقة ذلك وتشرح السبب، بدلاً من عرض صندوق فارغ. تُخزَّن الاستجابات مؤقتاً لفترة وجيزة وتُقنَّن معدلاتها لكل تطبيق، فلا يستنزف صندوق وارد مفتوح حدود API لدى المزوّد.

البطاقات تتبع الهوية المتحقَّق منها#

تبحث Stripe وShopify وMailchimp وMailerLite عن العميل بعنوان بريده الإلكتروني — وفقط بعنوان متحقَّق منه فعلاً: عنوان تغطيه الهوية الموقَّعة للأداة (التحقق من الهوية)، أو عنوان المرسل في محادثة قناة البريد الإلكتروني. العنوان الذي كتبه الزائر في الدردشة فحسب لا يُستخدم للبحث إطلاقاً — وإلا لاستطاع أي شخص كتابة بريد عميل حقيقي ورؤية سجل مدفوعاته. في تلك الحالة تشرح البطاقة أن العنوان غير مدعوم بهوية متحقَّق منها.

لا تعتمد Jira وTracio على البريد الإلكتروني — بطاقات Jira تخص المشكلات المرتبطة بالمحادثة، وTracio يخص زائر الأداة — لذا تعمل حتى حين لا يوجد عنوان متحقَّق منه.

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

ما يعرضه كل تطبيق#

Stripe#

نافذة للقراءة فقط على فوترة العميل: الاسم والبريد الإلكتروني ورصيد الحساب ومعرّف عميل قابل للنسخ، إضافة إلى الاشتراك — شارة الحالة والخطة والقيمة الشهرية وتاريخ البدء — والمدفوعات الأخيرة مع أرقام الفواتير. الاسترداد هو عملية الكتابة الاختيارية الوحيدة: يجب أن يفعّل مسؤولٌ السماح بالاسترداد من لوحة المحادثة في إعدادات التطبيق (معطَّل افتراضياً)، ويحتاج المشغّل صلاحية تنفيذ الاسترداد والإلغاء، ويجب تأكيد كل استرداد بكتابة REFUND — لا يستطيع Stripe التراجع عن استرداد بعد إرساله.

Shopify#

طلبات أخيرة للقراءة فقط — رقم الطلب والتاريخ والإجمالي وحالة الدفع والتنفيذ — مع روابط إلى كل طلب وإلى سجل العميل في لوحة إدارة Shopify لديك. يُربط بنطاق متجرك ورمز Admin API من تطبيق مخصص بصلاحيتي read_customers و read_orders.

Mailchimp#

المشترك كما يراه Mailchimp: شارة الحالة والجمهور والوسوم والتفاعل ونشاط الحملات الأخير (الإرسال والفتح والنقر). يتوفر إجراء واحد: إلغاء الاشتراك، لتلبية طلب "توقفوا عن مراسلتي" دون مغادرة المحادثة. الإجراء غير قابل للتراجع عبر API — Mailchimp لا يسمح لأحد بالعودة إلا بنفسه عبر نموذج تسجيل — لذا يتطلب تأكيداً مكتوباً. لاحظ أن مفاتيح API لدى Mailchimp غير مقيَّدة النطاق: المفتاح الذي تربطه يستطيع قراءة كل شيء في الحساب وكتابته.

MailerLite#

حالة الاشتراك والمجموعات وتاريخ التسجيل والتفاعل ونشاط الحملات الأخير. إجراءان: إلغاء الاشتراك (قابل للتراجع — API لدى MailerLite يدعم إعادة الاشتراك) وإعادة الاشتراك، لإعادة شخص إلى القائمة بناءً على طلبه.

Jira#

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

كل إجراء يُنفَّذ من اللوحة محكوم بصلاحيات الأدوار — استخدام إجراءات التطبيقات لإلغاء الاشتراك وإعادته ومشكلات Jira، وتنفيذ الاسترداد والإلغاء للاسترداد. وحيث يقدّم تطبيق أيضاً مفتاح تفعيل قدرة على مستوى مساحة العمل — اليوم هو السماح بالاسترداد من لوحة المحادثة لدى Stripe — يقرر المفتاح ما إذا كانت القدرة موجودة أصلاً، وإيقافه يمنع الجميع، بمن فيهم مالك مساحة العمل.

Tracio: بشري أم بوت#

يجيب Tracio عن سؤال واحد بخصوص زائر أداة الدردشة: أهذا بشري أم بوت؟ تثبيت التطبيق يفعّل SDK الكشف لدى Tracio داخل أداة دردشة Respondo لديك — تحصل محادثات الأداة الجديدة على حكم تلقائياً، يظهر كشارة على بطاقة Tracio في لوحة المحادثة.

الشارةالمعنى
بشريلم يجد فحص Tracio من جهة الخادم أي إشارات بوت لهذا الزائر.
بوت · 93%اكتُشف بوت، مع درجة ثقة Tracio. تسرد البطاقة أيضاً الإشارات التي بُني عليها الحكم.
غير مفحوصفحص Tracio من جهة الخادم غير متاح الآن — تعود البطاقة إلى الحكم الذي أبلغه المتصفح وتصرّح بذلك.
هوية مزوَّرةمعرّف الزائر الذي أرسله المتصفح مجهول لدى Tracio — الادعاء يبدو مزوَّراً.

يُربط مفتاحان: مفتاح عام يفعّل SDK في الأداة، ومفتاح Data API سري يُستخدم للفحص من جهة الخادم للتحقق من الحكم. من دون فحص جهة الخادم، لا يمكن الوثوق بادعاء المتصفح "لست بوتاً" وحده — وحين يخالف ادعاء المتصفح حكم الخادم، تعرض البطاقة كليهما.

يعمل Tracio لمحادثات أداة الدردشة فقط. البريد الإلكتروني وTelegram والقنوات الأخرى لا زائر فيها لفحصه، لذا تشرح بطاقة Tracio فيها أن لا شيء للفحص. غياب الحكم ليس ريبة: مانعات الإعلانات تقطع SDK عن بشر حقيقيين طوال الوقت، والمحادثات الأقدم التي بدأت قبل ربط Tracio لا حكم لها أيضاً.
يأخذ SDK لدى Tracio بصمات زوار موقعك. الحصول على موافقة الزائر (عبر CMP / لافتة ملفات تعريف الارتباط لديك) مسؤوليتك بصفتك مالك الموقع.

القيود#

  • بطاقتا Stripe وShopify للقراءة فقط — عملية الكتابة الوحيدة في تطبيق Stripe كله هي إجراء الاسترداد الاختياري المفعَّل صراحة.
  • التطبيقات المعتمدة على البريد الإلكتروني (Stripe وShopify وMailchimp وMailerLite) تحتاج عنوان بريد متحقَّقاً منه. محادثات زوار الأداة المجهولين أو القنوات بلا عنوان تعرض بطاقة صادقة تقول "لا شيء للبحث عنه".
  • دعم Jira يغطي Jira Cloud فقط.
  • لا يقدّم Mailchimp إعادة اشتراك: بعد إلغاء الاشتراك، لا يستطيع العودة إلا الشخص نفسه عبر نموذج تسجيل. استخدم إعادة الاشتراك لدى MailerLite إذا كان هذا المسار مهماً لك.
  • أحكام Tracio موجودة فقط لمحادثات الأداة التي حُمِّل فيها SDK — أبداً لقنوات البريد الإلكتروني أو المراسلة.