Using the dashboard

Создайте веб-виджет в панели управления

Настройте виджет click-to-talk для своего сайта на странице «Веб-виджеты» — вызовы API не требуются.

Страница Веб-виджеты (/dashboard/web-widgets) создаёт и управляет публикуемыми ключами, которые обеспечивают работу встраиваемого голосового виджета ThunderPhone. Всё, что API-версия этого руководства делает с помощью cURL, эта страница делает через форму — и дополнительно генерирует код для встраивания.

Создайте виджет#

1. Нажмите «Новый виджет» и выберите режим
   • Режим агента — виджет всегда запускает одного агента, выбранного в выпадающем списке. Самая простая настройка.
   • Режим вебхука — в каждом сеансе виджета ThunderPhone вызывает URL вашего вебхука, а сервер возвращает конфигурацию агента для этого посетителя (маршрутизация по страницам, авторизованные пользователи, развёртывания). Оставьте URL пустым, чтобы использовать вебхук вашей организации по умолчанию; при вводе нового URL его также можно назначить вебхуком организации по умолчанию.
2. Укажите разрешённые домены

   Публикуемые ключи привязаны к источникам: требуется хотя бы один домен, и виджет работает только на перечисленных вами именах хостов. Допускаются подстановочные знаки поддоменов, например *.example.com (они соответствуют поддоменам, но не основному домену); подстановочные знаки без домена, например *, отклоняются. localhost и 127.0.0.1 всегда разрешены, поэтому локальная разработка работает без их добавления в список.

3. Задайте имя, включите и создайте

   Переключатель Включить виджет определяет, принимает ли ключ сеансы — вы можете создать отключённый виджет и включить его при запуске.

Получите код для встраивания#

Сразу после создания (или через кнопку Встроить в каждой строке) диалог встраивания генерирует готовый для вставки код с уже указанным публикуемым ключом:

• React — фрагмент <ThunderPhoneWidget /> для приложений со сборщиком.
• Тег script — пара CDN <script> + таблица стилей для любого сайта.

В диалоге также отображается предварительный просмотр основных параметров оформления — заголовка, основного цвета, положения в углу и светлой/тёмной темы — и ваши настройки добавляются в фрагмент. Полное описание свойств, хуков стилизации и варианта без интерфейса смотрите в документации SDK виджета.

Управляйте виджетами из списка#

Каждая строка редактируется на месте:

• Режим / Агент — переключайтесь между режимами агента и вебхука или меняйте агента с помощью встроенных списков выбора.
• Домены — добавляйте или удаляйте разрешённые домены в виде меток.
• Включение/отключение — переключатель для каждого виджета; отключённые виджеты немедленно перестают принимать сеансы.
• Передать организации — скопируйте или переместите виджет в другую организацию, участником которой вы являетесь (при перемещении он удаляется отсюда).
• Удалить — отзывает публикуемый ключ; виджет немедленно перестаёт работать на всех доменах. Это действие нельзя отменить.

Сеансы виджета отображаются в истории звонков с теми же расшифровками, записями и оценками, что и телефонные звонки.

Следующие шаги#