Google Calendar

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

ما تحتاج إليه

• حساب Google تريد أن يقرأ الوكيل تقاويمه ويكتب فيها. يتصرف الوكيل باسم هذا الحساب: الحدث الذي ينشئه يُنشأ بواسطة هذا الحساب، في تقاويمه.
• عضوية في مساحة العمل. يحفظ الربط صلاحية الوصول للحساب لمساحة العمل كلها، فيستطيع أي وكيل فيها استخدام الأدوات.
• أن يكون الحساب غير مربوط بمساحة عمل أخرى في إيكونوڤا. يمكن ربط حساب Google مرة واحدة فقط، في مساحة عمل واحدة في إيكونوڤا.
• نص شخصية يسمّي التقويم، والمنطقة الزمنية، وقواعد الحجز؛ انظر للحصول على أفضل نتيجة.

الخطوات

الخطوة 1: افتح عرض الاتصالات

افتح الوكيل وأضف ?tab=connections إلى عنوانه في شريط عنوان المتصفح. يحمل العرض عنوان الاتصالات، مع السطر «إدارة الاتصالات في مساحة العمل التي يستخدمها وكلاؤك وقنواتك.»، والزر إضافة تكامل. هذا العرض ليس في شريط تبويبات الوكيل اليوم، والعنوان هو الطريقة للوصول إليه.

الخطوة 2: اختر Google Calendar

اضغط إضافة تكامل. يحمل الكتالوج عنوان إضافة تكامل، ويُصفّى بالخيارات الكل، والصوت والاتصالات، والمراسلة، والدعم والخدمة، وCRM. اختر بطاقة Google Calendar، تحت CRM؛ وتقول: «أعطِ وكلاءك أدوات التقويم: تحقق من التوفر وأدر الأحداث.» تفتح نافذة ربط Google Calendar على تبويبها الإعداد، بجانب الأدوات وكيفية الاتصال.

الخطوة 3: سمِّ الاتصال وسجّل الدخول عبر Google

• الاسم: تسمية لهذا الحساب، «تظهر في قائمة التكاملات لديك حتى تميّز الحسابات عن بعضها.» حقل مطلوب.
• بيانات الاعتماد: Google OAuth، وهو الخيار الوحيد.

تحت الحقول تقول النافذة: «سجّل الدخول عبر Google لمنح الوصول إلى التقويم. ستتم إعادتك إلى هنا.» اضغط الربط عبر Google. تأخذك البوابة إلى Google في النافذة نفسها، والرابط صالح لمدة 10 دقائق. يطلب Google صلاحيتين: إنشاء الأحداث وقراءتها (calendar.events)، وقراءة تقاويم الحساب وأحداثها (calendar.readonly). وافق على الاثنتين.

ثم يعيدك Google إلى قائمة الوكلاء دون أي رسالة. افتح عرض الاتصالات مرة أخرى لترى النتيجة:

يحمل تبويب الأدوات في النافذة العبارة «الإجراءات المتاحة عبر تكامل Google Calendar.» ويسرد الأدوات الأربع. ويعيد تبويب كيفية الاتصال هذه الخطوات.

الخطوة 4: أعطِ الأدوات لوكيل

الأدوات الأربع التي يستطيع الوكيل أن يكتسبها من الاتصال، مع الوصف الذي يقرؤه الوكيل ليقرر إن كان يستدعي أداة:

كل أداة تأخذ calendarId تستخدم التقويم الأساسي للحساب إذا تركه الوكيل. يعيد check_availability فترات الانشغال في النافذة، ويحسب الوكيل الفترات الحرة منها. يعيد list_events الأحداث بصورة مفردة مرتبة حسب وقت البداية، ويُوسَّع الحدث المتكرر إلى تكراراته. يضيف create_event كل عنوان في attendees إلى الحدث كضيف.

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

للحصول على أفضل نتيجة

حدد للوكيل أي تقويم، وأي منطقة زمنية، وكم تستغرق الحجزة، وما الذي يجب أن يؤكده قبل أن ينشئ أي شيء. تأخذ الأدوات معرّف تقويم وتواريخ بإزاحة زمنية؛ ونص الشخصية هو المكان الذي تأتي منه تلك القيم.

الموصى به

You book appointments on the "Clinic front desk" calendar. All times are Asia/Riyadh. A visit is 30 minutes, Sunday to Thursday between 09:00 and 17:00. Before creating an event, check availability for the requested slot, read the date and time back to the customer, and ask for their email address to add them as a guest. Never create an event the customer has not confirmed.

الأقل فاعلية

Help customers book appointments using the calendar tools.

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

مثال تطبيقي

يقول متصل يوم الثلاثاء: «هل أستطيع الحضور يوم الخميس بعد الظهر؟» مع نص الشخصية الموصى به:

