Skip to main content

​
Звонок из вашей системы: публичный API

Цель модуля: запустить звонок программно, когда поводом служит событие в CRM, а не список.
Раздел «API-ключи» с ключом и памяткой по эндпоинтам /v1

/apikeys — ключ создаётся один раз и секрет показывается только при создании. Рядом — памятка по эндпоинтам, заголовкам и лимиту.

Публичный API — это когда звонок инициирует ваша система: клиент оставил заявку на сайте, в CRM сменился статус, приехал заказ. Ключевые эндпоинты: Ключ передаётся в Authorization: Bearer …, у каждого ключа свой лимит запросов в минуту (превышение — 429). Заголовок Idempotency-Key защищает от дублей при ретраях: повтор с тем же ключом не создаст второй звонок — обязательная практика, если запрос отправляет очередь с автоповтором. Переменные звонка передаются в теле запроса — это те же {{var}}, что вы используете в узлах. Итоги приходят вебхуками из модуля 16, отдельно опрашивать статус не нужно.
Звонок с сайта: виджет из примераДля web-звонка есть SDK и страница-пример к нему — это уже не «голая» проводка, а демо-сайт с плавающим виджетом: лаунчер в углу, панель с состоянием агента и таймером, сворачивание, которое звонок не прерывает. Обе темы берутся по системной настройке, внешних сетевых зависимостей нет.Важная граница: сам SDK не несёт ни одного пикселя вёрстки — стили живут в примере отдельным файлом, и интегратор копирует их к себе, а не получает пакетом. Токены оформления объявлены на классе виджета, а не глобально, поэтому подключение файла не перекрашивает страницу интегратора.Пакет опубликован в npm под именем @hubtalk-ai/web-sdk.
Показать агента, ничего не интегрируяЕсли задача не «встроить в продукт», а «дать человеку поговорить с агентом сегодня», API не нужен вовсе: у опубликованного агента есть кнопка Share, которая выдаёт демо-ссылку со сроком жизни и потолком звонков. Получатель открывает её в браузере и говорит — без учётной записи и без ключа. Это третий вид предъявляемого секрета, поэтому обращайтесь с самой ссылкой как с учётными данными.
Грабли: секрет виден один разПосле закрытия окна создания секрет не показывается больше нигде — только префикс. Потеряли — отзывайте ключ и создавайте новый. И не кладите ключ в фронтенд: для браузера есть web-звонок с одноразовым токеном.