انتقل إلى المحتوى الرئيسي

Airtable

اربط قاعدة وجدولًا واحدًا في Airtable برمز وصول شخصي ليستطيع الوكيل تسجيل المكالمات والبحث في الصفوف.

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

سيعرض جدول Airtable واحد Connected.

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

يستطيع الربط إضافة الصفوف وتحديثها والبحث عنها، وهو الأساس لتسجيل المكالمات في جدول.

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

  • حساب Airtable وقاعدة فيها جدول.

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

Airtable هي التي تتحكم في هذه الشاشات. دليل Airtable: Web API.

  1. أنشئ personal access token من airtable.com/create/tokens.
  2. امنحه النطاقين data.records:read وdata.records:write.
  3. أضف القاعدة التي تريد استخدامها إلى قائمة وصول الرمز.
  4. انسخ الرمز، ثم انسخ Base ID من عنوان القاعدة (ويبدأ بـ app) ودوّن اسم الجدول أو معرّفه (tbl…).

اربطه في Phynxa

  1. Integrations، Connect في Airtable.
  2. أدخل Personal access token وBase ID وTable.
  3. اختر Check and connect.

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

الحقلالمعنى
Personal access tokenمطلوب.
Base IDمطلوب. يبدأ بـ app.
Tableمطلوب. اسم جدول أو معرّفه.

تسمح Airtable بنحو 5 طلبات في الثانية لكل قاعدة؛ وإذا ردّت بـ 429 فانتظر 30 ثانية.

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

في تبويب Tools للوكيل، Add tool، Integration، Airtable:

الإجراءما يفعلهيعمل
Find recordsيجد السجلات التي يساوي فيها عمود واحد قيمة، مثل رقم هاتف. ويحتاج field وvalue؛ وmax_records اختياري (حتى 100).ينتظر
Get recordيقرأ سجلًا واحدًا. ويحتاج record_id (يبدأ بـrec) من نتيجة بحث.ينتظر
Create recordيضيف سجلًا. وfields سطر لكل قيمة بصيغة اسم العمود: القيمة، مع أسماء الأعمدة كما هي تمامًا في الجدول.في الخلفية
Update recordيغيّر حقول سجل. ويحتاج record_id وfields (بالصيغة نفسها).في الخلفية

يعمل الوكيل دائمًا في القاعدة والجدول المحفوظين مع الربط، ولا يستطيع تسمية غيرهما.

اختبره

يجب أن يجيب Test connection "Airtable is responding."

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

تعرض البطاقة Connected.

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

  • 403 أو غير موجود. لم تُضَف القاعدة إلى الرمز، أو أن النطاقات مفقودة.
  • جدول خاطئ. استخدم اسم الجدول الدقيق، أو معرّفه tbl….

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

يُخزَّن الرمز مشفّرًا. احذفه في Airtable لسحب الوصول؛ وRemove ينساه هنا.

أدلة ذات صلة

هل في هذه الصفحة ما لا يطابق ما تراه في لوحة التحكم؟ أخبرنا.