Справочный центр | Как сделать так, чтобы виджет появлялся после триггера

Как сделать так, чтобы виджет появлялся после триггера

Инструкции ниже предназначены только для ПК и ноутбуков.

Используя API tawk.to, вы можете скрыть чат-виджет при загрузке страницы и показывать его только после срабатывания триггера (например, когда на странице происходит определённое событие).

Это удобно, если вы хотите, чтобы виджет появлялся:

только после действия посетителя, или
после отправки сайтом специального триггерного сообщения.

Описанный ниже метод сочетает:

вызов onBeforeLoad вместе с hideWidget() - чтобы виджет был скрыт при загрузке,
колбэк onChatMessageSystem с вызовом showWidget() - чтобы показать виджет при наступлении триггера.

Получение кода виджета

Для мобильных устройств см. эти руководства:

1. Войдите в аккаунт tawk.to.

2. Выберите нужный Проект (Property).

3. В левом меню навигации нажмите Администрирование.

4. В левом подменю выберите Виджет чата.

5. Скопируйте Код виджета и вставьте его в HTML сайта перед закрывающим тегом </body>.

Добавление API-кода в скрипт виджета

Добавьте соответствующий фрагмент API-кода внутрь уже вставленного скрипта виджета - перед закрывающим тегом </script>.

Этот код:

скрывает виджет при загрузке страницы
отображает его, когда в чат поступает системное сообщение (триггер).

Как это работает

onBeforeLoad выполняется до полной инициализации виджета.
Вызов hideWidget() делает интерфейс невидимым для посетителей.

onChatMessageSystem срабатывает, когда виджет получает системное сообщение (ваш триггер).
Вызов showWidget() делает виджет видимым для посетителя.

Настройка поведения триггера (опционально)

Если вы хотите показывать виджет только для определённых системных сообщений, вы можете проверить параметр сообщения внутри onChatMessageSystem и вызывать showWidget() только при совпадении с нужными условиями.

Также вы можете использовать другие API-хуки, например:

onChatMessageVisitor

onChatMessageAgent

Выберите тот колбэк, который лучше всего соответствует событию, которое вы считаете триггером.

Полный список возможностей см. в документации:
JavaScript API

Дополнительные моменты

Правильное размещение кодаУбедитесь, что код добавлен внутрь существующего скрипта виджета tawk.to - до </script> и перед </body>.
Это необходимо, чтобы API-методы были доступны во время загрузки виджета.

autoStart и start()Если вы предпочитаете управлять подключением сокета, а не просто скрывать интерфейс, API поддерживает параметры autoStart и start(), которые определяют, когда виджет подключается и может отображаться.
Если autoStart отключён, виджет по умолчанию будет скрыт при загрузке страницы.

Тестирование

Протестируйте поведение виджета:

в разных браузерах,
на разных устройствах.

При тестировании изменений рекомендуется очищать кэш или использовать режим инкогнито.

Согласие и конфиденциальность

Если ваш сайт требует согласия пользователя перед загрузкой сторонних скриптов (например, для соответствия GDPR), убедитесь, что:

виджет не инициализируется
и не отображается до получения согласия, если это необходимо.

Связанные руководства

JavaScript API (полная документация)

Где я могу найти идентификаторы проектов и виджетов?

Где найти код виджета для iOS

Где найти код виджета для Android

Есть отзывы по этой статье или нужна помощь?

Нажмите на зелёный значок чата
Запланируйте звонок с нами
Посетите наше сообщество

Эта статья была вам полезна?

53 из 69 понравилась эта статья