Your AI Connector Docs

Trafft

لمن هذا؟ هذا التكامل مخصص للشركات التي تعتمد على المواعيد وتدير جدولها الزمني بالفعل في Trafft — مثل الصالونات، ومحلات الحلاقة، والعيادات، والاستوديوهات، والاستشاريين، وورش الإصلاح. إذا كنت لا تستخدم Trafft، يمكنك تخطي هذه الصفحة.

هل تستخدم نظام جدولة مختلفاً؟ لا يزال بإمكانك ربط أي نظام يحتوي على واجهة برمجة تطبيقات (API): راجع ربط أداة غير مدرجة لدينا، والذي يغطي الوظائف المخصصة، وواجهة برمجة التطبيقات (API)، وخطافات الويب (webhooks).

Trafft هي منصة جدولة للشركات التي تبيع وقتها: حيث تقوم بإعداد خدماتك، وموظفيك، ومواقعك، ويقوم العملاء بحجز موعد. يتيح ربط Trafft بـ Your AI Connector لوكيل الذكاء الاصطناعي الخاص بك التعامل مع عملية الحجز بالكامل داخل الدردشة — بدءاً من التحقق من الأوقات المتاحة فعلياً، وحجزها، وتأكيد الوقت — بدلاً من إرسال العميل إلى رابط حجز على أمل أن يكمل العملية.


ما الذي تقوم به Trafft

توفر Trafft للشركات التي تعتمد على المواعيد ما يلي:

  • خدمات ذات مدة وسعر محددين
  • موظفون (عاملون) لديهم ساعات عمل خاصة بهم
  • موقع واحد أو أكثر
  • موقع إلكتروني للحجز وتقويم لفريقك

من خلال ربط Trafft بـ Your AI Connector، يصبح هذا الجدول الزمني نفسه شيئاً يمكن للذكاء الاصطناعي الخاص بك التعامل معه عبر واتساب، أو الرسائل القصيرة (SMS)، أو إنستغرام، أو دردشة موقعك الإلكتروني. يقرأ الذكاء الاصطناعي خدماتك وموظفيك، ويتحقق من Trafft لمعرفة المواعيد المتاحة فعلياً، ويكتب الحجز مباشرة في Trafft — بحيث يكون ما يراه فريقك في Trafft هو الحقيقة دائماً.


ربط Trafft

قبل البدء: تحتاج إلى الوصول إلى واجهة برمجة التطبيقات (API) في Trafft، وهو جزء من خطة الأعمال (Business plan) في Trafft. افتح لوحة تحكم مسؤول Trafft وابحث عن Features & Integrations → API & Connectors. إذا لم تكن هذه الصفحة موجودة، فإن خطة Trafft الخاصة بك لا تتضمنها بعد ولا يمكن إجراء الربط.

  1. في الشريط الجانبي الأيسر، انقر على Settings (أيقونة الترس).
  2. في الشريط الجانبي للإعدادات، ضمن مجموعة Integrations، انقر على Booking & Calendar.
  3. ابحث عن بطاقة Trafft وانقر على Connect.
  1. املأ عنوان الشركة. هذا هو الجزء الذي يسبق .admin.trafft.com في العنوان الذي تسجل الدخول منه — إذا كنت تسجل الدخول من acme.admin.trafft.com، فاكتب acme. يمكنك أيضاً لصق العنوان بالكامل؛ وسنقوم باستخراج الجزء الصحيح منه. هل لديك حساب Trafft ذو علامة تجارية بيضاء (White-label)؟ إذا كان عنوان Trafft الخاص بك ينتهي بـ .admin.wlbookings.com بدلاً من ذلك (وهو العنوان الذي توفره Trafft للحسابات التي يتم إنشاؤها بموجب خطة العلامة التجارية البيضاء الخاصة بالوكالة)، فقم بلصق العنوان بالكامل، على سبيل المثال acme.admin.wlbookings.com — فهذا يخبرنا بمكان وجود حساب Trafft الخاص بك. كتابة acme فقط ستجعل النظام يبحث عنك في عنوان Trafft القياسي، وهو حساب مختلف.
  2. املأ معرف العميل (Client ID) و سر العميل (Client Secret). كلاهما موجود في لوحة تحكم Trafft الخاصة بك تحت Features & Integrations → API & Connectors.
  3. يمكنك اختيارياً إضافة تسمية (Label) — وهو اسم لقائمتك الخاصة، ويكون مفيداً إذا كنت تدير عدة شركات.
  4. انقر فوق اتصال (Connect).

التحقق من بيانات الاعتماد

لا يتم حفظ أي شيء حتى تؤكده Trafft. عند النقر على Connect، نقوم بتسجيل الدخول إلى Trafft بما كتبته وقراءة إعداداتك. يتم رفض عنوان الشركة الخاطئ، أو معرف العميل أو السر الخاطئ، أو خطة Trafft التي لا تحتوي على وصول إلى واجهة برمجة التطبيقات (API) فوراً، مع ظهور السبب على الشاشة — لن ينتهي بك الأمر أبداً باتصال يبدو سليماً ثم يفشل في المرة الأولى التي يطلب فيها عميل حجز موعد.

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

