Маршрутизация обращений

Маршрутизация позволяет направлять обращения из одного виджета в разные каналы.

Используйте маршрутизацию, если на сайте:

• несколько языков;
• разные типы пользователей;
• несколько брендов;
• отдельные команды поддержки или продаж.

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

1. На сайт устанавливается виджет основного канала.
2. Для разных сценариев создаются дополнительные каналы.
3. Каждому каналу назначается код маршрутизации.
4. Сайт передает код маршрутизации при запуске виджета через vivo_api.setRegion().
5. VivoChat направляет обращения в соответствующий канал.

Если код маршрутизации не передан или не найден, обращения попадут в основной канал.

Настройка маршрутизации

1. Создайте основной канал

Пример:

• mysite Этот канал будет использоваться как родительский. На сайте устанавливается только его Widget ID. Как получить Widget ID, описано в разделе «Установка виджета».

2. Создайте дополнительные каналы

Создайте отдельные каналы для маршрутизации обращений.

Например:

• mysite-en
• mysite-es
• mysite-de

3. Откройте настройки маршрутизации

Перейдите в раздел: Управление → Каналы связи → [основной канал] → Регионы

4. Добавьте каналы и укажите коды маршрутизации

Для каждого канала:

• выберите канал;
• укажите код маршрутизации.

Например:

Код	Канал
en	mysite-en
es	mysite-es
de	mysite-de

5. Передайте код маршрутизации в виджет

Перед вызовом run() укажите код маршрутизации через setRegion().

Пример:

<script defer>
  (() => {
    const script = document.createElement("script");

    script.async = true;
    script.src = "//widget.vivochat.ai/script/widget/YOUR_WIDGET_ID"; // Replace with your Widget ID

    script.onload = () => {
      vivo_api.setRegion("en"); // Replace "en" with your routing code
      vivo_api.run({ withIcon: true });
    };

    document.head.appendChild(script);
  })();
</script>

В этом примере обращения будут направляться в канал, которому назначен код en.

Коды маршрутизации

Код маршрутизации задается вручную при настройке канала.

Можно использовать любые значения:

• en
• es
• de
• partner
• vip
• mobile

Главное условие

Значение в setRegion() должно полностью совпадать с кодом, указанным в настройках маршрутизации.

Важно

• setRegion() должен вызываться до run().
• Widget ID остается общим для всех каналов маршрутизации.
• Для дополнительных каналов не нужно устанавливать отдельные виджеты.
• Если сайт меняет язык или режим без перезагрузки страницы, повторно вызовите setRegion() и run().
• Поиск активного чата выполняется сразу по всем каналам маршрутизации. Дубликаты чатов не создаются.