الفرق بين أن تعرف وأن تتحقق
هناك نوعان من أسئلة العملاء. النوع الأول عام: ما هي سياسة الإرجاع لديكم؟ كم تستغرق الشحنة؟ هل تشحنون إلى ألمانيا؟ قاعدة معرفة جيدة التجهيز تتعامل مع هذه الأسئلة.
النوع الثاني محدد: أين طلبي #4521؟ هل لا يزال الإصدار الأزرق متوفراً في المخزون؟ كم تبقى لي في خطتي هذا الشهر؟ هذه الأسئلة لا تعيش في قاعدة معرفة. إنها تعيش في أنظمتكم — إدارة الطلبات، المخزون، الفوترة — وتتغير كل ثانية.
روبوت الدردشة الذي يستطيع التعامل مع النوع الأول فقط هو مجرد قسم أسئلة شائعة متخفٍ. روبوت الدردشة الذي يستطيع التعامل مع النوع الثاني أيضاً هو مساعد. الفرق بين الاثنين هو الوصول إلى API.
لماذا تكلفك هذه الفجوة عملاء
معظم "محادثات الذكاء الاصطناعي" اليوم مبنية على قاعدة معرفة وحدها. يمكنها إعادة صياغة سياسة الشحن لديكم بسبع عشرة لغة، لكنها لا تستطيع أن تخبر العميل بمكان طرده الفعلي الآن. لذا يسأل العميل، ويتهرب الروبوت، ويستسلم العميل أو ينتظر مشغلاً ليبحث عن البيانات نفسها التي كان بإمكان الروبوت جلبها بالميلي ثانية.
هذا هو سقف روبوت الدردشة. كل "دعني أتحقق من ذلك لك" هو فرصة ضائعة للإجابة في ثوانٍ، عند الرسالة الأولى، بينما لا تزال نية العميل ساخنة.
ما الذي تفعله اتصالات API فعلاً
في enuchat، اتصال API هو رابط مهيأ بين الدردشة وإحدى خدمات الواجهة الخلفية الخاصة بك. تعرّفه مرة واحدة: عنوان URL الأساسي، وطريقة المصادقة، وحفنة من نقاط النهاية مع معلماتها وكيفية تعيين الاستجابة.
من تلك اللحظة، يمكن للذكاء الاصطناعي استدعاء هذه النقاط أثناء المحادثة. عندما يسأل زائر عن طلب، يستخرج الذكاء الاصطناعي رقم الطلب، يستدعي نقطة نهاية الطلبات لديك، يقرأ الحالة المباشرة وينسجها في الرد. يرى الزائر جملة واحدة: "تم شحن طلبك #4521 أمس ومن المتوقع أن يصل يوم الخميس." خلف تلك الجملة حدثت مكالمة API حقيقية.
العميل لا يرى السباكة. يرى فقط أن الدردشة تعرف فعلاً.
خمس طرق للمصادقة، بدون كود مخصص
معظم API التي قد ترغب في توصيلها تستخدم بالفعل مصادقة قياسية. يدعم enuchat خمسة جاهزة من العلبة:
- بدون — لـ API العامة التي لا تحتاج إلى مصادقة
- API Key — يُرسل كرأس أو معامل استعلام
- Bearer Token — مصادقة بسيطة قائمة على رمز
- Basic Auth — للأنظمة القديمة
- OAuth 2.0 client credentials — لمزودي الخدمة الحديثين مثل Salesforce وHubSpot أو خادم OAuth الخاص بك
بالنسبة لـ OAuth 2.0، يدير enuchat دورة حياة الرمز تلقائياً — يجلب عند المكالمة الأولى، ويخزن مؤقتاً حتى انتهاء الصلاحية، ويُجدد عند الحاجة. تكون بياناتك مهيأة مرة واحدة وتنساها. تُشفّر جميع بيانات الاعتماد في الراحة باستخدام libsodium ولا تظهر أبداً في استجابات API.
المتغيرات والقوالب وتعيين الاستجابة
تُعرّف نقاط النهاية كقوالب. مسار مثل /orders/{orderId} أو هيئة JSON تشير إلى {customerId} يستبدلان قيماً من متغيرات الجلسة — متغيرات يمكن للذكاء الاصطناعي أو قاعدة ثابتة تعيينها أثناء المحادثة.
عندما يستجيب API، تُعيّن الحقول من استجابة JSON إلى متغيرات الجلسة باستخدام تدوين النقطة. data.status يصبح order_status. data.shipping.eta يصبح delivery_eta. ثم ينسج الذكاء الاصطناعي تلك القيم في رد بلغة طبيعية — بلغة الزائر نفسها.
ثلاثة أنماط تغطي معظم حالات الاستخدام
عملياً، تقع معظم تكاملات API في واحد من ثلاثة أشكال.
تحقق ثم رد
يطرح الزائر سؤالاً يمكن الإجابة عليه بمكالمة API واحدة. تُطلق القاعدة CALL_API متبوعة بـ REPLY_AI. يستخدم الذكاء الاصطناعي البيانات المُسترجعة لتأليف رد سياقي مدعوم. حالة الطلب، رصيد الحساب، توفر الغرفة، التسعير الحالي، تتبع الطرود — كل ذلك يندرج هنا.
تحقق ثم وجّه
تعيد مكالمة API معلومات كافية لاتخاذ قرار بشأن الخطوة التالية. يُصعّد حساب premium إلى وكيل أقدم. يُوجَّه اشتراك منتهي الصلاحية إلى الفوترة. يستخدم الذكاء الاصطناعي CALL_API متبوعة بـ ASSIGN_TO_OPERATOR لاتخاذ قرارات التوجيه بناءً على بيانات عميل حقيقية، لا تخمين.
تدفقات متعددة الخطوات
الرسالة الأولى تضع علامة على المحادثة بـ SET_VARIABLE، والثانية تُطلق مكالمة API عند توفر سياق كافٍ، والثالثة تؤلف الإجابة. مفيد عندما تحتاج إلى تأكيد النية قبل ping الواجهة الخلفية، أو عندما يعتمد البحث عن البيانات على شيء قاله الزائر قبل رسالتين.
أمان مدمج
توصيل الواجهات الخلفية بأداة دردشة يُربك بعض الفرق — وبحق. يقدم enuchat عدة طبقات من الحماية افتراضياً:
- منع SSRF يحظر المكالمات إلى localhost وعناوين IP الخاصة وأسماء المضيفين الداخلية
- مهلة 5 ثوانٍ تمنع API بطيئاً من تعليق المحادثة
- عزل المستأجر يعني صفر تسرب للبيانات بين المستأجرين — نقاط النهاية لديك مرئية فقط لأدواتك
- أزرار الاختبار تتحقق من الاتصال وكل نقطة نهاية بشكل مستقل قبل أن تربطها في القواعد
- بيانات اعتماد مشفرة لا تعود أبداً إلى لوحة التحكم بصيغة واضحة
ما الذي يتغير لعملائك
تنتقل الدردشة من "دعني أجد شخصاً يستطيع التحقق من ذلك" إلى "تم التحقق، إليك الإجابة" — بأي من 60+ لغة، يوم الأحد في الساعة الثالثة فجراً، بينما يكون فريق الدعم لديك نائماً. العملاء الذين كانوا سيتركون السلة أو الطلب أو الخطة يبقون لأن الإجابة تصل بينما لا يزالون يسألون.
هذا هو الفرق بين روبوت دردشة ومساعد. وهذا هو الفرق الذي يشعر به عملاؤك فعلاً.
كيفية البدء
إذا كان لديك enuchat مُعدّاً بالفعل، فإن اتصالات API موجودة تحت الإعدادات → اتصالات API. اختر نقطة نهاية واحدة تجيب على سؤال يكتبه فريقك مئة مرة في الأسبوع — حالة الطلب عادة هي أعلى نقطة بداية ذات تأثير. هيّئ الاتصال، أضف نقطة النهاية، اربطها بقاعدة، واختبرها مرة واحدة قبل الانتقال إلى الإنتاج. راجع دليل اتصالات API للجولة الكاملة.
إذا كنت جديداً على enuchat، سجّل في enuchat.com. تتضمن الفئة المجانية اتصالات API من اليوم الأول — لا حاجة لبطاقة، لا رسوم لكل محادثة، لا انتهاء صلاحية للنسخة التجريبية.
خمس دقائق لتوصيل أول نقطة نهاية. الإجابة المفيدة الأولى عادةً ما تصل في اليوم نفسه.