الروبوتات التي تستخدم أنظمتك ومستنداتك
اختياري: يمكن للروبوت الاستعلام عن بيانات (حالة فاتورة، طلب) في نظامك وإرسال مستندات مثل فاتورة PDF — وهذا ما تحتاجه OmniBrand منك.
هذا جزء اختياري من الروبوت. يُعدّه لك مهندسو OmniBrand عند الطلب؛ ولا يوجد ما تضبطه في مساحة عملك.
ما الذي يمكنه فعله
- إرسال مستنداتك الثابتة: ملف تعريف الشركة، قائمة الأسعار، قائمة الطعام، كتيّب — ملفات تحتفظ بها على الإنترنت. تعطي كلًّا منها اسمًا ورابطًا، ويرسل الروبوت ما يطلبه العميل.
- الاستعلام عن بيانات في نظامك أثناء المحادثة: يعطي العميل مثلًا رقم فاتورة أو طلب، فيسأل الروبوت نظامك ويرد بالإجابة — "الفاتورة 204 مدفوعة"، "طلبك في الطريق إليك".
- إرسال مستند ينتجه نظامك، مثل ملف PDF لتلك الفاتورة، باستخدام الرابط الذي يعيده نظامك.
- إرسال الإجابات المجمّعة إلى نظامك، مثل إنشاء عميل محتمل في نظام إدارة العملاء لديك.
يصل المستند كملف في المحادثة: في واتساب كرسالة مستند، وفي البريد الإلكتروني كمرفق، وفي دردشة الموقع كملف يستطيع الزائر فتحه. وفي محادثة الوارد لديك تعرض رسالة الروبوت اسم الملف مع 📄.
ما الذي تحتاجه OmniBrand منك
للمستندات الثابتة:
- اسم كل مستند كما سيطلبه العملاء، ورابط للملف يبدأ بـ
https://ويمكن تنزيله دون تسجيل دخول. في واتساب وإنستغرام وماسنجر تجلب خدمة المراسلة الملف من ذلك الرابط؛ وفي البريد الإلكتروني ودردشة الموقع تنزّله OmniBrand (بحد أقصى 25 ميغابايت) وترسله من مساحة التخزين الخاصة بها.
للاستعلام عن بيانات في نظامك:
- عنوان (URL) الخدمة في نظامك التي تجيب عن سؤال واحد، ويبدأ بـ
https://— مثلhttps://erp.example.com/api/invoices/{number}، مع تحديد موضع القيمة التي يقدّمها العميل. - هل تُستدعى بطريقة GET أو POST.
- بيانات الاعتماد: مفتاح API أو رمز وصول، واسم الترويسة (Header) التي يوضع فيها (عادة
Authorization). أرسلها عبر القناة التي يحددها لك الدعم، لا في رسالة عامة. - قيمة اختبار موجودة وأخرى غير موجودة (مثل رقم فاتورة حقيقي ورقم مختلق)، ليختبر المهندسون ببياناتك الحقيقية قبل التشغيل.
- وصف مختصر للإجابة: الحقول التي تحتويها (مثل
statusوamountوpdf_url) وأيها يجوز للروبوت إخبار العميل به. - كيف يقول نظامك "غير موجود": يجب أن يجيب برمز الحالة HTTP 404. وأي خطأ آخر يُعامل على أنه "النظام غير متاح".
- ما يجب أن يقدّمه العميل لإثبات هويته قبل أن يكشف الروبوت البيانات (مثل رقم الهاتف المسجّل على الفاتورة)، ليطلبه الروبوت.
كيف تُحمى بياناتك
- لا تُقبل إلا عناوين https.
- تُخزَّن بيانات الاعتماد مشفّرة. وبعد حفظها لا يرى موظفو OmniBrand إلا آخر أربعة أحرف منها؛ وتُضاف فقط إلى الطلب المرسل إلى نظامك ولا تُعرض للعملاء أبدًا.
- تُرمَّز القيم التي يكتبها العملاء بأمان داخل العنوان؛ ومع POST تُرسل بصيغة JSON.
- ترفض خوادم OmniBrand الاتصال بعناوين الشبكات الداخلية أو الخاصة، وتعيد فحص كل إعادة توجيه. وعندما يعيد نظامك توجيه الطلب إلى عنوان آخر، لا تُرسل بيانات الاعتماد إليه.
- ينتظر كل استدعاء 10 ثوانٍ كحد أقصى ويقرأ 256 كيلوبايت من الإجابة كحد أقصى.
- يُسجَّل كل تغيير على هذه الروابط وكل اختبار باسم المهندس الذي قام به.
إذا لم يستجب نظامك
عندما يكون نظامك متوقفًا أو بطيئًا، أو يجيب "غير موجود"، أو يعيد خطأ، يتبع الروبوت المسار المصمم لتلك الحالة — مثل "لم نجد هذه الفاتورة" — أو يحوّل المحادثة إلى فريقك مع ملاحظة مثل "لم يُعثر على شيء في invoices." أو "فشل مصدر البيانات invoices: …" (كل منها مع سطرها الإنجليزي). لا يُترك عملاؤك أبدًا دون رد.
إذا تعذّر تنزيل مستند من رابطه (في البريد الإلكتروني ودردشة الموقع: رابط ليس https عامًا، أو ملف أكبر من 25 ميغابايت)، يحوّل الروبوت المحادثة إلى فريقك مع الوسم bot-error وملاحظة تذكر اسم المستند.