"Мэдэх" болон "хайх" хоёрын ялгаа
Үйлчлүүлэгчийн асуултын хоёр төрөл байдаг. Эхний төрөл нь ерөнхий: Та нарын буцаах бодлого юу вэ? Хүргэлт хэр удаан явдаг вэ? Та нар Германд хүргэдэг үү? Сайн дүүргэсэн мэдлэгийн санд эдгээрийг шийдэх боломжтой.
Хоёр дахь төрөл нь тодорхой: Миний #4521 захиалга хаана байна вэ? Цэнхэр хувилбар нөөцөд байсаар байна уу? Энэ сар миний төлөвлөгөөнд хэр их үлдсэн вэ? Эдгээр нь мэдлэгийн санд амьдардаггүй. Эдгээр нь танай системд амьдардаг — захиалгын удирдлага, нөөц, төлбөр — мөн секунд тутамд өөрчлөгддөг.
Зөвхөн эхний төрлийг даах чатбот бол гоё хувцаслагдсан FAQ. Хоёр дахь төрлийг ч даах чатбот бол туслах юм. Тэдгээрийн хоорондын ялгаа нь API-д хандах эрх юм.
Энэ зай яагаад үйлчлүүлэгчээ алдахад хүргэдэг вэ
Өнөөгийн "AI чат"-ын ихэнх нь зөвхөн мэдлэгийн сан дээр баригдсан байдаг. Тэд таны хүргэлтийн бодлогыг арван долоон хэлээр өөрөөр хэлж чадна, гэхдээ үйлчлүүлэгчид түүний илгээмж яг одоо хаана байгааг хэлж чадахгүй. Тиймээс үйлчлүүлэгч асууж, бот зайлсхийж, үйлчлүүлэгч эсвэл бууж өгч, эсвэл оператор хүлээж, ботын миллисекундийн дотор авч чадах байсан тэр л өгөгдлийг харуулна.
Энэ бол чатботын тааз. "Танд шалгая" гэх бүхэн л үйлчлүүлэгчийн санаа хараахан халуун байхад, эхний мессеж дээр секундийн дотор хариулах боломжийг алдсан хэрэг.
API холболтууд яг юу хийдэг вэ
enuchat-д API холболт гэдэг нь чат болон таны бэкэнд үйлчилгээний нэгний хооронд тохируулагдсан холбоос юм. Та үүнийг нэг л удаа тодорхойлно: үндсэн URL, баталгаажуулалтын арга, болон параметртэй endpoint-ууд хэдэн ширхэг, хариуг хэрхэн зурах.
Тэр үеэс эхлэн AI ярианы үеэр тэдгээр endpoint-ыг дуудаж чадна. Зочин захиалгын талаар асуухад, AI захиалгын дугаарыг гаргаж, таны захиалгын endpoint-ыг дуудаж, шууд статусыг уншиж, түүнийг хариунд нэхэх. Зочин нэг өгүүлбэр харна: "Таны #4521 захиалгыг өчигдөр илгээсэн бөгөөд Пүрэв гарагт ирнэ гэж хүлээж байна." Тэр өгүүлбэрийн ард жинхэнэ API дуудлага явагдсан.
Үйлчлүүлэгч хоолой харахгүй. Тэр зүгээр л чат үнэхээр мэдэж байгааг харна.
Таван баталгаажуулалтын арга, тусгай код шаардахгүй
Та холбохыг хүсэх ихэнх API нь аль хэдийн стандарт баталгаажуулалт ашигладаг. enuchat хайрцгаас гарангуутаа таван аргыг дэмждэг:
- Байхгүй — баталгаажуулалт шаарддаггүй нийтийн API-д зориулсан
- API Key — header эсвэл query параметр болгож илгээдэг
- Bearer Token — энгийн token дээр суурилсан баталгаажуулалт
- Basic Auth — хуучирсан системд
- OAuth 2.0 client credentials — Salesforce, HubSpot гэх мэт орчин үеийн нийлүүлэгчид эсвэл өөрийн OAuth серверт
OAuth 2.0-д enuchat нь токений амьдралын мөчлөгийг автоматаар зохицуулдаг — анхны дуудлага дээр авч, дуусах хүртэл кэшэлж, шаардлагатай үед сэргээдэг. Та итгэмжлэлүүдийг нэг л удаа тохируулж дараа нь мартана. Бүх итгэмжлэл libsodium-аар амрах үед шифрлэгдэж, API хариунд хэзээ ч гарахгүй.
Хувьсагч, загвар, хариуны зураглал
Endpoint нь загвар хэлбэрээр тодорхойлогддог. /orders/{orderId} гэх мэт зам, эсвэл {customerId}-д хандсан JSON бие нь session хувьсагчуудаас утгуудыг оруулдаг — AI эсвэл статик дүрэм ярианы үеэр тохируулж чадах хувьсагчууд.
API хариулахдаа JSON хариунаас талбаруудыг session хувьсагчид цэгийн тэмдэглэгээгээр буцааж зурна. data.status нь order_status болно. data.shipping.eta нь delivery_eta болно. Дараа нь AI тэдгээр утгуудыг байгалийн хэлээр зохиосон хариунд нэхэдэг — зочны өөрийнх нь хэлээр.
Ихэнх хэрэглээний тохиолдлыг хамардаг гурван загвар
Бодит байдалд ихэнх API нэгдэл нь гурван хэлбэрийн нэгд багтдаг.
Хайж хариул
Зочин нэг API дуудлагаар хариулж болох асуулт асуудаг. Дүрэм нь CALL_API-г, дараа нь REPLY_AI-г галладаг. AI авсан өгөгдлөө ашиглан контекст, үндэслэл бүхий хариу зохиодог. Захиалгын төлөв, дансны үлдэгдэл, өрөөний боломж, одоогийн үнэ, илгээмжийн мөшгилт — эдгээр бүгд эндэхийн.
Хайж чиглүүл
API дуудлага нь дараагийн алхамыг шийдэхэд хангалттай мэдээллийг буцаадаг. Премиум данс ахмад агентад өсгөгдөнө. Дууссан захиалга төлбөр рүү чиглэгдэнэ. AI CALL_API-г, дараа нь ASSIGN_TO_OPERATOR-г ашиглан таамаглал биш, бодит үйлчлүүлэгчийн өгөгдөл дээр үндэслэн чиглүүлэлтийн шийдвэр гаргадаг.
Олон үе шаттай урсгал
Эхний мессеж нь SET_VARIABLE-аар яриаг таглаж, хоёр дахь нь хангалттай контекст байх үед API дуудлагыг өдөөж, гурав дахь нь хариуг зохиодог. Бэкэндэд ping хийхээс өмнө санааг баталгаажуулах шаардлагатай үед, эсвэл өгөгдлийн хайлт нь зочны хоёр мессежийн өмнө хэлсэн зүйлээс хамаардаг үед хэрэгтэй.
Суурилуулсан аюулгүй байдал
Бэкэндийг чатын виджеттэй холбох нь зарим багуудыг сандааруулдаг — тэр нь зөв юм. enuchat анхдагчаар хэд хэдэн хамгаалалтын давхаргыг өгдөг:
- SSRF-аас урьдчилан сэргийлэх нь localhost, хувийн IP, дотоод hostname руу хийх дуудлагыг блоклоно
- 5 секундын таймаут удаашралтай API-г яриаг өлгөн орхиход саад болно
- Tenant-ийн хязгаарлалт нь tenant хооронд өгөгдөл алдагдахгүй гэсэн үг — таны endpoint-ууд зөвхөн өөрийн виджетүүдэд харагдана
- Туршилтын товчлуурууд нь дүрэмд холбохоос өмнө холболт болон endpoint бүрийг бие даан баталгаажуулдаг
- Шифрлэгдсэн итгэмжлэл хэзээ ч хяналтын самбар руу нээлттэй текстээр буцаж очдоггүй
Танай үйлчлүүлэгчдэд юу өөрчлөгдөх вэ
Чат "үүнийг шалгаж чадах хүнийг хайя"-ас "шалгасан, хариу нь энд байна" руу шилжинэ — 60+ хэлний аль ч хэлээр, Ням гарагийн өглөөний 3 цагт, таны дэмжлэгийн баг унтаж байх үед. Сагсаа, захиалгаа, төлөвлөгөөгөө орхих байсан үйлчлүүлэгчид хариу тэдний асуухад нь ирж байгаа учир үлддэг.
Энэ бол чатбот болон туслах хоёрын ялгаа юм. Мөн энэ бол таны үйлчлүүлэгчид үнэхээр мэдэрдэг ялгаа юм.
Хэрхэн эхлэх
Хэрэв та аль хэдийн enuchat суулгасан бол API холболтууд Тохиргоо → API холболтууд-д байна. Танай баг долоо хоногт зуу удаа бичдэг асуултанд хариулдаг нэг endpoint-ыг сонго — захиалгын төлөв нь ихэвчлэн хамгийн өндөр үр өгөөжтэй эхлэх цэг юм. Холболтыг тохируулж, endpoint-ыг нэмж, дүрэмтэй холбож, шууд эфирт гарахаасаа өмнө нэг удаа турш. Бүтэн алхам алхамаар API холболтын гарын авлага-г үзнэ үү.
Хэрэв та enuchat-д шинэ бол enuchat.com-д бүртгүүл. Үнэгүй багц нь эхний өдрөөсөө API холболтыг агуулдаг — карт шаардлагагүй, ярианд хамаатай төлбөргүй, туршилтын дуусах хугацаагүй.
Анхны endpoint-оо залгахад таван минут. Анхны хэрэгтэй хариулт ихэвчлэн тэр өдөртөө ирдэг.