ارسال پیام انبوه با استفاده از n8n و OpenAi

سیموتل API
1

با توجه به رشد چشمگیر و روزافزون کاربردهای هوش مصنوعی، به‌ویژه در حوزه VoIP، شما می‌توانید با استفاده از پلتفرم قدرتمند n8n یک workflow هوشمند طراحی کرده و فرآیند ارسال پیام‌های شخصی‌سازی‌شده به مشتریان خود را به‌صورت کاملاً خودکار اجرا نمایید.

در این راهکار، ابتدا اطلاعات مورد نظر شما به‌صورت فایل‌های CSV یا XLSX از طریق یک فرم دریافت می‌گردد. سپس با بهره‌گیری از فناوری OpenAI، این پیام‌ها به فایل صوتی تبدیل می‌شوند. در نهایت، فایل‌های صوتی تولید شده توسط سیستم Auto Dialer سیموتل برای مخاطبان پخش خواهد شد.

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

مراحل اجرا:

مراحل اجرای Workflow

1. ایجاد Workflow جدید

در گام نخست، یک workflow جدید در محیط n8n ایجاد نمایید.

2. دریافت فایل از طریق فرم

از بخش پنل نودها، کامپوننت On Form Submission را انتخاب کرده و تنظیمات مربوط به فرم را مطابق نیاز خود پیکربندی کنید:

image
image400×824 29 KB

3.تبدیل فایل به Json

پس از دریافت فایل‌های XLSX یا CSV از طریق فرم، لازم است فایل دریافت شده به فرمت JSON تبدیل شده و به مرحله بعدی فرایند ارسال شوند.

از آنجا که ممکن است کاربران فایل را در قالب CSV یا XLSX ارسال کنند، دو مسیر مجزا برای هر فرمت در نظر گرفته شده است.

image
image541×532 27.3 KB

برای جلوگیری از پردازش مسیر نامربوط، باید در تنظیمات هر نود بررسی شود که آیا فرمت فایل دریافتی مطابق انتظار هست یا خیر.

تنظیمات مسیر XLSX:

image
image463×459 18.1 KB
image
image434×392 13.2 KB

مسیر CSV :

image
image467×382 16.4 KB
image
image405×395 12.8 KB

با این تنظیمات، اگر فایل دریافتی از نوع مورد نظر نباشد، مسیر اشتباه به صورت خودکار نادیده گرفته خواهد شد.

4. افزودن تاریخ و زمان جاری ایران

جهت ثبت دقیق زمان پردازش، از نود Date & Time استفاده کرده و فقط منطقه زمانی (Time Zone) را بر اساس ایران تنظیم نمایید:

image
image805×489 27.3 KB

5. تبدیل متن به صوت با استفاده از OpenAi

پس از انجام مراحل قبلی، اکنون نوبت آن است که فایل متنی به دست آمده را برای تبدیل به صوت به سرویس OpenAI ارسال کنیم. برای این منظور، از پنل نودها، کامپوننت OpenAI را جستجو و انتخاب کرده و مطابق با مراحل زیر تنظیم نمایید.

در این مرحله، لازم است که یک حساب کاربری OpenAI Pro در اختیار داشته باشید. همچنین باید با استفاده از API Token مربوط به حساب خود، یک Credential Account در n8n تعریف کنید تا اتصال به سرویس OpenAI برقرار شود.

تنظیم ورودی:

برای آن‌که OpenAI بتواند متن مورد نظر را پردازش و به صوت تبدیل کند، باید خروجی متنی مرحله‌ی قبلی workflow را به‌عنوان ورودی در این نود قرار دهیم.

در قسمت Text Input، مقدار زیر را وارد کنید:

{{ $('Extract from File1').item.json.Text }}

توجه داشته باشید که اگر نام کامپوننت مرحله قبلی را تغییر داده‌اید، ممکن است این مقدار به‌درستی کار نکند. در این صورت، می‌توانید از منوی سمت چپ، نود مورد نظر را به‌صورت drag & drop به محل Text Input بکشید تا مسیر درست به‌صورت خودکار درج شود.

image
image415×636 22.8 KB
image
image1153×819 56 KB

