Різниця між «знати» і «подивитися»
Існує два типи клієнтських запитань. Перший тип — загальний: Яка у вас політика повернення? Скільки триває доставка? Доставляєте до Німеччини? Добре наповнена база знань із цим впорається.
Другий тип — конкретний: Де моє замовлення #4521? Чи є ще синя версія в наявності? Скільки в мене залишилось у тарифі цього місяця? Ці відповіді не живуть у базі знань. Вони живуть у ваших системах — управлінні замовленнями, складі, білінгу — і змінюються щосекунди.
Чат-бот, який тягне лише перший тип, — це причепурене FAQ. Чат-бот, який тягне і другий, — це асистент. Різниця між ними — доступ до API.
Чому цей розрив коштує вам клієнтів
Більшість сьогоднішніх «AI-чатів» побудовані лише на базі знань. Вони вміють переказати вашу політику доставки сімнадцятьма мовами, але не скажуть клієнту, де його посилка зараз. Тож клієнт запитує, бот ухиляється, і клієнт або здається, або чекає оператора, який подивиться ті самі дані, які бот міг отримати за мілісекунди.
Це стеля чат-бота. Кожне «зараз перевірю» — втрачена нагода відповісти за секунди, у першому повідомленні, поки намір клієнта ще гарячий.
Що насправді роблять API-підключення
В enuchat API-підключення — це налаштований міст між чатом і одним із ваших backend-сервісів. Ви визначаєте його один раз: базовий URL, метод автентифікації та кілька endpoint-ів з параметрами і тим, як мапиться відповідь.
Відтоді AI може викликати ці endpoint-и під час розмови. Коли відвідувач питає про замовлення, AI дістає номер замовлення, викликає ваш endpoint замовлень, читає живий статус і вплітає його у відповідь. Відвідувач бачить одне речення: «Ваше замовлення #4521 було відправлено вчора і має прибути в четвер.» За цим реченням стоїть справжній API-виклик.
Клієнт не бачить трубопроводу. Він бачить лише, що чат справді знає.
П’ять методів автентифікації, без власного коду
Більшість API, які ви хотіли б підключити, уже використовують стандартну автентифікацію. enuchat підтримує п’ять одразу з коробки:
- Без автентифікації — для публічних 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 та внутрішніх hostname-ів
- Таймаут 5 секунд не дає повільному API підвісити розмову
- Ізоляція тенантів означає нульовий витік даних між тенантами — ваші endpoint-и видно лише вашим віджетам
- Кнопки тестування незалежно перевіряють і підключення, і кожен endpoint, перш ніж ви прив’язуєте їх до правил
- Шифровані облікові дані ніколи не повертаються в дашборд у відкритому вигляді
Що змінюється для ваших клієнтів
Чат переходить від «зараз знайду когось, хто це перевірить» до «перевірив, ось відповідь» — будь-якою з 60+ мов, у неділю о 3-й ночі, поки ваша підтримка спить. Клієнти, які інакше покинули б кошик, замовлення чи тариф, лишаються, бо відповідь приходить ще тоді, коли вони запитують.
Це і є різниця між чат-ботом і асистентом. І це різниця, яку ваші клієнти справді відчувають.
З чого почати
Якщо enuchat у вас уже налаштований, API-підключення знаходяться в Налаштування → API-підключення. Виберіть один endpoint, який відповідає на запитання, що ваша команда друкує сто разів на тиждень — статус замовлення зазвичай дає найбільший важіль. Налаштуйте підключення, додайте endpoint, прив’яжіть його до правила і протестуйте один раз перед запуском у прод. Повний прохід — у довіднику з API-підключень.
Якщо ви новачок в enuchat, зареєструйтеся на enuchat.com. Безкоштовний тариф включає API-підключення з першого дня — без картки, без оплати за розмову, без закінчення пробного періоду.
П’ять хвилин, щоб підключити перший endpoint. Перша корисна відповідь зазвичай приходить того ж дня.