رفتن به محتوا

اتوماسیون با n8n و هوش مصنوعی؛ دسته‌بندی خودکار پیام‌ها قدم‌به‌قدم

یک ورک‌فلو واقعی در n8n که پیام‌های ورودی را با مدل هوش مصنوعی در دسته‌های پرداخت، فنی و فروش دسته‌بندی می‌کند؛ تنظیم نودها، تست با curl و هزینهٔ هر پیام.

ینال احمدزاده۷ دقیقه مطالعه
رباتی کوچک پشت میز که پاکت‌های نامهٔ رسیده را روی یک نوار نقاله در چند سبد رنگی جدا می‌کند

پیام‌هایی که از فرم تماس سایت، ایمیل یا پیام‌رسان می‌رسند معمولاً یک صف شلوغ می‌سازند: یکی مشکل پرداخت دارد، یکی خطای فنی گرفته و یکی فقط می‌خواهد دربارهٔ قیمت سازمانی بپرسد. در این مطلب یک ورک‌فلو کامل در n8n می‌سازیم که هر پیام را با یک مدل هوش مصنوعی می‌خواند، دسته‌اش را تشخیص می‌دهد و به شاخهٔ درست می‌فرستد. همهٔ مراحل را روی n8n نسخهٔ 2.47.3 و API واقعی هیبانا اجرا کرده‌ایم و خروجی‌ها و عددهایی که می‌بینید از همان اجرا هستند.

ورک‌فلو چه کاری انجام می‌دهد

ورک‌فلو چهار بخش دارد:

  1. Webhook یک آدرس می‌سازد که پیام را با درخواست POST می‌گیرد؛ فرم سایت یا هر سرویس دیگری می‌تواند به آن پیام بفرستد.
  2. Text Classifier متن پیام را به مدل می‌دهد و بر اساس دسته‌هایی که تعریف کرده‌اید، آن را به یکی از خروجی‌هایش می‌فرستد.
  3. OpenAI Chat Model مدلی است که Text Classifier از آن استفاده می‌کند؛ این نود را به هیبانا وصل می‌کنیم.
  4. Respond to Webhook در انتهای هر شاخه، نتیجه را به فرستنده برمی‌گرداند. در کار واقعی می‌توانید این نود را با ارسال ایمیل، ثبت در جدول یا ارسال پیام به گروه پشتیبانی جایگزین کنید.

Text Classifier برای هر دسته یک خروجی جداگانه دارد. ما سه دستهٔ billing (پرداخت)، technical (فنی) و sales (فروش) تعریف کرده‌ایم و یک شاخهٔ Other هم برای پیام‌هایی که در هیچ دسته‌ای نمی‌گنجند، در نظر گرفته‌ایم.

نصب n8n و اتصال به هیبانا

اگر n8n ندارید، طبق مستندات n8n ساده‌ترین راه Docker است (خلاصهٔ دستور رسمی؛ نسخهٔ کامل با تنظیم منطقهٔ زمانی در همان صفحه است):

docker volume create n8n_datadocker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n n8nio/n8n

بعد http://localhost:5678 را باز کنید. ما برای این آزمون n8n را با npm نصب کردیم. مستندات n8n نسخهٔ ۲۰.۱۹ تا ۲۴ از Node.js را ذکر می‌کند، اما نسخهٔ 2.47.3 فقط روی Node.js 24 اجرا شد و هنگام شروع هشدار داد که اجرای n8n بیرون از کانتینر منسوخ شده است. پس اگر روی سرور نصب می‌کنید، همان Docker را انتخاب کنید.

برای اتصال به هیبانا یک Credential از نوع OpenAI بسازید. این Credential فیلدی به نام Base URL دارد که مقدار پیش‌فرض آن https://api.openai.com/v1 است. آن را به این آدرس تغییر دهید:

https://api-ai.hibanacloud.ir/v1

و در فیلد API Key کلید خود را بگذارید. اگر کلید ندارید، مراحل ساخت آن در دریافت کلید API آمده است. راهنمای تصویری همین اتصال در صفحهٔ اتصال به n8n هم هست؛ این مطلب از همان نقطه ادامه می‌دهد.

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

نود Webhook

یک نود Webhook اضافه کنید و این تنظیمات را بدهید:

  • HTTP Method: POST
  • Path: incoming-message
  • Respond: Using 'Respond to Webhook' Node

گزینهٔ آخر می‌گوید پاسخ درخواست را نود دیگری در انتهای ورک‌فلو می‌دهد. بدنهٔ JSON درخواست در خروجی Webhook زیر کلید body قرار می‌گیرد؛ یعنی متن پیام در $json.body.message است.

نود Text Classifier

بعد از Webhook نود Text Classifier را اضافه کنید:

  • Text to Classify: عبارت {{ $json.body.message }}
  • Categories: برای هر دسته یک نام و یک توضیح بنویسید. توضیح به مدل می‌گوید منظور شما از آن دسته چیست و هرچه دقیق‌تر باشد، دسته‌بندی بهتر می‌شود. توضیح‌ها را می‌توانید فارسی بنویسید:
