تفاوت بین دانستن و جستجو کردن
دو نوع سؤال مشتری وجود دارد. نوع اول کلی است: سیاست بازگشت شما چیست؟ حمل چقدر طول میکشد؟ آیا به آلمان حمل میکنید؟ یک پایگاه دانش با موجودی خوب اینها را مدیریت میکند.
نوع دوم خاص است: سفارش #۴۵۲۱ من کجاست؟ آیا نسخه آبی هنوز موجود است؟ این ماه چه چیزی در طرح من باقی مانده است؟ اینها در پایگاه دانش زندگی نمیکنند. آنها در سیستمهای شما زندگی میکنند — مدیریت سفارش شما، موجودی شما، صورتحساب شما — و هر ثانیه تغییر میکنند.
چتباتی که فقط میتواند نوع اول را مدیریت کند یک سؤالات متداول جلال داده شده است. چتباتی که میتواند نوع دوم را نیز مدیریت کند یک دستیار است. تفاوت بین این دو دسترسی به API است.
چرا این شکاف هزینه مشتریان را برای شما دارد
بیشتر "گفتگوی هوش مصنوعی" امروز فقط بر یک پایگاه دانش بنا شده است. میتواند سیاست حمل شما را به هفده زبان بازنویسی کند، اما نمیتواند به مشتری بگوید بسته واقعی آنها در حال حاضر کجاست. بنابراین مشتری میپرسد، بات منحرف میکند و مشتری یا تسلیم میشود یا منتظر میماند تا اپراتور دادههایی را که بات میتوانست در میلیثانیه دریافت کند جستجو کند.
این سقف چتبات است. هر "اجازه دهید برایتان بررسی کنم" یک فرصت از دست رفته است که در عرض چند ثانیه، در پیام اول، در حالی که قصد مشتری هنوز داغ است، پاسخ دهید.
اتصالات API واقعاً چه کاری انجام میدهند
در enuchat، یک اتصال API یک پیوند پیکربندی شده بین گفتگو و یکی از خدمات بکاند شما است. شما آن را یک بار تعریف میکنید: URL پایه، روش احراز هویت و چند endpoint با پارامترهای خود و نحوه نگاشت پاسخ.
از آن نقطه به بعد، هوش مصنوعی میتواند آن endpointها را در طول یک گفتگو فراخوانی کند. وقتی بازدیدکننده درباره سفارش میپرسد، هوش مصنوعی شماره سفارش را استخراج میکند، endpoint سفارش شما را فراخوانی میکند، وضعیت زنده را میخواند و آن را در پاسخ تا میکند. بازدیدکننده یک جمله میبیند: "سفارش #۴۵۲۱ شما دیروز ارسال شد و انتظار میرود پنجشنبه برسد." پشت این جمله، یک فراخوانی API واقعی اتفاق افتاد.
مشتری لولهکشی را نمیبیند. آنها فقط میبینند که گفتگو واقعاً میداند.
پنج روش احراز هویت، بدون کد سفارشی
بیشتر APIهایی که میخواهید متصل کنید قبلاً از احراز هویت استاندارد استفاده میکنند. enuchat از پنج مورد خارج از جعبه پشتیبانی میکند:
- None — برای APIهای عمومی که به احراز هویت نیاز ندارند
- API Key — به عنوان هدر یا پارامتر کوئری ارسال میشود
- Bearer Token — برای احراز هویت ساده مبتنی بر توکن
- Basic Auth — برای سیستمهای قدیمی
- OAuth 2.0 client credentials — برای ارائهدهندگان مدرن مانند Salesforce، HubSpot یا سرور OAuth خودتان
برای OAuth 2.0، enuchat چرخه عمر توکن را به طور خودکار مدیریت میکند — در فراخوانی اول دریافت میکند، تا انقضا کش میکند، در صورت نیاز تازه میکند. اعتبارنامهها را یک بار پیکربندی میکنید و فراموش میکنید. همه اعتبارنامهها در حالت استراحت با libsodium رمزگذاری میشوند و هرگز در پاسخهای API ظاهر نمیشوند.
متغیرها، قالبها و نگاشت پاسخ
Endpointها به عنوان قالب تعریف میشوند. مسیری مانند /orders/{orderId} یا یک بدنه JSON که {customerId} را ارجاع میدهد، مقادیر را از متغیرهای نشست — متغیرهایی که هوش مصنوعی یا یک قانون استاتیک میتواند در طول گفتگو تنظیم کند — درج میکند.
وقتی API پاسخ میدهد، فیلدها را از پاسخ JSON با استفاده از نشانهگذاری نقطه به متغیرهای نشست بازمیگردانید. data.status به order_status تبدیل میشود. data.shipping.eta به delivery_eta تبدیل میشود. سپس هوش مصنوعی این مقادیر را در یک پاسخ زبان طبیعی — به زبان خود بازدیدکننده — میبافد.
سه الگو که بیشتر موارد استفاده را پوشش میدهد
در عمل، بیشتر یکپارچهسازیهای API در یکی از سه شکل قرار میگیرند.
جستجو و پاسخ
بازدیدکننده سؤالی میپرسد که میتوان با یک فراخوانی API به آن پاسخ داد. قانون CALL_API را شلیک میکند و پس از آن REPLY_AI. هوش مصنوعی از دادههای دریافت شده برای ایجاد پاسخی مبتنی و زمینهای استفاده میکند. وضعیت سفارش، موجودی حساب، در دسترس بودن اتاق، قیمتگذاری فعلی، ردیابی بسته — همه اینها اینجا قرار میگیرند.
جستجو و مسیریابی
فراخوانی API اطلاعات کافی را برای تصمیمگیری در مورد آنچه بعد انجام شود برمیگرداند. یک حساب با ارزش بالا به یک نماینده ارشد تشدید میشود. یک اشتراک منقضی شده به صورتحساب مسیریابی میشود. هوش مصنوعی از CALL_API و پس از آن ASSIGN_TO_OPERATOR برای تصمیمگیری مسیریابی بر اساس دادههای واقعی مشتری استفاده میکند، نه حدس.
جریانهای چند مرحلهای
پیام اول گفتگو را با SET_VARIABLE برچسبگذاری میکند، دومی فراخوانی API را وقتی زمینه کافی وجود دارد فعال میکند، و سومی پاسخ را تشکیل میدهد. مفید است وقتی نیاز به تأیید قصد قبل از پینگ کردن بکاند خود دارید، یا وقتی جستجوی داده به چیزی که بازدیدکننده دو پیام پیش گفت بستگی دارد.
امنیت داخلی
اتصال بکاندها به یک ویجت گفتگو برخی تیمها را عصبی میکند، و باید چنین کند. enuchat چندین لایه حفاظت را به طور پیشفرض ارائه میدهد:
- پیشگیری SSRF فراخوانیها به localhost، IPهای خصوصی و نامهای میزبان فقط داخلی را مسدود میکند
- تایماوت ۵ ثانیهای یک API کند را از معلق شدن گفتگو متوقف میکند
- محدودهبندی tenant به این معنی است که هیچ نشت دادهای بین tenantها وجود ندارد — endpointهای شما فقط برای ویجتهای خودتان قابل مشاهده هستند
- دکمههای آزمایش هم اتصال و هم هر endpoint را به طور مستقل قبل از اتصال به قوانین تأیید میکنند
- اعتبارنامههای رمزگذاری شده هرگز به شکل واضح به داشبورد بازنمیگردند
چه چیزی برای مشتریان شما تغییر میکند
گفتگو از "اجازه دهید کسی را پیدا کنم که بتواند آن را بررسی کند" به "بررسی شد، اینجا پاسخ است" میرود — به هر یک از بیش از ۶۰ زبان، در یکشنبه ساعت ۳ صبح، در حالی که تیم پشتیبانی شما خواب است. مشتریانی که سبد، سفارش یا طرح را رها میکردند، درگیر میمانند زیرا پاسخ در حالی که هنوز میپرسند میرسد.
این تفاوت بین یک چتبات و یک دستیار است. و این تفاوتی است که مشتریان شما واقعاً احساس میکنند.
چگونه شروع کنیم
اگر قبلاً enuchat را راهاندازی کردهاید، اتصالات API در تنظیمات → اتصالات API زندگی میکنند. یک endpoint را انتخاب کنید که به سؤالی پاسخ میدهد که تیم شما صد بار در هفته تایپ میکند — وضعیت سفارش معمولاً مکانی با بالاترین اهرم برای شروع است. اتصال را پیکربندی کنید، endpoint را اضافه کنید، آن را به یک قانون متصل کنید، و یک بار قبل از فعال شدن آن را آزمایش کنید. برای راهنمای کامل به راهنمای اتصالات API مراجعه کنید.
اگر برای enuchat جدید هستید، در enuchat.com ثبتنام کنید. سطح رایگان از روز اول شامل اتصالات API است — کارت لازم نیست، هزینه به ازای گفتگو نیست، انقضای آزمایش نیست.
پنج دقیقه برای اتصال اولین endpoint خود. اولین پاسخ مفید معمولاً همان روز میرسد.