Skirtumas tarp žinoti ir pasitikrinti
Yra dvi klientų klausimų rūšys. Pirmoji yra bendro pobūdžio: Kokia jūsų grąžinimo politika? Kiek užtrunka pristatymas? Ar siunčiate į Vokietiją? Gerai sukomplektuota žinių bazė juos tvarko.
Antroji yra konkreti: Kur mano užsakymas #4521? Ar mėlyna versija dar yra sandėlyje? Kiek man liko plane šį mėnesį? Šie negyvena žinių bazėje. Jie gyvena jūsų sistemose — užsakymų valdyme, atsargose, sąskaitose — ir keičiasi kiekvieną sekundę.
Pokalbių robotas, kuris tvarko tik pirmąją rūšį, yra išpuošta DUK. Pokalbių robotas, kuris tvarko ir antrąją, yra asistentas. Skirtumas tarp jų — prieiga prie API.
Kodėl ši spraga kainuoja jums klientų
Dauguma šiandienos „AI pokalbių“ remiasi tik žinių baze. Jie gali perpasakoti jūsų pristatymo politiką septyniolika kalbų, bet negali pasakyti klientui, kur jo paketas iš tikrųjų yra dabar. Taigi klientas klausia, robotas išvengia, o klientas arba pasiduoda, arba laukia operatoriaus, kuris žiūri tuos pačius duomenis, kuriuos robotas galėjo gauti per milisekundes.
Tai yra pokalbių roboto lubos. Kiekvienas „leiskite man patikrinti“ — prarasta proga atsakyti per kelias sekundes, prie pat pirmosios žinutės, kol kliento ketinimas dar šiltas.
Ką iš tikrųjų daro API jungtys
enuchat platformoje API jungtis — sukonfigūruota grandis tarp pokalbio ir vienos iš jūsų backend paslaugų. Apibrėžiate ją kartą: bazinis URL, autentifikavimo būdas ir keletas endpointų su jų parametrais bei atsako sumapavimu.
Nuo to taško AI gali pokalbio metu kviesti tuos endpointus. Kai lankytojas klausia apie užsakymą, AI ištraukia užsakymo numerį, kviečia jūsų užsakymų endpointą, nuskaito gyvąjį statusą ir įveda jį į atsakymą. Lankytojas mato vieną sakinį: „Jūsų užsakymas #4521 buvo išsiųstas vakar ir turėtų atvykti ketvirtadienį.“ Už to sakinio įvyko tikras API kvietimas.
Klientas nemato vamzdyno. Jis tik mato, kad pokalbis iš tikrųjų žino.
Penki autentifikavimo būdai, be pritaikyto kodo
Dauguma API, kurias norėtumėte prijungti, jau naudoja standartinį autentifikavimą. enuchat palaiko penkis iš karto:
- Jokio — viešoms API, nereikalaujančioms autentifikavimo
- API Key — siunčiamas kaip antraštė ar užklausos parametras
- Bearer Token — paprastas tokenu pagrįstas autentifikavimas
- Basic Auth — pasenusioms sistemoms
- OAuth 2.0 client credentials — moderniems tiekėjams, kaip Salesforce, HubSpot ar jūsų paties OAuth serveriui
OAuth 2.0 atveju enuchat tokeno gyvavimo ciklą tvarko automatiškai — gauna per pirmą kvietimą, talpina iki pasibaigimo, atnaujina, kai reikia. Kredencialus sukonfigūruojate kartą ir pamirštate. Visi kredencialai šifruojami ramybės būsenoje su libsodium ir niekada nesirodo API atsakuose.
Kintamieji, šablonai ir atsako mapavimas
Endpointai apibrėžiami kaip šablonai. Kelias kaip /orders/{orderId} arba JSON kūnas, nurodantis {customerId}, interpoliuoja reikšmes iš seanso kintamųjų — kintamųjų, kuriuos AI ar statinė taisyklė gali nustatyti pokalbio metu.
Kai API atsako, JSON atsako laukus mapuojate atgal į seanso kintamuosius taško notacija. data.status tampa order_status. data.shipping.eta tampa delivery_eta. AI tada įveda šias reikšmes į natūralios kalbos atsakymą — lankytojo kalba.
Trys šablonai, padengiantys daugumą atvejų
Praktikoje dauguma API integracijų telpa į vieną iš trijų formų.
Pasitikrink ir atsakyk
Lankytojas užduoda klausimą, į kurį galima atsakyti vienu API kvietimu. Taisyklė paleidžia CALL_API, po to REPLY_AI. AI naudoja gautus duomenis, kad sukurtų kontekstualų, pagrįstą atsakymą. Užsakymo būsena, sąskaitos likutis, kambarių prieinamumas, dabartinės kainos, paketų sekimas — visa tai patenka čia.
Pasitikrink ir nukreipk
API kvietimas grąžina pakankamai informacijos, kad būtų galima nuspręsti dėl kito žingsnio. Premium paskyra eskaluojama vyresniajam agentui. Pasibaigusi prenumerata nukreipiama į apskaitą. AI naudoja CALL_API, po to ASSIGN_TO_OPERATOR, kad priimtų maršruto sprendimus pagal realius kliento duomenis, o ne spėjimus.
Daugiapakopiai srautai
Pirmoji žinutė pažymi pokalbį per SET_VARIABLE, antroji paleidžia API kvietimą, kai užtenka konteksto, o trečioji sudaro atsakymą. Naudinga, kai reikia patvirtinti ketinimą prieš pinguojant backendą, arba kai duomenų užklausa priklauso nuo to, ką lankytojas pasakė prieš dvi žinutes.
Įmontuotas saugumas
Backendų prijungimas prie pokalbių valdiklio kai kurias komandas nervina — pelnytai. enuchat pagal nutylėjimą pateikia kelis apsaugos sluoksnius:
- SSRF apsauga blokuoja kvietimus į localhost, privačius IP ir vidinius hostname-ius
- 5 sekundžių laikas neleidžia lėtam API pakabinti pokalbio
- Tenant izoliacija reiškia nulinį duomenų nuotėkį tarp tenant-ų — jūsų endpointai matomi tik jūsų valdikliams
- Testavimo mygtukai nepriklausomai patikrina ir jungtį, ir kiekvieną endpointą prieš pajungiant juos prie taisyklių
- Šifruoti kredencialai niekada negrįžta į skydelį atvirojo teksto pavidalu
Kas keičiasi jūsų klientams
Pokalbis pereina iš „leiskite man rasti ką nors, kas tai patikrins“ į „patikrinta, štai atsakymas“ — bet kuria iš 60+ kalbų, sekmadienį 3 valandą nakties, kol jūsų pagalbos komanda miega. Klientai, kurie kitaip būtų palikę krepšelį, užsakymą ar planą, lieka, nes atsakymas atkeliauja, kol jie dar klausia.
Tai yra skirtumas tarp pokalbių roboto ir asistento. Ir tai yra skirtumas, kurį jūsų klientai iš tiesų pajunta.
Kaip pradėti
Jei enuchat jau sukonfigūruotas, API jungtys yra Nustatymai → API jungtys. Pasirinkite vieną endpointą, atsakantį į klausimą, kurį jūsų komanda spausdina šimtą kartų per savaitę — užsakymo būsena dažniausiai yra didžiausią svertą duodantis startas. Sukonfigūruokite jungtį, pridėkite endpointą, pajunkite jį prie taisyklės ir vieną kartą išbandykite prieš leisdami į gamybą. Pilnam apžvelgimui pažiūrėkite API jungčių vadovą.
Jei esate naujas enuchat-e, registruokitės adresu enuchat.com. Nemokamame plane API jungtys įtrauktos nuo pirmos dienos — be kortelės, be mokesčių už pokalbį, be bandomojo laikotarpio pabaigos.
Penkios minutės, kad prijungtumėte pirmąjį endpointą. Pirmas naudingas atsakymas paprastai ateina tą pačią dieną.