Calendly

ما الذي ستحققه

سيستطيع الوكيل عرض أوقات متاحة حقيقية من Calendly، وحجز أحدها للمتصل، وإلغاء حجز، كل ذلك أثناء المكالمة.

نظرة عامة وحالات الاستخدام

• حجز المواعيد أو العروض التوضيحية دون أن يفتح المتصل رابطًا.
• عرض رابط جدولة لمرة واحدة حين يفضّل المتصل الاختيار لاحقًا.
• التحقق من اجتماع قادم أو إلغاؤه.

المتطلبات المسبقة

• حساب Calendly على خطة مدفوعة. فالحجز عبر API غير متاح في الخطط المجانية (ترد Calendly بـ 403).
• إذن إنشاء رمز وصول شخصي.

إعداد الحساب الخارجي (في Calendly)

Calendly هي التي تتحكم في هذه الشاشات. دليل Calendly: Personal access tokens.

1. في Calendly، افتح Integrations & apps ثم API and webhooks (رابط مباشر).
2. أنشئ personal access token.
3. حدّد النطاقات (scopes) أدناه عند إنشائه. فالرموز المنشأة منذ إدخال النطاقات لا تملك أي وصول حتى تُختار النطاقات.
4. انسخ الرمز؛ فتعرضه Calendly مرة واحدة.

اربطه في Phynxa

1. Integrations، Connect في Calendly.
2. الصق Personal access token. واختياريًا أدخل Default event type (URI أو معرّف نوع حدث) ليُحجَز حين لا يسمّي الوكيل نوعًا.
3. اختر Check and connect. تعرض البطاقة Connected.

الأذونات والإعدادات

النطاقات المطلوب تحديدها: users:read وevent_types:read وavailability:read وscheduled_events:write وscheduling_links:write.

استخدمه في مكالمة

اختبره

1. يجب أن يجيب Test connection "Calendly is responding."
2. في Chat الخاص بوكيل، اسأل "What times do you have next week?"، واختر وقتًا وأعطِ بريدًا. وتحقق من الحجز في Calendly.

النتيجة المتوقعة

تطابق الأوقات المعروضة توفّرك في Calendly، ويظهر الوقت المحجوز في Calendly ويرسل رسالة التأكيد المعتادة.

استكشاف الأخطاء

• 403 في كل إجراء. أُنشئ الرمز دون نطاقات، أو أن خطتك مجانية. أنشئ رمزًا جديدًا مع تحديد النطاقات.
• "No event type." اضبط Default event type، أو اطلب من الوكيل تسمية نوع.
• يُرفَض الوقت. يجب أن يظل الوقت متاحًا وفي المستقبل وضمن 31 يومًا.

الأمان وبيانات الاعتماد

يُخزَّن الرمز مشفّرًا ولا يُعرض مجددًا. احذف الرمز في Calendly لسحبه. وRemove في Phynxa ينساه هنا.

أدلة ذات صلة

• أدوات التطبيقات المتصلة
• حل حجز المواعيد