Консоль
Руководства

Подключить виджет на сайт

Как создать канал widget и встроить чат Айвы на сайт

Website widget это самый быстрый способ запустить текстового агента на сайте без отдельной backend-интеграции.

1. Подготовьте агента

Создайте или выберите текстового агента, который будет отвечать в виджете.

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

Откройте раздел Каналы и создайте канал типа Виджет на сайт.

Укажите:

  • название канала;
  • команду;
  • агента, который должен отвечать.

3. Откройте карточку канала

В карточке widget-канала вы получите:

  • Widget ID;
  • список разрешенных доменов;
  • готовый embed code.

Если хотите ограничить использование виджета только своими сайтами, заполните allowlist доменов.

Минимальный пример

<script>
(function(w,d,s,u,i){var o=w[i]||{},q=o._q||[];o._q=q;o.l=+new Date();function stub(m){return function(){var a=arguments;return new Promise(function(r,j){q.push({method:m,args:[].slice.call(a),resolve:r,reject:j})})}}o.connect=o.connect||stub("connect");o.render=o.render||stub("render");w[i]=o;var e=d.createElement(s),a=d.getElementsByTagName(s)[0];e.async=1;e.src=u;if(a)a.parentNode.insertBefore(e,a);else d.head.appendChild(e)})(window,document,"script","https://widget.aiva.chat/loader.js","AivaWidget");
</script>
<script>
AivaWidget.render("<UUID_WIDGET>");
</script>

Вместо <UUID_WIDGET> используйте Widget ID из карточки канала.

Inline-режим

Если виджет нужно встроить в конкретный контейнер на странице, передайте containerId:

<div id="support-chat" style="height: 520px;"></div>

<script>
(function(w,d,s,u,i){var o=w[i]||{},q=o._q||[];o._q=q;o.l=+new Date();function stub(m){return function(){var a=arguments;return new Promise(function(r,j){q.push({method:m,args:[].slice.call(a),resolve:r,reject:j})})}}o.connect=o.connect||stub("connect");o.render=o.render||stub("render");w[i]=o;var e=d.createElement(s),a=d.getElementsByTagName(s)[0];e.async=1;e.src=u;if(a)a.parentNode.insertBefore(e,a);else d.head.appendChild(e)})(window,document,"script","https://widget.aiva.chat/loader.js","AivaWidget");
</script>
<script>
AivaWidget.render("<UUID_WIDGET>", { containerId: "support-chat" });
</script>

Что проверить после публикации

  • виджет открывается на разрешенном домене;
  • сообщения попадают именно в нужного агента;
  • ответы видны в интерфейсе;
  • канал и диалоги появляются в консоли.

Если нужен не готовый UI, а программное управление, можно использовать headless API виджета через метод connect, но для первого запуска обычно достаточно render.