CategoryDescription
billingپرداخت، شارژ کیف پول، فاکتور، موجودی و هزینه
technicalخطای API، مشکل اتصال، کد، کلید API و تنظیم ابزارها
salesسؤال پیش از خرید، همکاری، قیمت برای سازمان‌ها

در بخش Options گزینهٔ When No Clear Match را روی Output on Extra, 'Other' Branch بگذارید. مقدار پیش‌فرض آن Discard Item است؛ یعنی پیامی که به هیچ دسته‌ای نخورد، بی‌صدا حذف می‌شود. برای صف پشتیبانی این خطرناک است، چون پیامی گم می‌شود و کسی متوجه نمی‌شود.

نام دسته‌ها را لاتین و کوتاه نگه دارید. n8n از روی همین نام‌ها یک قالب JSON برای پاسخ مدل می‌سازد و همان‌ها برچسب خروجی‌های نود هم می‌شوند.

نود OpenAI Chat Model

Text Classifier یک ورودی Model دارد. روی آن کلیک کنید، OpenAI Chat Model را انتخاب کنید و Credential هیبانا را به آن بدهید. سه تنظیم مهم‌اند:

  • Model: حالت ID را انتخاب کنید و gpt-5-nano را بنویسید. فهرست مدل‌ها هم از هیبانا خوانده می‌شود و می‌توانید از آن انتخاب کنید، اما طبق کد n8n، گزینهٔ Reasoning Effort فقط برای نام مدل‌هایی نشان داده می‌شود که با gpt-5، o1 یا یکی از o3 تا o9 شروع شوند و نام‌هایی مثل openai/gpt-5-nano در فهرست این شرط را ندارند.
  • Use Responses API: خاموش. در این حالت نود از Chat Completions استفاده می‌کند که مستندات هیبانا بر پایهٔ آن نوشته شده است.
  • Options → Reasoning Effort: Low. برای تشخیص دسته، استدلال طولانی لازم نیست و این گزینه هزینه را کم می‌کند؛ عددهای آن را پایین‌تر می‌بینید.

GPT-5 nano کوچک‌ترین و سریع‌ترین عضو خانوادهٔ GPT-5 است و برای کار ساده‌ای مثل دسته‌بندی کافی است. مدل‌های متنی دیگر را هم می‌توانید از لیست مدل‌ها انتخاب و با همین Credential امتحان کنید؛ فقط پیش از استفاده، دسته‌بندی را با چند پیام نمونه بسنجید.

نودهای Respond to Webhook

به هر چهار خروجی Text Classifier یک نود Respond to Webhook وصل کنید. Respond With را روی JSON بگذارید و در Response Body برای شاخهٔ پرداخت بنویسید:

{{ { category: 'billing', message: $json.body.message } }}

برای شاخه‌های دیگر فقط مقدار category را عوض کنید. سپس ورک‌فلو را Publish کنید تا آدرس Production فعال شود.

تست ورک‌فلو با curl

حالا چهار پیام متفاوت به آدرس Production وبهوک می‌فرستیم:

for m in "کیف پولم را شارژ کردم ولی موجودی هنوز صفر است" \         "هنگام فراخوانی API خطای 401 می‌گیرم" \         "برای شرکتمان با ۲۰ کارمند پلن سازمانی دارید؟" \         "ممنون، روز خوبی داشته باشید"; do  curl -s -X POST http://localhost:5678/webhook/incoming-message \    -H "Content-Type: application/json" \    -d "{\"message\": \"$m\"}"  echodone

خروجی واقعی:

{"category":"billing","message":"کیف پولم را شارژ کردم ولی موجودی هنوز صفر است"}{"category":"technical","message":"هنگام فراخوانی API خطای 401 می‌گیرم"}{"category":"sales","message":"برای شرکتمان با ۲۰ کارمند پلن سازمانی دارید؟"}{"category":"other","message":"ممنون، روز خوبی داشته باشید"}

هر چهار پیام به شاخهٔ درست رفتند و پیام تشکر، که در هیچ دسته‌ای نبود، به Other رسید. در تب Executions ورک‌فلو می‌توانید پاسخ خام مدل را هم ببینید. برای پیام آخر این بود:

{"billing":false,"technical":false,"sales":false,"fallback":true}

یعنی مدل برای هر دسته یک مقدار درست یا نادرست برمی‌گرداند و n8n بر اساس آن پیام را به خروجی مناسب می‌فرستد.

اگر کلید اشتباه باشد

در اولین اجرای ما کلید به Credential نرسیده بود. Text Classifier با پیام «Authorization failed - please check your credentials» متوقف شد و curl فقط {"message":"Error in workflow"} گرفت. طبق مستندات n8n، اگر پیش از رسیدن به Respond to Webhook خطایی رخ دهد، فرستنده پاسخ ۵۰۰ می‌گیرد. علت دقیق را در تب Executions ببینید؛ معنی کدهای خطای API را در خطاهای API هوش مصنوعی نوشته‌ایم.

