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

Демо-ссылки

Демо-ссылка — временный адрес, который открывает разговор с одним из ваших агентов прямо в браузере получателя. Он переходит по ссылке и говорит. Ни учётной записи, ни API-ключа, ни настройки на его стороне — поэтому это самый быстрый способ показать агента потенциальному клиенту, коллеге или заказчику.

Как создать ссылку

В списке агентов откройте меню ⋯ в строке агента и выберите «Поделиться демо…» — или в редакторе агента выберите «Поделиться» в меню ⋯ на панели. У агентов в архиве пункта «Поделиться демо…» нет. Откроется окно «Поделиться демо агента …» с именем агента в заголовке. Оно спросит две вещи:
  • Ссылка живёт — 1 час, 24 часа, 7 дней (по умолчанию) или 30 дней.
  • Сколько звонков разрешить — сколько всего разговоров можно начать по ссылке. Если оставить поле пустым, ссылка получит 25 звонков; значение больше 200 урезается до 200.
Нажмите «Создать ссылку» — новая ссылка появится в списке ниже. Переменные агента в этом окне не задаются. Если агент их объявляет, получатель увидит на странице демо форму с их значениями по умолчанию из опубликованной версии агента и сможет вписать свои — например, своё имя или сумму, — чтобы демо говорило о нём, а не отрабатывало общий сценарий.
Поделиться можно только опубликованным агентом. Ссылка на неопубликованного агента не сможет позвонить, поэтому платформа откажется её создавать. Сначала опубликуйте агента, затем создайте ссылку.
Если у опубликованной версии агента есть находки контракта провайдера, ссылка всё равно создаётся, а окно перечисляет эти находки — так вы сразу узнаете, что демо может начаться с ограничениями или не начаться вовсе.

Какую версию агента получает звонок

Каждый звонок по ссылке идёт на текущую опубликованную версию агента. Опубликовали новую версию — следующий звонок по уже выданной ссылке пойдёт на неё. Ссылка привязана к имени агента и не переходит на новое имя. Если агента переименовать, снять с публикации или удалить, страница демо покажет «Демо временно недоступно». Другого агента ссылка при этом не открывает.

Что видит получатель

Страница открывается с именем агента, формой «Данные для звонка» и двумя кнопками:
  • «Начать звонок» — голосовой разговор; браузер запросит доступ к микрофону.
  • «Чат без звука» — тот же разговор текстом, без микрофона. Эта кнопка доступна всегда, в том числе когда микрофона нет или доступ к нему запрещён.
Страница демо-ссылки: имя агента, форма данных звонка, кнопки «Начать звонок» и «Чат без звука» Поля формы подписаны именами переменных агента. Если агент не объявляет переменных, вместо полей написано «Агент не объявил переменных — просто начните разговор». Во время разговора можно писать агенту текстом в поле внизу, а закончить разговор — кнопкой «Завершить». Переменные фильтруются по опубликованной версии агента: принимаются только те имена, которые агент действительно объявляет, всё остальное со страницы отбрасывается. Браузер может заполнить контракт, но не расширить его. Когда ссылка перестала работать — истекла, отозвана или все её звонки израсходованы, — страница показывает «Эта демо-ссылка больше не активна» и «Попросите новую ссылку у того, кто поделился». Так же выглядит и несуществующая ссылка. Причину видите только вы, в окне «Поделиться демо».

Ограничения, которые держат ссылку в рамках

Демо-ссылка — это предъявляемый секрет, отданный человеку вне вашей организации, поэтому радиус утечки ограничен намеренно:
  • Одна ссылка — один агент. Ни до чего другого в вашей организации она не дотянется.
  • Потолок звонков и срок жизни, оба атомарные: при одновременном использовании ссылка не перескочит свой потолок.
  • Каждый старт расходует один звонок — и «Начать звонок», и «Чат без звука», даже если соединение потом не удалось. Израсходованный звонок не возвращается.
  • Один разговор одновременно. Пока идёт звонок, ссылка занята, и следующий посетитель видит «Сейчас идёт другой разговор. Попробуйте через минуту.» Тот же ответ приходит, когда у организации исчерпан лимит одновременных звонков. Такой отказ звонок не расходует.
  • Отзыв в любой момент. Отзыв срабатывает сразу и необратим: тот, у кого ссылка на руках, больше не сможет позвонить.
Относитесь к самой ссылке как к учётным данным. Окно «Поделиться демо» умеет показать тот же адрес повторно — это сделано специально, чтобы можно было переслать уже выданную ссылку, — и это же означает, что любой, кто открывает это окно, читает живую ссылку. По той же причине окно «Поделиться демо» и демо-ссылки закрыты ролям менеджер и участник, включая чтение. См. Роли и доступ.

Ссылки на этого агента

Под формой окна «Поделиться демо» — список «Ссылки на этого агента». У каждой ссылки показаны адрес, состояние (активна, истекла, отозвана или звонки исчерпаны), счётчик «Звонки: N / M» и срок действия.
  • Скопировать можно только активную ссылку.
  • «Отозвать» сначала спрашивает подтверждение.
  • Истёкшие и отозванные ссылки остаются в списке — по нему видно всё, чем вы делились.
Состояние в списке описывает саму ссылку, а не агента: если агента сняли с публикации, ссылка в списке остаётся активной, хотя страница демо показывает «Демо временно недоступно». Окно «Поделиться демо»: срок жизни ссылки, сколько звонков разрешить и список выданных ссылок с их состояниями

Демо-звонки в истории

Разговор по демо-ссылке попадает в Историю как обычный звонок — и находится там фильтром «Все каналы» → «Web-звонок». Демо идёт из браузера получателя, поэтому платформа записывает его каналом web, а не phone.
Канал web — это не только демо. В него же попадают разговоры из виджета на вашем сайте и из вашего кода на браузерном SDK: всё, что идёт из браузера, а не по телефонной линии. Если вы пользуетесь и тем и другим, фильтр канала сузит список до браузерных звонков, но демо от виджета не отделит — тут поможет фильтр по агенту, раз демо-ссылка всегда выдана на одного агента.
Во всём остальном это обычные звонки: транскрипт, аналитика, запись и отчёты работают как всегда — неудачное демо можно разобрать так же, как любой другой разговор.

Как встроить разговор в свой сайт

Демо-ссылка — это готовая страница. Если тот же разговор нужен внутри вашего продукта, используйте браузерный SDK, опубликованный как @hubtalk-ai/web-sdk — тонкую обёртку над эндпоинтом веб-звонка из Web API, с готовым виджетом. Как подключить — «Звонок с сайта».