تحلیل تماس‌های BeyondPresence با GPT-4o-mini و Google Sheets

تحلیل تماس‌های BeyondPresence با GPT-4o-mini و Google Sheets

این گردش کار، تحلیل تماس‌های ویدیویی ضبط شده توسط BeyondPresence را خودکار می‌کند. از GPT-4o-mini برای دریافت بینش‌های مکالمه‌ای استفاده کرده و نتایج را برای دسترسی و گزارش‌دهی آسان در Google Sheets ذخیره می‌کند.

کاتالوگ Axeto.ai: https://axeto.ai/n8n

نمای کلی گردش کار

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

موارد استفاده کلیدی:

• تحلیل پس از تماس: تحلیل خودکار تعاملات عامل ویدیویی.
• استخراج بینش: استخراج خلاصه‌ها، احساسات و موارد اقدام از تماس‌ها.
• بایگانی داده‌ها: متمرکز کردن تحلیل‌های تماس در Google Sheets برای گزارش‌دهی و پیگیری.

مراحل گردش کار:

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

2. اعتبارسنجی و غنی‌سازی داده‌ها: اطمینان از یکپارچگی داده‌ها و افزودن فراداده‌های متنی.

3. تحلیل مبتنی بر هوش مصنوعی: استفاده از GPT-4o-mini برای تحلیل محتوای تماس و تولید بینش‌های ساختاریافته.

4. ذخیره‌سازی داده‌ها: افزودن نتایج تحلیل شده به یک Google Sheet.

5. مدیریت خطا و افزونه‌ها (اختیاری): شامل نکاتی برای پیاده‌سازی مدیریت خطای قوی و ادغام‌های بیشتر.

جزئیات گردش کار

۱. دریافت ورودی

این بخش رویداد پایان تماس BeyondPresence را دریافت می‌کند، دریافت را تأیید کرده و رویدادهای مرتبط را فیلتر می‌کند.

گره‌ها (Nodes):

• BeyondPresence Webhook (Webhook Trigger)

* هدف: گوش دادن به درخواست‌های POST ورودی از BeyondPresence هنگام پایان تماس.

* پیکربندی:

* HTTP Method: POST

* Path: /beyondpresence-call-webhook

* Raw Body: غیرفعال

* Response Mode: Response Node

* ورودی: تماس وب‌هوک خارجی از BeyondPresence.

* خروجی: بار داده JSON حاوی فراداده تماس، رونوشت و معیارهای ارزیابی.

• Acknowledge Webhook (Respond to Webhook)

* هدف: ارسال فوری تأییدیه به سیستم BeyondPresence.

* پیکربندی:

* Response Code: 200

* Respond With: JSON

* Response Body:

```json

{

"status": "success",

"message": "Webhook received and processing",

"timestamp": "{{ $now.toISO() }}"

}

```

* ورودی: خروجی گره BeyondPresence Webhook.

* خروجی: پاسخ HTTP 200 ارسال شده به تماس‌گیرنده.

• Filter Call Events (Switch)

* هدف: اطمینان از پردازش فقط رویدادهای call_ended.

* پیکربندی:

* Rule: body.event_type برابر با "call_ended".

* ورودی: بار داده JSON از Acknowledge Webhook.

* خروجی: رویدادهای call_ended را به مرحله بعدی هدایت می‌کند؛ رویدادهای دیگر منحرف می‌شوند.

۲. اعتبارسنجی و غنی‌سازی داده‌ها

این مرحله فیلدهای حیاتی داده را اعتبارسنجی کرده، مدت زمان تماس را محاسبه می‌کند و اطلاعات متنی را استخراج می‌کند.

گره‌ها (Nodes):

• Validate & Enrich Data (Code - JavaScript)

* هدف: بررسی فیلدهای ضروری داده و افزودن فراداده‌های محاسبه شده.

* پیکربندی:

* اعتبارسنجی: حضور event_type, call_id, call_data (شامل userName, startedAt, endedAt) و آرایه messages را تأیید می‌کند. در صورت شکست اعتبارسنجی، خطا ایجاد می‌کند.

* غنی‌سازی:

* مدت زمان تماس (دقیقه و رشته فرمت شده) را محاسبه می‌کند.

* روز هفته را از زمان شروع تعیین می‌کند.

* زمان روز (مثلاً صبح، بعد از ظهر) را طبقه‌بندی می‌کند.

* تعداد پیام‌ها را می‌شمارد.

* شناسایی می‌کند که آیا پیام‌ها موارد اقدام را بر اساس کلمات کلیدی مانند "will do", "follow up" دارند یا خیر.

* ورودی: داده‌های رویداد call_ended اعتبارسنجی شده.

* خروجی: داده‌های JSON غنی شده با وضعیت اعتبارسنجی و فیلدهای محاسبه شده.

۳. تحلیل مبتنی بر هوش مصنوعی

این بخش از GPT-4o-mini برای تحلیل محتوای تماس و تولید بینش‌های ساختاریافته استفاده می‌کند.

گره‌ها (Nodes):

• AI Call Analysis (LangChain OpenAI)

* هدف: تحلیل رونوشت‌های تماس و فراداده با استفاده از GPT-4o-mini.

* پیکربندی:

* Model: gpt-4o-mini

* Temperature: 0.3 (برای خلاقیت کنترل شده)

* Top P: 0.9

* System Message: دستورالعمل‌های دقیقی برای تحلیل ارائه می‌دهد و فرمت خروجی JSON سختگیرانه را الزامی می‌کند.

* User Message: JSON رشته‌ای شده داده‌های تماس غنی شده (ارزیابی، پیام‌ها) را به عنوان زمینه شامل می‌شود.