يتم تخزين سر العميل (Client Secret) مشفراً ولا يتم عرضه مرة أخرى أبداً — لا لك ولا لفريقك. هل فقدته؟ قم بإنشاء واحد جديد في Trafft وقم بالربط مرة أخرى.

الإيقاف المؤقت أو قطع الاتصال

يحتوي صف Trafft المرتبط على أزراره الخاصة في صفحة الحجوزات والتقويم (Booking & Calendar):

  • تحديث (Refresh) يقوم بقراءة أعداد خدماتك وموظفيك من Trafft مرة أخرى (راجع إضافة أو تغيير الخدمات لاحقاً).
  • إيقاف مؤقت (Pause) يوقف حجز الذكاء الاصطناعي الخاص بك في Trafft مع ترك الاتصال مُعداً. تنشيط (Activate) يعيد تشغيله مرة أخرى. استخدمه أثناء إعادة تنظيم خدماتك، أو خلال فترة إغلاق.
  • قطع الاتصال (Disconnect) يزيل الاتصال تماماً. المواعيد الموجودة بالفعل في Trafft تبقى كما هي تماماً — قطع الاتصال لا يلغي أو يحذف أي شيء في تقويم Trafft الخاص بك أبداً. يمكنك الاتصال مرة أخرى لاحقاً بنفس التفاصيل.

توجيه وكيل الذكاء الاصطناعي الخاص بك للحجز باستخدام Trafft

ربط Trafft لا يغير ما يفعله الذكاء الاصطناعي الخاص بك حتى الآن. قم بتوجيه وكيل (Agent) إليه:

  1. انقر على وكلاء الذكاء الاصطناعي (AI Agents) في الشريط الجانبي وافتح الوكيل.
  2. انتقل إلى خطوة قدرات الذكاء الاصطناعي (AI Abilities) وابحث عن بطاقة الحجوزات (Bookings).
  3. قم بتفعيل السماح لهذا الوكيل بحجز المواعيد (Let this agent book appointments).
  4. انقر على محدد المزود واختر Trafft (تظهر خيارات المزود مباشرة تحت زر التبديل).
  5. انقر على حفظ التغييرات (Save changes).

ما يمكن للذكاء الاصطناعي القيام به

مع اختيار Trafft كمزود، يمكن لوكيلك القيام بكل ما يلي داخل محادثة عادية:

  • إخبار الناس بما تقدمه. يسرد خدمات Trafft الخاصة بك مع مدة كل خدمة وتكلفتها، ويمكنه تسمية موظفيك.
  • التحقق مما هو متاح حقاً. يطلب من Trafft الأوقات المتاحة للخدمة التي يريدها شخص ما، ويمكنه تضييق نطاق ذلك ليشمل موظفاً معيناً أو موقعاً معيناً إذا طلب العميل ذلك. ينظر في فترة تصل إلى أسبوع في المرة الواحدة، لذا سيسأل عن اليوم أو الأسبوع الذي تقصده بدلاً من قراءة تقويمك بالكامل.
  • الحجز. يتم إنشاء الموعد في Trafft في نفس اللحظة، كحجز معتمد، ويخبر الذكاء الاصطناعي العميل بالوقت المؤكد. تتم إضافة العميل إلى قائمة عملاء Trafft الخاصة بك، أو مطابقته مع السجل الموجود لديه بالفعل هناك من خلال عنوان بريده الإلكتروني.
  • البحث عما حجزوه. يمكن للذكاء الاصطناعي إخبار العميل بمواعيد Trafft القادمة الخاصة به.
  • الإلغاء. رسالة واحدة (“حدث شيء ما، هل يمكنك إلغاء يوم الخميس؟”) وسوف يختفي الموعد من تقويم Trafft الخاص بك.
  • نقل موعد. يحجز الذكاء الاصطناعي الوقت الجديد أولاً ثم يزيل القديم فقط، لذا إذا تبين أن الوقت الجديد محجوز، يظل لدى العميل موعده الأصلي.

يظهر كل حجز يتم إجراؤه بهذه الطريقة أيضاً في صفحة المواعيد (Appointments) الخاصة بك مع ظهور Trafft كمزود، لذا فهو يُحتسب مثل أي حجز آخر: يتم تشغيل خطاف الويب الخاص بـ حجز الموعد (Appointment Booked)، وتعمل الأتمتة التي تبدأ من موعد جديد كالمعتاد. أي تذكيرات أو رسائل بريد إلكتروني تأكيدية يرسلها Trafft نفسه لا تزال تأتي من Trafft، تماماً كما تفعل للحجز الذي يتم إجراؤه على موقع Trafft الإلكتروني الخاص بك.


إضافة أو تغيير الخدمات لاحقاً

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

