Google Sheets

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

سيستطيع الوكيل تسجيل ما يحدث في المكالمة في جدول Google Sheets، والبحث عن المتصل فيه، وتحديث صفه، أثناء المكالمة.

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

• إضافة صف لكل مكالمة: اسم المتصل ورقم هاتفه وما أراده.
• حفظ إجابات استبيان قصير، صفًا لكل إجابة.
• العثور على المتصل برقم هاتفه أو بريده وإخباره بما يقوله الجدول.
• تحديث صف لاحقًا، مثلًا لوضع علامة «تم الحجز» على طلب.

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

• حساب Google يستطيع فتح جدول البيانات. شارك الجدول مع هذا الحساب إن كان يخص شخصًا آخر.
• جدول Google Sheets يحمل صفه الأول أسماء الأعمدة (مثل الاسم والهاتف والملاحظة). ويضيف الوكيل الصفوف تحتها.
• إذا لم توفّر Phynxa تطبيق Google لمساحة عملك، فعميل OAuth من Google Cloud (انظر أدناه).

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

لا يلزم إلا إذا طلب مربع Connect معرّف عميل وسرًّا. Google هي التي تتحكم في هذه الشاشات. دليل Google: Sheets API values.

1. في لوحة Google Cloud، أنشئ عميل OAuth (تطبيق ويب) وفعّل Google Sheets API.
2. أضف عنوان إعادة التوجيه الذي يعرضه مربع Phynxa بوصفه URI إعادة توجيه مصرَّحًا به.
3. انسخ Client ID وClient secret.

اربطه في Phynxa

1. افتح جدول Google Sheets الذي تريد أن يستخدمه الوكيل وانسخ عنوانه من المتصفح.
2. Integrations، Connect في Google Sheets. ألصق العنوان في Spreadsheet link. وفي Tab name اكتب اسم التبويب المطلوب، مثل Calls، أو اتركه فارغًا لاستخدام التبويب الأول. ويمكن ترك الحقلين فارغين وضبطهما لاحقًا.
3. اختر Continue to Google، ثم اختر حساب Google الخاص بك ووافق.
4. تعرض البطاقة Connected مع عنوانك.

لتغيير الجدول لاحقًا، افتح قائمة ⋯ في البطاقة واختر Edit settings. ويُفحص الرابط الجديد مع Google فور حفظه، وينبّهك المربع إن تعذّر فتحه.

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

النطاقات: spreadsheets (قراءة جداولك وتعديلها) وuserinfo.email (لإظهار الحساب المتصل). ولا تتيح Google إذنًا أضيق يستطيع فتح جدول موجود لديك، وتصنّف هذا الإذن حساسًا. ويعمل الوكيل في الجدول والتبويب اللذين اخترتهما فقط؛ ولا يُمنح وسيلة لتسمية جدول آخر.

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

أخبر الوكيل بترتيب الأعمدة في Description الخاص بالأداة، مثلًا: «الأعمدة: الاسم، الهاتف، السبب، التاريخ». فيملأ كل خلية في مكانها الصحيح.

كيف تُحفظ القيم:

• يُحفظ كل شيء كما كُتب تمامًا، نصًا. والقيمة التي تبدأ بـ = تُحفظ نصًا ولا تُنفَّذ صيغةً أبدًا، ورقم هاتف مثل +1 555 0100 لا يتحول إلى رقم.
• للصف 50 خلية على الأكثر، وللخلية 2000 حرف على الأكثر.
• يبحث Find rows في أول 5000 صف من التبويب. وتُطابَق الكلمة دون اعتبار حالة الأحرف؛ وتفوز المطابقة التامة، وإن لم توجد فتُعاد الصفوف التي تحتوي الكلمة.
• تسمح Google بـ 60 طلبًا للجدول في الدقيقة للحساب الواحد. وبعد ذلك تقول الأداة ذلك وتعمل من جديد بعد دقيقة.

اختبره

Test connection في البطاقة. يفحص حساب Google الخاص بك، والجدول والتبويب إن ضبطتهما. ثم في Chat اطلب من الوكيل تسجيل متصل تجريبي وانظر إلى الجدول.

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

يظهر صف جديد تحت آخر صف في جدولك؛ وإذا طلبت من الوكيل العثور على ذلك المتصل أعاد الصف.

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

• "No spreadsheet is chosen yet." افتح قائمة ⋯ في البطاقة، ثم Edit settings، وألصق رابط الجدول.
• "The Google Sheets API is not switched on." في مشروع Google Cloud افتح APIs & Services، ثم Library، وفعّل Google Sheets API.
• "That spreadsheet was not found" أو "cannot open that spreadsheet". تحقق من الرابط، وشارك الجدول مع حساب Google المتصل.
• "That sheet tab was not found." تحقق من اسم التبويب في Edit settings.
• "That file is an Excel file opened in Google Sheets." لا يمكن تعديل ملف .xlsx بهذه الطريقة. في Google Sheets اختر File، ثم Save as Google Sheets، واستخدم الجدول الجديد. أما Microsoft Excel نفسه فليس تكاملًا بعد.
• تقع الصفوف في أعمدة خاطئة. ضع ترتيب الأعمدة في Description الخاص بالأداة.
• الوصول محجوب. قد يكون تطبيق Google Cloud في وضع الاختبار؛ فأضف حسابك مستخدم اختبار، أو انشر التطبيق. ولأن الإذن حساس، يعرض التطبيق غير الموثَّق من Google شاشة تحذير.
• "The connected app could not be reached." حاول مرة أخرى؛ وإذا استمر فاستخدم Reconnect.

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

تُخزَّن الرموز مشفّرة. اسحب الوصول في أي وقت من صفحة الأمان في حساب Google الخاص بك؛ وRemove ينساه في Phynxa أيضًا. اربط بحساب يستطيع فتح الجداول التي تريد أن يستخدمها الوكيل فقط.

أدلة ذات صلة

• أدوات التطبيقات المتصلة
• Google Calendar
• نظرة عامة على التكاملات