Разликата меѓу знаење и пребарување
Постојат два вида прашања на клиенти. Првиот вид е општ: Каква е вашата политика за враќање? Колку трае испораката? Дали испраќате во Германија? Добро снабдена база на знаење ги решава овие.
Вториот вид е специфичен: Каде е мојата нарачка #4521? Дали сината верзија е сè уште на залиха? Што ми остана од планот овој месец? Овие не живеат во база на знаење. Тие живеат во вашите системи — вашето управување со нарачки, вашиот инвентар, вашата фактура — и се менуваат секоја секунда.
Чет-бот што може да се справи само со првиот вид е прославена ЧПП. Чет-бот што исто така може да се справи со вториот вид е асистент. Разликата меѓу двете е API пристапот.
Зошто јазот ве кошта клиенти
Поголемиот дел од "AI разговорот" денес е изграден само на база на знаење. Може да ја парафразира вашата политика за испорака на седумнаесет јазици, но не може да му каже на клиент каде е неговиот вистински пакет токму сега. Така клиентот прашува, ботот избегнува, а клиентот или се откажува или чека оператор да побара податоци што ботот можеше да ги добие за милисекунди.
Тоа е таванот на чет-ботот. Секое "дозволете да го проверам тоа за вас" е пропуштена шанса да одговорите за неколку секунди, на првата порака, додека намерата на клиентот е сè уште жешка.
Што всушност прават API конекциите
Во enuchat, API конекција е конфигурирана врска меѓу разговорот и една од вашите backend услуги. Ја дефинирате еднаш: основна URL, метод за автентикација и неколку endpoint-и со нивните параметри и како да го мапирате одговорот.
Од тој момент, AI може да ги повикува тие endpoint-и за време на разговор. Кога посетителот прашува за нарачка, AI го извлекува бројот на нарачката, го повикува вашиот endpoint за нарачка, го чита статусот во живо и го впишува во одговорот. Посетителот гледа една реченица: "Вашата нарачка #4521 е испратена вчера и се очекува да пристигне во четврток." Зад таа реченица, се случи вистински 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} интерполира вредности од променливи на сесијата — променливи што AI или статично правило може да ги постават за време на разговор.
Кога API одговара, мапирате полиња од JSON одговорот назад во променливи на сесијата користејќи нотација со точка. 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 повикот штом постои доволно контекст, а третата го составува одговорот. Корисно кога треба да ја потврдите намерата пред пингирање на вашиот backend, или кога пребарувањето на податоци зависи од нешто што посетителот го кажал пред две пораки.
Вградена безбедност
Поврзувањето на backend со виџет за разговор ги нервира некои тимови, и треба. enuchat испорачува неколку слоеви на заштита по дифолт:
- SSRF превенција блокира повици до localhost, приватни IP и само внатрешни имиња на хостови
- Истек од 5 секунди запира бавен API од виснење на разговорот
- Опсег на тенант значи без протекување на податоци меѓу тенанти — вашите endpoint-и се видливи само за вашите сопствени виџети
- Тест копчиња ја верификуваат и врската и секој endpoint независно пред да ги поврзете во правила
- Шифрираните акредитиви никогаш не се враќаат во контролната табла во чиста форма
Што се менува за вашите клиенти
Разговорот се движи од "дозволете да најдам некој кој може да го провери тоа" до "проверено, еве го одговорот" — на кој било од 60+ јазици, во недела во 3 наутро, додека вашиот тим за поддршка спие. Клиентите што би ја напуштиле кошничката, нарачката или планот остануваат ангажирани затоа што одговорот пристигнува додека сè уште прашуваат.
Тоа е разликата меѓу чет-бот и асистент. И тоа е разликата што вашите клиенти всушност ја чувствуваат.
Како да започнете
Ако веќе имате поставен enuchat, API конекциите живеат под Поставки → API конекции. Изберете еден endpoint што одговара на прашање што вашиот тим го пишува сто пати неделно — статусот на нарачка обично е местото со највисок лост за започнување. Конфигурирајте ја врската, додајте го endpoint-от, поврзете го со правило и тестирајте го еднаш пред живо. Видете го водичот за API конекции за целосниот премин.
Ако сте нови во enuchat, регистрирајте се на enuchat.com. Бесплатниот ниво вклучува API конекции од првиот ден — без потреба од картичка, без такси по разговор, без истекување на пробен период.
Пет минути за приклучување на вашиот прв endpoint. Првиот корисен одговор обично пристигнува истиот ден.