اتوماسیون CRM ایر‌تیبل برای شرکت‌کنندگان زوم

اتوماسیون ایجاد رکورد در Airtable CRM برای شرکت‌کنندگان Zoom

این گردش کار به طور خودکار رکوردهای CRM را در Airtable برای شرکت‌کنندگانی که به جلسات Zoom شما می‌پیوندند، ایجاد یا به‌روزرسانی می‌کند. این گردش کار برای کسب‌وکارهایی که به دنبال ساده‌سازی مدیریت مخاطبین و پیگیری تعاملات با ثبت جزئیات شرکت‌کنندگان مستقیماً در CRM Airtable خود هستند، ایده‌آل است. این فرآیند شامل دریافت رویدادهای پیوستن به Zoom از طریق یک وب‌هوک، نرمال‌سازی داده‌های شرکت‌کنندگان و سپس به‌روزرسانی (upsert) این اطلاعات در پایگاه داده Airtable شما است.

این گردش کار و موارد دیگر را در کاتالوگ n8n در Pixori.me کاوش کنید: https://pixori.me/n8n

---

تشریح گردش کار

این اتوماسیون برای اطمینان از مدیریت کارآمد داده‌ها و ادغام با CRM، در مراحل منطقی ساختار یافته است.

۱. دریافت رویدادهای شرکت‌کننده Zoom

هدف: این نود وب‌هوک به عنوان نقطه ورود عمل می‌کند و هر زمان که شرکتی به جلسه می‌پیوندد، اعلان‌های بی‌درنگ را از Zoom دریافت می‌کند.

نود: Webhook

• نوع: n8n-nodes-base.webhook
• عملکرد: گوش دادن به درخواست‌های HTTP POST ورودی از Zoom.
• پیکربندی:

* متد HTTP: POST

* مسیر: /zoom-attendee (این مسیر در تنظیمات برنامه Zoom شما پیکربندی خواهد شد).

• ورودی: درخواست HTTP POST خارجی از Zoom.
• خروجی: بار داده JSON خام از رویداد Zoom، که به نود بعدی منتقل می‌شود.
• مشکلات احتمالی:

* پیکربندی نادرست URL وب‌هوک در Zoom.

* مشکلات اتصال شبکه که مانع از رسیدن Zoom به وب‌هوک می‌شود.

* درخواست‌های غیرمجاز یا بدشکل.

۲. نرمال‌سازی داده‌های شرکت‌کننده

هدف: این نود کد، داده‌های خام دریافتی از وب‌هوک Zoom را پردازش می‌کند، اطلاعات کلیدی را استخراج کرده و آن را به یک فرمت تمیز و سازگار مناسب برای CRM شما استاندارد می‌کند.

نود: Normalize Attendee Data

• نوع: n8n-nodes-base.code
• عملکرد: تجزیه بار داده رویداد Zoom، استخراج جزئیات مربوط به شرکت‌کننده (مانند نام، ایمیل، زمان پیوستن، شناسه جلسه) و افزودن یک مُهر زمانی پردازش. این نود شامل منطق جایگزین برای آدرس‌های ایمیل گمشده است.
• قطعه کد:

```javascript

// Normalize Zoom attendee payload

const e = $input.first().json;

const attendee = e.payload.object.participant;

return {

json: {

meeting_id: e.payload.object.id,

topic: e.payload.object.topic,

join_time: attendee.join_time,

leave_time: attendee.leave_time,

duration: attendee.duration,

name: attendee.user_name,

email: attendee.email || attendee.user_email || 'unknown', // Fallback for email

timestamp: new Date().toISOString()

}

};

```

• ورودی: بار داده JSON از نود Webhook.
• خروجی: یک شیء JSON استاندارد حاوی داده‌های نرمال‌شده شرکت‌کننده.
• مشکلات احتمالی:

* تغییرات غیرمنتظره در ساختار بار داده وب‌هوک Zoom.

* فیلدهای گمشده در بار داده که باعث خطاهای زمان اجرا می‌شود.

۳. به‌روزرسانی (Upsert) رکوردهای CRM در Airtable

هدف: این نود داده‌های نرمال‌شده شرکت‌کننده را دریافت کرده و یا یک رکورد جدید ایجاد می‌کند یا یک رکورد موجود را در پایگاه داده Airtable مشخص شده شما به‌روزرسانی می‌کند. شرکت‌کنندگان جدید به طور خودکار با برچسب "New Lead" تگ می‌شوند.

نود: Save to Airtable

• نوع: n8n-nodes-base.airtable
• عملکرد: به حساب Airtable شما متصل شده و عملیات "Upsert" را انجام می‌دهد. این بدان معناست که اگر رکوردی با کلید مطابق (مثلاً ایمیل) وجود داشته باشد، به‌روزرسانی می‌شود؛ در غیر این صورت، یک رکورد جدید ایجاد می‌شود.
• پیکربندی:

* اعتبارنامه‌های Airtable: نیاز به یک کلید API Airtable با دسترسی کامل دارد.

* شناسه پایگاه و شناسه جدول: شما باید جایگزین‌ها را با شناسه پایگاه و شناسه جدول Airtable خاص خود جایگزین کنید.

* عملیات: Upsert

* نگاشت ستون:

* Tag: با مقدار ثابت "New Lead" تنظیم شده است.

* Name: با استفاده از عبارت ={{ $json.name }} نگاشت شده است.

* Email: با استفاده از عبارت ={{ $json.email }} نگاشت شده است.

* Topic: با استفاده از عبارت ={{ $json.topic }} نگاشت شده است.

