نعم، يمكنك إدارة الخدمات والأوقات والحجوزات عبر API باستخدام وحدة المواعيد في Papo. تتيح واجهة API REST عرض الخدمات والمتخصصين والمرضى، والاطلاع على جدول المواعيد، وإنشاء حجوزات جديدة برمجيًا، ودمج مسار الحجز بالكامل مع موقعك أو تطبيقك أو نظامك الخارجي.
صُممت وحدة المواعيد في Papo لتكون مركز التحكم في جدول مواعيدك. وهي تنظم أربعة محاور: الخدمات التي تقدمها (بالاسم والمدة والسعر)، والمتخصصون الذين ينفذونها، وتوافر أوقات كل منهم، والحجوزات المنفذة. ومع API، يمكنك أتمتة هذه العمليات دون الوصول إلى لوحة التحكم يدويًا، مع الحفاظ على تكامل سلس بين Papo وأدواتك الأخرى.
ملخص عمليات المواعيد عبر API
| العملية | ما الذي تفعله | متى تستخدمها |
|---|---|---|
| عرض الخدمات | تعيد الخدمات المسجلة للمواعيد، مع المدة والسعر. | مزامنة كتالوج الخدمات مع موقعك أو تطبيقك ليرى العميل الخيارات في الوقت الفعلي. |
| عرض المتخصصين | تعيد قائمة مقدمي الخدمة أو أعضاء الفريق الذين ينفذون الخدمات. | عرض المتخصصين المتاحين وتخصصاتهم في واجهة حجز خارجية. |
| عرض المرضى | تعيد المرضى المسجلين، بالاسم والهاتف والمعرّف. | التحقق مما إذا كان العميل موجودًا بالفعل في CRM قبل إنشاء حجز جديد أو ربطه بسجل موجود. |
| عرض الحجوزات | تعيد الحجوزات مع تصفية حسب الحالة (مثل: مؤكد، معلّق). | تدقيق الحجوزات، أو التكامل مع أنظمة التقارير، أو التحقق من إشغال جدول المواعيد قبل عرض أوقات جديدة. |
| حجز موعد | تنشئ حجزًا فعليًا في جدول مواعيد متخصص، لخدمة ومريض محددين. | السماح للعملاء بالحجز مباشرة عبر موقعك أو تطبيقك، أو أتمتة إنشاء الحجوزات من أنظمة خارجية. |
كيف تعمل مصادقة API
تتطلب جميع عمليات الكتابة في المواعيد المفتاح السري لحسابك في Papo، ويُرسل كرمز Bearer في ترويسة التفويض. المفتاح العام للحساب اختياري، لكن إذا أُرسل فيجب أن يطابق الحساب نفسه الخاص بالمفتاح السري.
عنوان URL الأساسي لـ API هو https://app.papo.global/api/v1. تُنشأ المفاتيح في منطقة المطور بلوحة تحكم Papo. يُعرض المفتاح السري مرة واحدة فقط عند الإنشاء؛ احتفظ به في مكان آمن وألغِه فورًا إذا اشتبهت في تسريبه.
كيفية الاستخدام عمليًا
- انتقل إلى منطقة المطور/API في لوحة تحكم Papo وأنشئ مفتاحًا سريًا. انسخ أيضًا المفتاح العام للحساب.
- في كل طلب، صادق باستخدام المفتاح السري كرمز Bearer. وإذا أردت تعزيز التحقق، أرسل المفتاح العام في الترويسة المحددة في الوثائق.
- لبناء واجهة الحجز، اعرض أولًا الخدمات والمتخصصين المتاحين. بهذه الطريقة يمكنك ملء الخيارات ديناميكيًا في موقعك أو تطبيقك ببياناتك الفعلية من حساب Papo.
- لإنشاء حجز، استدعِ نقطة نهاية إنشاء الموعد، وأرسل في حمولة JSON معرّفات الخدمة والمتخصص والمريض والتاريخ/الوقت المطلوب. ستتحقق API من التوافر في جدول المواعيد المهيأ في وحدة المواعيد وستنشئ الموعد.
- راجع الوثائق الرسمية على
https://papo.global/pt/docsللحصول على المسارات الدقيقة والمعلمات الإلزامية وأمثلة الشيفرة. جميع الاستجابات بصيغة JSON.
تتيح API أيضًا عرض الحجوزات الحالية مع تصفية حسب الحالة. وهذا مفيد لبناء لوحات متابعة، أو إرسال تذكيرات تلقائية، أو دمج حالة الحجوزات مع أنظمة أخرى.
لمن يُنصح بهذا التكامل
- العيادات وعيادات الأطباء وصالونات التجميل التي ترغب في تقديم حجز مواعيد عبر الإنترنت على موقعها، مع توافر في الوقت الفعلي.
- منصات SaaS والأسواق الإلكترونية التي تحتاج إلى ربط جدول مواعيد مقدمي الخدمة بنظام حجز خارجي.
- موزعو إعادة البيع بالعلامة البيضاء الذين ينشئون حلولًا مخصصة للعملاء النهائيين ويريدون إتاحة وحدة المواعيد عبر API.
- الشركات ذات مسارات العمل المؤتمتة التي تطلق إنشاء الحجوزات من أحداث في CRM أو ERP أو أدوات الأتمتة.
الأسئلة الشائعة
هل أحتاج إلى تهيئة وحدة المواعيد لاستخدام API؟
نعم. يجب أن تكون الخدمات والمتخصصون وأوقات توافرهم مسجلة بالفعل في وحدة المواعيد في Papo حتى تتمكن API من عرضها والتحقق من الحجوزات.
هل تتيح API إنشاء خدمة أو متخصص جديد؟
تركز موارد API على عرض الخدمات والمتخصصين الحاليين وحجز المواعيد. لإنشاء الخدمات والمتخصصين أو تعديلها، استخدم لوحة تحكم Papo.
كيف تعرف API أن الوقت متاح؟
عند إرسال طلب لحجز موعد، تتحقق API Papo من التوافر المهيأ للمتخصص والخدمة المختارين في ذلك اليوم والوقت. وإذا كان هناك تعارض، فلن يُنشأ الحجز وستعيد API خطأ.
هل يمكنني استخدام API لحجز موعد باسم مريض غير موجود بعد في CRM؟
يمكنك أولًا استخدام API جهات الاتصال في Papo لإنشاء المريض (بالاسم والبريد الإلكتروني و/أو الهاتف)، ثم استخدام المعرّف (ID) المُعاد لإنشاء الحجز. راجع الوثائق للاطلاع على نقطة نهاية إنشاء جهات الاتصال.
هل يمكن لذكاء Papo الاصطناعي الحجز تلقائيًا عبر API؟
يحجز الذكاء الاصطناعي في Papo، مثل Super Chat، مباشرةً عبر المحادثة على WhatsApp، بالاطلاع على جدول المواعيد في وحدة المواعيد. أما API فهي المسار للتكاملات البرمجية الخارجية، مثل نظام حجز مواعيد عبر الإنترنت.
أين أرى الشكل الدقيق للحزمة (payload) للحجز؟
في الوثائق الرسمية لـ API، على https://papo.global/pt/docs. ستجد هناك تفاصيل المصادقة والمعلمات والاستجابات وأمثلة الشيفرة لموارد المواعيد.
اقرأ أيضًا
- كيفية استخدام API Papo لإنشاء جهات الاتصال وتحديثها بشكل جماعي
- كيفية استخدام API Papo لإنشاء العلامات (tags) وإدارتها
ابدأ دمج جدول مواعيدك عبر API →
سجّل في Papo واحصل على وصول إلى API REST لأتمتة مواعيدك بدءًا من المستخدم الأول.