المكالمة لا تنتهي داخل نظامنا

واجهة REST: ما الذي يمكنكم فعله من الخارج

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

• توثيق بمفتاح واجهة برمجية مع نطاقات صلاحية لكل عملية
• وضع مكالمة صادرة في القائمة بطلب واحد، مع إمكانية ربطها بحملة
• جلب المحادثات مع التفريغ والملخّص ومؤشّر المشاعر والنتيجة
• إدارة المسارات وقاعدة المعرفة، بما في ذلك توليد مسار من مستند نصّي
• مرجع OpenAPI حيّ يغطّي كل نقطة نهاية

إشعارات Webhook موقّعة عند نهاية كل مكالمة

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

الكتابة في Salesforce وHubSpot

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

خادم MCP: ابنوا المساعد من Claude أو ChatGPT

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

ما الذي يستطيع المساعد الوصول إليه أثناء المكالمة

الفرق بين «سأتحقّق وأعاود الاتصال بك» وبين إجابة حقيقية هو الوصول إلى البيانات أثناء المكالمة. تستطيعون ربط أنظمتكم كأدوات يستدعيها المساعد أثناء المحادثة، كما تستطيعون — بلا أي تطوير — رفع ملف CSV أو Excel كجدول بيانات يصفّيه المساعد ويعدّه من داخل النظام، من دون أن تغادر البيانات النظام. وما يُسمح للمساعد باستدعائه محكوم على مستوى القسم وعلى مستوى المساعد نفسه، فلا يرث مساعد كل أدوات المؤسسة لمجرّد وجودها.

الأمن والصلاحيات وحدود هذه التكاملات

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