هناك أمران يستحقان المعرفة:

  • الأعداد الموجودة في الصف المتصل هي من وقت قيامك بالربط. أعداد الخدمات والموظفين المعروضة في صف Trafft على صفحة الحجز والتقويم (Booking & Calendar) هي ما وجدناه أثناء التحقق من بيانات اعتمادك، لذا فهي لا تتغير تلقائياً مع نمو قائمة Trafft الخاصة بك. انقر على تحديث (Refresh) في ذلك الصف لقراءتها مرة أخرى. هذا الإجراء يحدّث تلك الأرقام فقط — أما الذكاء الاصطناعي فكان يقرأ الكتالوج المباشر الخاص بك في كلتا الحالتين.
  • إذا أخبرك مساعدك في أي وقت أن خدمة ما غير موجودة، فاطلب منه سرد خدماتك. سيؤدي ذلك إلى قيامه بجلب الكتالوج مرة أخرى والإجابة بناءً على القائمة المحدثة. إذا كانت الخدمة لا تزال غير موجودة، فهي ليست موجودة بالفعل في حساب Trafft الذي ربطته — تأكد من أنك ربطت الحساب الصحيح (الأعداد الموجودة في الصف هي أسرع وسيلة للتحقق).

معلومات مفيدة

  • يؤدي الإلغاء إلى إزالة الموعد في Trafft. تقوم واجهة برمجة تطبيقات Trafft بحذفه بدلاً من وضع علامة “ملغي” عليه، لذا فإن الحجز الذي يتم إلغاؤه من خلال المحادثة لا يترك أي صف “ملغي” في تقويم Trafft الخاص بك. إذا كنت ترغب في الاحتفاظ بسجل لعمليات الإلغاء، فقم بتدوينها في مكان آخر.
  • يبقى الذكاء الاصطناعي في نطاق عمله. فهو لا يرى أو يغير سوى المواعيد التي تم حجزها في تلك المحادثة، أو التي تخص جهة الاتصال التي يتحدث معها. ولا يمكنه قراءة أو نقل حجوزات أي شخص آخر.
  • يحتاج الحجز إلى عنوان بريد إلكتروني واسم. يحدد Trafft العملاء عن طريق البريد الإلكتروني، لذا يطلب الذكاء الاصطناعي أي معلومات مفقودة قبل إتمام الحجز.
  • حجوزات المجموعات غير مدعومة بعد. شخص واحد لكل موعد - لا يمكن إرسال ضيوف إضافيين أو أحجام مجموعات إلى Trafft في الوقت الحالي.
  • تبقى المدفوعات في Trafft. يذكر الذكاء الاصطناعي السعر ولكنه لا يقبل الدفع أبداً، ولا يمكنه إرسال رابط دفع: لا تكشف واجهة برمجة تطبيقات Trafft عن الفواتير أو روابط الدفع، لذا لا يوجد شيء يمكنه جلبه. إذا كان يجب دفع مقابل الخدمة مقدماً أو تتطلب وديعة، فقم بتفعيل طريقة دفع عبر الإنترنت في Trafft وأضف عنصر نائب لرابط الدفع الخاص بـ Trafft (إعدادات إشعارات البريد الإلكتروني/الرسائل القصيرة ← القائمة المنسدلة الموعد) إلى إشعار الموعد المعتمد. سيحتوي التأكيد الذي يرسله Trafft بعد كل حجز يقوم به الذكاء الاصطناعي على الرابط لدفع المبلغ الكامل أو الوديعة. يتم إنشاء الحجز نفسه بدون خطوة دفع، لذا يتم اعتماده بغض النظر عما إذا تم دفعه أم لا. هل تريد الرابط في المحادثة نفسها؟ أضف رابط الدفع الخاص بك (Stripe، PayPal، أو أي صفحة دفع) إلى قاعدة معرفة الوكيل أو تعليماته مع ملاحظة حول متى يجب إرساله، وسيقوم الذكاء الاصطناعي بمشاركته عندما يحتاج العميل إلى الدفع.
  • حساب Trafft واحد لكل حساب Your AI Connector. إذا كنت تدير عدة شركات في حسابات Trafft منفصلة، فقم بتوصيل الحساب الذي يجب أن يقوم الوكيل بالحجز فيه.
  • تعمل حسابات Trafft ذات العلامة البيضاء بنفس الطريقة. يتصل الحساب الذي ينتهي عنوانه بـ .admin.wlbookings.com (خطة العلامة البيضاء الخاصة بـ Trafft) تماماً مثل الحساب القياسي - الصق العنوان الكامل كعنوان للشركة. لا تزال معرف العميل (Client ID) وسر العميل (Client Secret) تأتي من صفحة الميزات وعمليات التكامل ← واجهة برمجة التطبيقات والموصلات الخاصة بذلك الحساب، لذا لا يزال يحتاج إلى وصول واجهة برمجة التطبيقات في خطة Trafft الخاصة به.

الخطوات التالية

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