6. بارگذاری فایل صوتی در سیموتل

تا این مرحله، با بهره‌گیری از OpenAI فایل صوتی مورد نظر تولید شده است. اکنون نیاز داریم این فایل صوتی را برای پخش توسط سیموتل به سیستم Auto Dialer ارسال کنیم.

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

ارسال فایل صوتی به سیموتل

در این مرحله باید از نود HTTP Request در n8n استفاده کنیم تا فایل صوتی ایجادشده را برای سرور سیموتل آپلود کنیم.

در تنظیمات این نود، درخواست شما باید به شکل زیر پیکربندی شود تا در خروجی به شما یک id تعلق بگیرد:

image
image408×542 19.3 KB
.
image
image425×441 13.6 KB

نکات مهم برای برقراری ارتباط صحیح با سرور سیموتل

برای اطمینان از عملکرد صحیح نودهای HTTP Request در ارتباط با API سیموتل، رعایت نکات زیر ضروری است:

  • در بخش Method نود، مقدار باید حتماً بر روی POST تنظیم شود.
  • در بخش Authentication دو رویکرد اصلی وجود دارد:
    1. استفاده از یک Generic Credential Type برای سیموتل: با ایجاد یک Credential سفارشی، اطلاعات احراز هویت (مانند API Token) به‌صورت ایمن به n8n ارائه شده و Headerهای مربوطه به‌صورت خودکار ارسال می‌شوند.
    2. استفاده مستقیم از گزینه Send Headers: در این روش می‌توانید مقادیر Header را به‌صورت دستی و شخصی‌سازی‌شده تنظیم کنید. به‌عنوان مثال:
  • آدرس URL را مطابق مستندات سیموتل وارد کنید (برای مثال: /api/announcement/upload).
  • فایل صوتی خروجی از OpenAI باید به‌عنوان Attachment یا Form-Data در درخواست قرار گیرد.
  • در صورت نیاز، Headerها و توکن احراز هویت (Authorization) نیز باید مطابق با تنظیمات سرور سیموتل اضافه شوند.

7. افزودن آوا به کمپین تماس‌انبوه (Auto Dialer)

پس از آنکه فایل صوتی با موفقیت در سرور سیموتل آپلود شد، نوبت به آن می‌رسد که این فایل را به سیستم Auto Dialer اضافه کنیم تا بتوان از آن در کمپین‌های تماس تلفنی استفاده کرد.

برای انجام این کار، باید یک نود جدید از نوع HTTP Request در محیط n8n ایجاد کرده و خروجی نود قبلی (که شامل id فایل صوتی آپلودشده است) را به آن متصل نمایید.

با استفاده از API سیموتل ، اطلاعات فایل صوتی را به بخش اعلان‌ها (Announcements) اضافه می‌کنید. همچنین برای جلوگیری از ایجاد فایل‌های تکراری با نام یکسان، بهتر است در نام فایل یا عنوان اعلان، زمان آپلود نیز گنجانده شود.

image
image409×536 18.1 KB
.
image
image425×535 18.8 KB

8. ساخت کمپین تماس‌انبوه در سیموتل

پس از افزودن فایل صوتی به بخش اعلان‌ها (Announcements)، اکنون باید کمپین تماس‌انبوه را ایجاد کنیم تا سیستم Auto Dialer بتواند تماس‌ها را به مخاطبین مشخص‌شده برقرار کند.

برای این کار، یک نود جدید HTTP Request در n8n ایجاد نمایید و بدنه درخواست را به‌صورت JSON مطابق ساختار زیر تنظیم کنید:

{
  "name": "TTS - {{ $('Extract from File1').item.json.Number }}",
  "trunk_manager_id": "682d60c9f7e48c74135f31c4",
  "interface_context": "",
  "interface_text": "",
  "numbers": ["{{ $('Extract from File1').item.json.Number }}"],
  "groups": ["", ""],
  "try_interval": "600",
  "try": "1",
  "start": "2024-02-19 15:17",
  "end": "2027-02-23 15:17",
  "announcement": "{{ $json.data._id }}",
  "description": "",
  "count": 3
}
1 پسندیده