* ورودی: داده‌های اعتبارسنجی و غنی شده از Validate & Enrich Data.

* خروجی: متن تولید شده توسط هوش مصنوعی حاوی تحلیل ساختاریافته در یک بلوک کد markdown.

• Parse AI Response (Code - JavaScript)

* هدف: استخراج و پاکسازی خروجی JSON از پاسخ هوش مصنوعی.

* پیکربندی:

* JSON را از بلوک‌های کد markdown یا مستقیماً از محتوا استخراج می‌کند.

* رشته JSON را پاکسازی می‌کند (حذف نظرات، کاماهای انتهایی و غیره).

* رشته JSON پاکسازی شده را تجزیه می‌کند. در صورت شکست تجزیه، خطاهای آموزنده ایجاد می‌کند.

* ورودی: پاسخ متنی خام از AI Call Analysis.

* خروجی: شیء JSON تجزیه شده حاوی تحلیل ساختاریافته تماس.

۴. ذخیره‌سازی داده‌ها

داده‌های تحلیل شده تماس به یک Google Sheet اضافه می‌شوند.

گره‌ها (Nodes):

• Save to Google Sheets (Google Sheets)

* هدف: ذخیره نتایج تحلیل ساختاریافته تماس در یک Google Sheet.

* پیکربندی:

* Operation: Append row

* Document ID: کاربر باید شناسه الگوی Google Sheet خود را ارائه دهد.

* Sheet Name: از اولین شیت (gid=0) استفاده می‌کند.

* Column Mapping: فیلدهای JSON تجزیه شده هوش مصنوعی را به ستون‌های خاص نگاشت می‌کند (مثلاً تاریخ، عنوان، موضوع، خلاصه، موارد اقدام، احساسات). تقریباً ۳۰ ستون پیکربندی شده است.

* Cell Format: USER_ENTERED

* ورودی: JSON تحلیل تجزیه شده از Parse AI Response.

* خروجی: تأیید عملیات افزودن ردیف.

۵. مدیریت خطا و افزونه‌ها (نکات مستند شده)

اینها نکات مشاوره‌ای برای بهبود استحکام و عملکرد گردش کار هستند.

گره‌ها (Nodes):

• Error Handling Note (Sticky Note)

* محتوا: پیاده‌سازی یک گره trigger خطا برای ثبت شکست‌ها، ثبت خطاها در یک شیت جداگانه، اطلاع‌رسانی به مدیران و احتمالاً پیاده‌سازی مکانیزم‌های تلاش مجدد را توصیه می‌کند. این گره در گردش کار فعلی متصل نیست اما به عنوان یک پیشنهاد بهترین روش عمل می‌کند.

• Extension Options (Sticky Note)

* محتوا: ادغام‌های بالقوه مانند ارسال اعلان‌های Slack برای احساسات یا موارد اقدام حیاتی، انجام پشتیبان‌گیری منظم از پایگاه داده داده‌های تحلیلی، یا به‌روزرسانی رکوردهای CRM با خلاصه‌های تماس را پیشنهاد می‌کند. اینها پیاده‌سازی نشده‌اند اما امکانات را برای توسعه آینده ترسیم می‌کنند.

بازسازی گردش کار

برای بازسازی این گردش کار:

1. راه‌اندازی وب‌هوک:

* یک گره Webhook اضافه کنید.

* آن را همانطور که در بخش "BeyondPresence Webhook" بالا توضیح داده شد، پیکربندی کنید.

2. تأیید وب‌هوک:

* یک گره Respond to Webhook اضافه کنید.

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

* جزئیات پاسخ را همانطور که مشخص شده پیکربندی کنید.

3. فیلتر رویدادها:

* یک گره Switch اضافه کنید.

* ورودی آن را به خروجی گره Respond to Webhook متصل کنید.

* قانون را برای فیلتر کردن body.event_type برابر با "call_ended" تنظیم کنید.

4. اعتبارسنجی و غنی‌سازی داده‌ها:

* یک گره Code (JavaScript) اضافه کنید.

* ورودی آن را به خروجی گره Switch (مسیر "true" یا مطابق) متصل کنید.

* منطق اعتبارسنجی و غنی‌سازی را همانطور که در بخش "Validate & Enrich Data" توضیح داده شده، پیاده‌سازی کنید.

5. انجام تحلیل هوش مصنوعی:

* یک گره OpenAI (از مجموعه LangChain) اضافه کنید.

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

* مدل (gpt-4o-mini)، دما و اعلان‌ها را همانطور که توضیح داده شده پیکربندی کنید. اطمینان حاصل کنید که کلید API OpenAI شما در اعتبارنامه‌های n8n شما تنظیم شده است.

6. تجزیه خروجی هوش مصنوعی:

* یک گره Code دیگر (JavaScript) اضافه کنید.

* ورودی آن را به خروجی گره OpenAI متصل کنید.

* منطق تجزیه و پاکسازی JSON را پیاده‌سازی کنید.

7. ذخیره در Google Sheets:

* یک گره Google Sheets اضافه کنید.

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

* گره را پیکربندی کنید:

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

* شناسه سند Google Sheet خود را وارد کنید.

* فیلدهای JSON ورودی را به ستون‌های مناسب در شیت خود نگاشت کنید. اطمینان حاصل کنید که اعتبارنامه‌های API Google Sheets شما پیکربندی شده‌اند.

8. افزودن یادداشت‌های چسبنده:

* گره‌های Sticky Note را برای مستندات، پیشنهادات مدیریت خطا و ایده‌های افزونه همانطور که مشخص شده، بگنجانید.