Документация / Руководства

Разместите агента на своём сайте

Встройте на любой сайт плавающую кнопку с голосом и чатом одним фрагментом кода.

Последнее обновление:

Веб-виджет размещает вашего агента на вашем собственном сайте в виде плавающей кнопки. Посетители нажимают её и говорят с агентом или переписываются с ним прямо со страницы, без всякого номера телефона.

1. Включите его#

Откройте агента и перейдите в Web → Web widget. Нажмите Enable widget. Разумные значения по умолчанию уже подставлены. Выберите каналы (голос, чат или оба) и, если включены оба, какую вкладку посетители увидят первой.

2. Настройте его под себя#

  • Appearance: положение на странице, ваш фирменный цвет, размер и стиль кнопки, компоновка панели и то, открывается ли виджет автоматически.
  • Texts: заголовок, подписи кнопки и вкладок, подсказки в полях. Всё, что вы оставите пустым, берётся из продуманных встроенных значений по умолчанию.
  • Pre-conversation form (необязательно): спрашивайте у посетителей имя, email или телефон до начала разговора. У каждого поля есть ключ, подпись, тип и признак обязательности. То, что посетители заполнят, прикрепляется к разговору.
  • Automation webhook (необязательно, для разработчиков): https-URL, который получает уведомление (вместе с данными формы) в момент начала разговора, чтобы ваши системы узнали об этом сразу.

3. Скопируйте фрагмент кода#

Внизу той же страницы вы получаете код для встраивания в одну строку. Скопируйте его и вставьте в HTML вашего сайта прямо перед закрывающим тегом </body>. Вот и всё: кнопка появляется на каждой странице, где есть этот фрагмент.

4. Посмотрите его вживую#

Web → Preview показывает настоящий виджет на демонстрационной странице: это реальная живая сессия, где работают и голос, и чат, в ширине для компьютера или мобильного. Сохранённые изменения появляются там примерно за 30 секунд.

5. Следите за разговорами#

Каждая сессия виджета попадает в Calls, как любой телефонный звонок (расшифровка, сводка, уведомления), с источником Web вместо Phone.

Нажмите Save, затем Deploy: как и любое другое изменение агента, виджет отдаёт развёрнутую конфигурацию.

6. Поделиться тестовой ссылкой#

Чтобы кто-то попробовал агента, сайт не нужен. В панели предпросмотра агента нажмите Share, затем Create link: мы размещаем страницу с виджетом, а вы отправляете URL коллеге, клиенту или проверяющему. Задайте срок действия ссылки (от 24 часов до 30 дней или бессрочно) и сколько сессий она может начать (от 10 до 1000); отзовите её в любой момент в том же диалоге. Каждая сессия по ссылке расходует минуты этого проекта точно так же, как сессия с вашего сайта, а виджет должен быть уже включён.

Консоль

Эти страницы доступны только для чтения. Тестовый звонок, ключи API и актуальный справочник API находятся в консоли, где выполнен вход в ваш аккаунт.

Открыть консоль