API ИИ-консультанта: как встроить бота в своё приложение
Через API бот встраивается в своё приложение, CRM или сайт с собственным интерфейсом. Отвечает он так же, как в остальных каналах: по вашей базе знаний и вашим правилам.
Что нужно
- Ключ API - выдаётся в разделе «Настройки бота», вкладка «Для разработчиков». Передаётся заголовком
X-Api-Key. - Адрес -
https://api.cyberai.help.
Ключ не привязан к домену и работает откуда угодно - поэтому его нельзя класть в код страницы, которую видит покупатель. Держите его на своём сервере.
Что дальше в этом разделе
- Авторизация - два ключа, чем они отличаются и что защищает от чужого использования.
- POST /chat - единственный эндпоинт, через который бот отвечает.
- Формат ответа (SSE) - как разобрать поток и откуда взять цену ответа.
- Ошибки - что означает каждая.
- Примеры кода - curl, JavaScript, Python.
- GET /widget/config - оформление бота, если интерфейс чата вы рисуете сами.
- Виджет на сайт (без кода) - готовый плавающий чат одной строкой.
- Материалы на своём сервере, инструкция для администратора и разбор отказов проверки - режим, в котором база знаний остаётся у вас.
- Лимиты и биллинг - частота запросов и из чего складывается цена ответа.