برای توسعه‌دهندگان

API چت‌بات وقتی رابط کاربری باید مال خودتان باشد

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

مرز بین ویجت و API کجاست

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

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

آنچه در اختیار شماست

REST استاندارد

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

RESTJSON

پاسخ با ارجاع به منبع

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

ارجاع به منبع

حالت سخت‌گیر

همان قید منابع در API هم برقرار است؛ اگر جواب در منابع نباشد، بات چیزی نمی‌سازد.

بدون حدس

وبهوک برای رویدادها

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

وبهوکرویداد

کجا به کار می‌آید

پنل کاربری محصول

راهنمای داخل محصول باید با زبان طراحی همان پنل بخواند، نه با یک حباب بیرونی.

اپلیکیشن موبایل

در اپلیکیشن بومی، ویجت وب اصلاً گزینه نیست و API تنها مسیر است.

سامانه‌ی داخلی سازمان

برای دستیار داخل سامانه‌های موجود، اتصال از طریق رابط استاندارد ساده‌تر از جاسازی ویجت است.

کانال اختصاصی

اگر کانال ارتباطی خودتان را دارید، همان دانش را می‌شود پشت آن گذاشت.

ویجت یا API

ویجت آماده

کمترین کار، بیشترین سرعت.

  • راه‌اندازی در چند دقیقه
  • بدون توسعه
  • ظاهر قابل تنظیم ولی محدود
  • مناسب سایت عمومی

API

بیشترین کنترل.

  • رابط کاربری کاملاً مال شما
  • قابل استفاده در اپلیکیشن و پنل
  • رویدادها با وبهوک
  • نیازمند توسعه‌ی سمت شما

پرسش‌های رایج فنی

برای استفاده از API باید ویجت را هم داشته باشیم؟

خیر. دو مسیر مستقل‌اند و می‌توانید فقط از API استفاده کنید.

همان دانش ویجت در API هم هست؟

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

محدودیت مصرف دارد؟

بله و به پلن بستگی دارد. جزئیات هر پلن در صفحه‌ی تعرفه‌ها آمده است.

از چه زبانی می‌شود استفاده کرد؟

هر زبانی که بتواند درخواست HTTP بفرستد؛ کتابخانه‌ی اختصاصی لازم نیست.

برای اتصال به CRM هم همین API است؟

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

گفتگو را داخل محصول خودتان بیاورید

برای بررسی سناریوی اتصال، یک جلسه‌ی کوتاه فنی بگذاریم.

آرتین‌مگ

مطالب مرتبط در آرتین‌مگ

این مطالب در آرتین‌مگ، رسانه‌ی تخصصی گروه آرتین، منتشر شده‌اند.

تنظیم شخصیت، لحن و خط قرمز چت‌بات در آرتین‌بات؛ آرتین مگ
چت بات

شخصیت و خط قرمز چت‌بات: دستورالعمل، لحن، پیام خوش‌آمد و سؤال‌های پیشنهادی

چت‌بات شما با لحن چه کسی حرف می‌زند و چه چیزی را هرگز نباید بگوید؟ راهنمای تنظیم دستورالعمل، لحن، خط قرمز، پیام خوش‌آمد و سؤال‌های پیشنهادی در آرتین‌بات، با تست پیش از انتشار و محدودیت‌ها.

2026-10-16· 8 دقیقه· artinmag.ir ↗
هوش فروش آرتین‌بات: از فایل اکسل فروش تا کارت فرصت و پیام کمپین؛ آرتین مگ
چت بات

از فایل اکسل فروش تا فهرست اقدام: هوش فروش آرتین‌بات چه کسی را، چرا و با چه پیامی پیگیری کنیم؟

فایل فروش‌تان پر از مشتری است ولی نمی‌دانید به کدام‌شان چه بگویید. راهنمای هوش فروش آرتین‌بات: بارگذاری اکسل، تحلیل RFM، کارت فرصت، پیام کمپین و کد تخفیف اختصاصی، با محدودیت‌ها و هزینه‌ها.

2026-10-16· 6 دقیقه· artinmag.ir ↗
لینک چت عمومی آرتین‌بات برای بیو اینستاگرام، QR و پیامک؛ چت‌بات بدون سایت؛ آرتین مگ
چت بات

چت‌بات بدون سایت: لینک چت عمومی برای بیو اینستاگرام، QR و پیامک

پیج دارید ولی سایت ندارید؟ لینک چت عمومی آرتین‌بات یک صفحه‌ی چت مستقل می‌سازد که می‌توانید در بیو، QR یا پیامک منتشر کنید. چه چیزی کار می‌کند، کجا بگذاریم و محدودیت‌ها چیست.

2026-10-15· 6 دقیقه· artinmag.ir ↗
آموزش چت‌بات از روی سایت و به‌روزرسانی زمان‌بندی‌شده دانش در آرتین‌بات؛ آرتین مگ
چت بات

چت‌بات را از روی سایت‌تان یاد بدهید، و نگذارید کهنه شود

قیمت سایت عوض شد ولی چت‌بات هنوز عدد قدیمی را می‌گوید. راهنمای آموزش چت‌بات از روی سایت در آرتین‌بات: خزنده با پیش‌نمایش و تأیید، به‌روزرسانی زمان‌بندی‌شده، فایل‌های اسکن‌شده، صوت و ویدیو، سناریوها و محدودیت‌ها.

2026-10-15· 7 دقیقه· artinmag.ir ↗
چت‌بات که نمی‌داند، نمی‌گوید؛ نمی‌دانم به‌جا در آرتین‌بات؛ آرتین مگ
چت بات

چت‌بات که نمی‌داند، نمی‌گوید: جلوگیری از جواب اشتباه با «نمی‌دانم» به‌جا

بدترین جواب چت‌بات «نمی‌دانم» نیست؛ جواب ساختگی است. راهنمای «نمی‌دانم» به‌جا در آرتین‌بات: حالت سخت‌گیر، حد اطمینان، پیام جایگزین، تحویل به انسان، سؤال‌های بی‌پاسخ و محدودیت‌ها.

2026-10-15· 9 دقیقه· artinmag.ir ↗
چت‌بات که نمی‌داند، نمی‌گوید؛ نمی‌دانم به‌جا در آرتین‌بات؛ آرتین مگ
چت بات

چت‌بات که نمی‌داند، نمی‌گوید: جلوگیری از جواب اشتباه با «نمی‌دانم» به‌جا

بدترین جواب چت‌بات «نمی‌دانم» نیست؛ جواب ساختگی است. راهنمای «نمی‌دانم» به‌جا در آرتین‌بات: حالت سخت‌گیر، حد اطمینان، پیام جایگزین، تحویل به انسان، سؤال‌های بی‌پاسخ و محدودیت‌ها.

2026-10-14· 7 دقیقه· artinmag.ir ↗
همه‌ی مطالب در آرتین‌مگ ↗

خانواده‌ی آرتین

شرکت هوش گستر فردا آرتین چند محصول هوش مصنوعی فارسی می‌سازد. هر کدام کار خودش را می‌کند — این‌ها را ببینید تا بدانید کدام به کار شما می‌آید.