Перейти к основному содержанию

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

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

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

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