1. يستدعي الوكيل check_availability مع timeMin بقيمة 2026-07-09T13:00:00+03:00 و timeMax بقيمة 2026-07-09T17:00:00+03:00 ومعرّف تقويم مكتب الاستقبال، فيحصل على فترات الانشغال في تلك النافذة.
2. يعرض أول 30 دقيقة حرة: «الخميس الساعة 2:30 مساءً مناسب؛ هل أحجزه؟»، ويطلب بريد المتصل الإلكتروني.
3. عند «نعم»، يستدعي create_event مع summary بقيمة "Visit: Nour Haddad"، و start بقيمة 2026-07-09T14:30:00+03:00، و end بقيمة 2026-07-09T15:00:00+03:00، و attendees بقيمة nour@example.com، ومعرّف التقويم.
4. يظهر الحدث في تقويم مكتب الاستقبال، أنشأه الحساب المربوط، والمتصل ضيف فيه، ويعيد الوكيل قراءة الحجز على المتصل.

يُحتسب كل دور يستدعي فيه الوكيل أداة مثل أي دور آخر؛ انظر ما يكلّفه الدور.

ما يحدث بعد ذلك

يظهر الاتصال في عرض الاتصالات لكل وكيل في مساحة العمل، والأدوات المنشأة منه تعمل لصالح أي وكيل يملكها. تُجدَّد صلاحية Google المحفوظة قبل انتهائها، فيستمر الاتصال في العمل دون تسجيل دخول جديد.

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

الحدود

حل المشكلات

لا يوجد صف بعد تسجيل الدخول

يعيدك Google إلى قائمة الوكلاء سواء كان الحساب مربوطًا أم لا. افتح عرض الاتصالات. إذا كان الصف مفقودًا، فأنت رفضت الطلب في شاشة Google، أو مرت أكثر من 10 دقائق، أو الحساب مربوط بالفعل بمساحة عمل أخرى في إيكونوڤا. أعد الربط، أو افصل الحساب هناك أولًا.

يقول الوكيل إنه لم يستطع الوصول إلى التقويم

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

وصل الحدث في ساعة خاطئة

أرسل الوكيل تواريخ ووقتًا بإزاحة خاطئة، أو بلا إزاحة. ضع المنطقة الزمنية في نص الشخصية، باسم IANA مثل Asia/Riyadh، واذكر أن كل وقت يقع فيها. أما المنطقة الزمنية لدى الوكيل في تبويب الإعدادات فتحدد ساعات عمله، لا الساعة التي يحجز بها؛ انظر ساعات العمل.

وصل الحدث إلى تقويم خاطئ

ترك الوكيل calendarId فذهب الحدث إلى التقويم الأساسي. اذكر التقويم بالاسم في نص الشخصية، واجعل الوكيل يستدعي list_calendars أولًا عندما يحتاج إلى المعرّف.

الأدوات ليست على الوكيل

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

الأسئلة الشائعة

أي التقاويم يستطيع الوكيل رؤيتها؟

كل تقويم في قائمة الحساب المربوط، عبر list_calendars. وتعمل الأدوات الثلاث الأخرى على التقويم الأساسي ما لم يمرر الوكيل calendarId.

هل يستطيع عدة وكلاء مشاركة اتصال واحد؟

نعم. الاتصال يتبع مساحة العمل، وأداة التقويم تعمل لصالح أي وكيل يملكها.

هل يتلقى العميل دعوة؟

تُضاف عناوين attendees إلى الحدث كضيوف، ويُنشأ الحدث دون طلب تنبيهم. اجعل الوكيل يعيد قراءة الحجز على العميل في المحادثة.

هل أستطيع ربط حسابي Google اثنين؟

نعم، اتصال لكل حساب. تحمل الأدوات المنشأة من كل اتصال بريد ذلك الحساب في اسمها، حتى يميّز الوكيل بينها، وتميّز أنت بينها أيضًا.

كيف أزيل الاتصال؟

في عرض الاتصالات، اضغط زر إجراءات في الصف، ثم حذف. أكّد حذف التكامل؟ بالزر حذف التكامل. يُحذف الاتصال وصلاحية Google المحفوظة وكل أداة أُنشئت منه، وتُزال الأدوات عن كل وكيل كان يملكها. تظهر الرسالة تم حذف التكامل.

صفحات ذات صلة

• نظرة عامة على الأدوات: ما هي أداة التكامل، وكيف يقرر الوكيل استدعاءها
• اكتب نص الشخصية: أين يُكتب التقويم والمنطقة الزمنية وقواعد الحجز
• كيف يُجمَّع prompt: كيف تصل أوصاف الأدوات ونص الشخصية إلى الوكيل
• ساعات العمل: ما تؤثر فيه المنطقة الزمنية للوكيل وما لا تؤثر فيه
• اتصالات المصادقة: بيانات الاعتماد التي تديرها إيكونوڤا عنك، ومنها هذا الاتصال
• ما يكلّفه الدور: ما يُحتسب على دور فيه استدعاء أداة