/dashboard/web-widgets) створює та керує
публічними ключами, які забезпечують роботу вбудовуваного голосового віджета ThunderPhone.
Усе, що версія цього посібника для API
робить за допомогою cURL, ця сторінка робить через форму — а також генерує
для вас код для вбудовування.
Створіть віджет
1
Натисніть «Новий віджет» і виберіть режим
- Режим агента — віджет завжди запускає одного агента, якого ви вибираєте зі спадного списку. Найпростіше налаштування.
- Режим вебхука — під час кожного сеансу віджета ThunderPhone надсилає запит на URL вашого вебхука, а ваш сервер повертає конфігурацію агента для цього відвідувача (маршрутизація для окремих сторінок, авторизовані користувачі, розгортання). Залиште URL порожнім, щоб використовувати вебхук за замовчуванням для вашої організації; коли ви вводите новий URL, ви також можете встановити його як стандартний для організації.
2
Укажіть дозволені домени
Публічні ключі прив’язані до origin: потрібно вказати щонайменше один домен,
а віджет працює лише на перелічених вами іменах хостів. Дозволені
шаблони піддоменів, як-от
*.example.com (вони відповідають піддоменам,
але не основному домену); шаблони без домену, як-от *, відхиляються.
localhost і 127.0.0.1 завжди дозволені, тому локальна розробка
працює без їх додавання до списку.3
Укажіть назву, увімкніть і створіть
Перемикач Увімкнути віджет визначає, чи приймає ключ
сеанси — ви можете створити вимкнений віджет і увімкнути його під час запуску.
Отримайте код для вбудовування
Одразу після створення (або через кнопку Вбудувати у кожному рядку) діалогове вікно вбудовування генерує готовий до вставлення код із заповненим вашим публічним ключем:- React — фрагмент
<ThunderPhoneWidget />для застосунків зі збирачем. - Тег script — пара CDN
<script>+ таблиця стилів для будь-якого сайту.
Публічні ключі (
pk_live_…) за задумом є публічними — їх безпечно додавати
до фронтенд-коду. У будь-який час скопіюйте ключ кнопкою копіювання у його рядку.Керуйте віджетами зі списку
Кожен рядок редагується на місці:- Режим / Агент — перемикайтеся між режимом агента та вебхука або змінюйте агента за допомогою вбудованих списків вибору.
- Домени — додавайте або видаляйте дозволені домени як мітки.
- Увімкнути/вимкнути — перемикач для кожного віджета; вимкнені віджети негайно припиняють приймати сеанси.
- Передати до організації — скопіюйте або перемістіть віджет до іншої організації, до якої ви належите (після переміщення його буде видалено звідси).
- Видалити — відкликає публічний ключ; віджет негайно припиняє працювати на всіх доменах. Цю дію не можна скасувати.
Наступні кроки
Довідник SDK віджета
Компонент React, безголовий хук і відомості про CDN-скрипт.
Маршрутизація в режимі вебхука
Повертайте конфігурацію агента для кожного відвідувача зі свого сервера.