* Duration: با استفاده از عبارت ={{ $json.duration }} نگاشت شده است.

* Join Time: با استفاده از عبارت ={{ $json.join_time }} نگاشت شده است.

* Leave Time: با استفاده از عبارت ={{ $json.leave_time }} نگاشت شده است.

* Meeting ID: با استفاده از عبارت ={{ $json.meeting_id }} نگاشت شده است.

• ورودی: داده‌های نرمال‌شده شرکت‌کننده از نود Normalize Attendee Data.
• خروجی: پاسخ از API Airtable، تأیید ایجاد یا به‌روزرسانی رکورد.
• مشکلات احتمالی:

* اعتبارنامه‌های API Airtable نادرست.

* شناسه پایگاه یا شناسه جدول نامعتبر.

* مشکلات شبکه در اتصال به Airtable.

* خطاهای اعتبارسنجی داده در صورتی که داده‌ها با طرحواره Airtable شما مطابقت نداشته باشند.

۴. دستورالعمل‌های راه‌اندازی

هدف: این یادداشت چسبان راهنمایی‌های ضروری را مستقیماً در داخل گردش کار برای راه‌اندازی Zoom، Airtable و پیکربندی نودهای n8n ارائه می‌دهد.

نود: Setup Instructions

• نوع: n8n-nodes-base.stickyNote
• عملکرد: مستندات جاسازی شده برای راهنمایی کاربران در طول فرآیند راه‌اندازی.
• محتوا: شامل مراحل برای:

* ایجاد یک برنامه Zoom و پیکربندی اشتراک رویداد meeting.participant_joined.

* راه‌اندازی یک پایگاه داده Airtable (مثلاً با نام "CRM") با یک جدول "Attendees" و ستون‌های لازم.

* یادآوری برای جایگزینی شناسه‌های Airtable جایگزین و اتصال اعتبارنامه‌های API.

* نمونه‌ای از ظاهر یک ردیف Airtable.

---

راهنمای پیاده‌سازی گام به گام

این مراحل را برای ساخت و پیکربندی گردش کار دنبال کنید:

1. افزودن نود Webhook:

* یک نود جدید ایجاد کرده و نوع Webhook را انتخاب کنید.

* متد HTTP را روی POST و مسیر را روی zoom-attendee پیکربندی کنید.

* این نود یک URL وب‌هوک منحصر به فرد تولید خواهد کرد. این URL را برای استفاده بعدی کپی کنید.

2. افزودن نود Code:

* یک نود جدید ایجاد کرده و نوع Code را انتخاب کنید.

* خروجی نود Webhook را به ورودی این نود Code متصل کنید.

* قطعه کد جاوا اسکریپت ارائه شده را در ویرایشگر نود جای‌گذاری کنید.

3. افزودن نود Airtable:

* یک نود جدید ایجاد کرده و نوع Airtable را انتخاب کنید.

* خروجی نود Code را به ورودی این نود Airtable متصل کنید.

* اعتبارنامه‌ها: کلید API Airtable خود را راه‌اندازی کنید.

* پیکربندی:

* عملیات را روی Upsert تنظیم کنید.

* Base ID و Table ID Airtable خود را وارد کنید (جایگزین‌ها را جایگزین کنید).

* ستون‌ها را همانطور که در بخش "به‌روزرسانی (Upsert) رکوردهای CRM در Airtable" در بالا توضیح داده شد، با استفاده از عبارات مناسب (مانند ={{ $json.name }}) نگاشت کنید.

4. افزودن یادداشت چسبان:

* یک نود جدید ایجاد کرده و نوع Sticky Note را انتخاب کنید.

* دستورالعمل‌های راه‌اندازی دقیق را در این یادداشت برای ارجاع آسان جای‌گذاری کنید.

5. اتصال نودها: اطمینان حاصل کنید که نودها به ترتیب صحیح متصل شده‌اند: Webhook → Code → Airtable.

6. پیکربندی برنامه Zoom:

* یک برنامه جدید در حساب توسعه‌دهنده Zoom خود (JWT یا OAuth) ایجاد کنید.

* اشتراک رویداد meeting.participant_joined را فعال کنید.

* در تنظیمات وب‌هوک، URL تولید شده توسط نود Webhook n8n خود را جای‌گذاری کنید و /zoom-attendee را به انتهای آن اضافه کنید.

* برنامه Zoom خود را فعال کنید.

7. راه‌اندازی پایگاه داده Airtable:

* یک پایگاه داده جدید در Airtable (مثلاً با نام "CRM") ایجاد کنید.

* یک جدول در آن پایگاه داده ایجاد کنید (مثلاً با نام "Attendees").

* اطمینان حاصل کنید که جدول دارای ستون‌های زیر است (یا نگاشت خود را بر این اساس تنظیم کنید): Meeting ID, Topic, Name, Email, Join Time, Leave Time, Duration, Tag.

8. نهایی کردن پیکربندی نود Airtable:

* به نود Airtable در n8n برگردید.

* YOUR_AIRTABLE_BASE_ID و YOUR_AIRTABLE_TABLE_ID جایگزین را با شناسه‌های واقعی Airtable خود جایگزین کنید.

9. آزمایش گردش کار:

* گردش کار را در n8n فعال کنید.

* به یک جلسه Zoom بپیوندید تا وب‌هوک را فعال کنید.

* پایگاه داده Airtable خود را بررسی کنید تا تأیید کنید که یک رکورد جدید ایجاد شده یا یک رکورد موجود به‌روزرسانی شده است.

---

منابع