هزینهٔ هر پیام

n8n برای هر اجرا تعداد توکن‌های مصرفی را در خروجی OpenAI Chat Model نشان می‌دهد. در آزمون ما هر پیام حدود ۵۲۰ توکن ورودی مصرف کرد؛ بیشتر آن مربوط به دستورهایی است که n8n خودش به پیام اضافه می‌کند؛ این دستورها فهرست دسته‌ها و قالب JSON را هم در بر می‌گیرند. توکن خروجی به Reasoning Effort بستگی داشت:

Reasoning Effortتوکن ورودیتوکن خروجیهزینهٔ تقریبی هر پیام
پیش‌فرض (بدون تنظیم)۵۱۹ تا ۵۲۶۴۱۴حدود ۹۱۰ ریال
Low۵۱۹ تا ۵۲۶۹۴ تا ۱۵۸حدود ۳۱۰ تا ۴۳۰ ریال

هزینه را از روی قیمت GPT-5 nano در زمان نگارش این مطلب حساب کرده‌ایم: ۲۶۰٬۰۰۰ ریال برای هر میلیون توکن ورودی و ۱٬۸۷۰٬۰۰۰ ریال برای هر میلیون توکن خروجی. توکن خروجی شامل توکن‌های استدلال مدل هم هست و به همین دلیل از طول پاسخ کوتاه JSON بیشتر است. قیمت فعلی را در صفحهٔ GPT-5 nano ببینید و برای آشنایی با نحوهٔ محاسبه، توکن چیست و هزینهٔ API چطور حساب می‌شود را بخوانید.

یک نکته هم دربارهٔ گزینهٔ Enable Auto-Fixing در Text Classifier: این گزینه به‌طور پیش‌فرض روشن است و اگر پاسخ مدل در قالب درست نباشد، n8n یک درخواست دیگر به مدل می‌فرستد تا آن را اصلاح کند. در آزمون ما این اتفاق نیفتاد، اما اگر هزینه را دقیق کنترل می‌کنید، بدانید که یک پیام ممکن است دو درخواست مصرف کند.

محدودیت‌ها و نکته‌های کار واقعی

  • دسته‌بندی مدل همیشه درست نیست. پیام‌های مبهم، مثل «پول را پرداخت کردم ولی API کار نمی‌کند»، به هر دو دستهٔ پرداخت و فنی مربوط‌اند. اگر چنین پیام‌هایی زیاد دارید، گزینهٔ Allow Multiple Classes To Be True را روشن کنید تا پیام به همهٔ شاخه‌های مرتبط برود.
  • توضیح دسته‌ها مهم‌تر از نام آن‌هاست. اگر پیامی مدام در دستهٔ اشتباه قرار می‌گیرد، اول توضیح دسته را دقیق‌تر کنید.
  • آدرس وبهوک را عمومی رها نکنید. هر کسی که آدرس Production را بداند می‌تواند به آن پیام بفرستد و هزینهٔ مدل را مصرف کند. نود Webhook گزینه‌های احراز هویت دارد؛ پیش از انتشار یکی را فعال کنید.
  • برای پیام‌های زیاد، به محدودیت تعداد درخواست کلید خود توجه کنید. Text Classifier در بخش Options، گزینهٔ Batch Processing را هم دارد که با Batch Size و Delay Between Batches تعداد و فاصلهٔ درخواست‌ها را تنظیم می‌کند.
  • پیام‌رسان بله نود آماده در n8n ندارد، اما با نود HTTP Request می‌توانید پاسخ را به API بازوی بله بفرستید. ساخت بازو را در ساخت چت‌بات برای سایت و بازوی بله توضیح داده‌ایم.

جمع‌بندی

با یک نود Webhook، یک نود Text Classifier، یک نود OpenAI Chat Model و چهار نود Respond to Webhook یک صف پیام را به‌طور خودکار دسته‌بندی کردیم. تنها کار لازم برای استفاده از هیبانا، تنظیم Base URL در Credential روی https://api-ai.hibanacloud.ir/v1 بود. با Reasoning Effort روی Low هزینهٔ هر پیام در آزمون ما به کمتر از نصف رسید. قدم بعدی این است که به‌جای Respond to Webhook، هر شاخه را به ابزار واقعی تیم خود وصل کنید. برای شروع، راهنمای تصویری اتصال به n8n را ببینید و اگر تازه با API هوش مصنوعی آشنا می‌شوید، راهنمای API هوش مصنوعی نقطهٔ شروع خوبی است.

مطالب مرتبط

با یک کلید به همه مدل‌ها وصل شوید

GPT، Claude، Gemini و ده‌ها مدل دیگر، با پرداخت ریالی و یک API سازگار با OpenAI.