Один граф работает в разных каналах

Подключение

Канал передает сообщения клиента опубликованному графу. Один агент может иметь несколько подключенных каналов с общей логикой: Telegram, MAX, ВКонтакте, виджет сайта и дебаг-виджет.

Каналы агента · Нажмите, чтобы открыть в полном размере

Канал можно временно выключить без удаления агента и сценария.

Создайте бота через BotFather.
Скопируйте token и добавьте Telegram-канал в iisy.
Включите канал.
Напишите боту с личного аккаунта и пройдите основные ветки.

MAX

Создайте или откройте бота в MAX.
Скопируйте access token и добавьте MAX-канал в iisy.
Включите канал и дождитесь подключения webhook.
Напишите боту из MAX и проверьте основной сценарий.

MAX использует ту же рабочую версию графа, что и остальные боевые каналы. Поддерживаются текстовые сообщения, ответы графа, форматирование текста, вложения-изображения по ссылке и кнопки под сообщением.

Кнопки в поле ввода для MAX не отправляются. Если в сценарии есть только такие кнопки, канал продолжит работу через текстовый ввод или запасную ветку.

ВКонтакте

Создайте сообщество и включите сообщения сообщества.
Получите токен сообщества с доступом к сообщениям.
Добавьте ID сообщества и токен в канале «ВКонтакте» внутри iisy.
iisy автоматически создаст Callback API сервер и включит события сообщений и кнопок.

ВКонтакте использует опубликованную версию графа. Работают текст и форматирование, условия, память, внешние запросы, Agent-слоты, индикатор набора, изображения и таймерные ветки.

Изображения из слота «Вложение» загружаются как нативные фотографии. Пользователь может отправить изображение боту; при включенном анализе оно передается Agent-слоту.

Виджет сайта

После создания виджета укажите разрешенный домен и добавьте выданный код на сайт. Внешний вид настраивается отдельно от сценария: кнопка запуска, шапка, окно, поле ввода, форма углов, отступ снизу, иконка шапки, юридические ссылки и пользовательский CSS.

Виджет поддерживает кнопки, цвета кнопок, изображения из слота «Вложение» и загрузку одного изображения пользователем. История чата сохраняется в браузере, поэтому при переходе между страницами сайта диалог не должен начинаться заново.

Перед запуском проверьте реальный код на разрешённом домене. Если нужно проверить локальный магазин, добавьте локальный домен в настройки канала или используйте тестовый домен.

Дебаг-виджет

Дебаг-виджет создаётся вместе с агентом, отображается в разделе каналов и не удаляется. Он настраивается как обычный виджет, но доступен только для тестирования соответствующего агента.

Юридическое согласие в debug не показывается: дебаг-виджет предназначен для внутренней проверки, а не для публичного сбора обращений.

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

Кнопки в каналах

Настройка графа	Telegram	MAX	ВКонтакте	Виджет
Под сообщением	Inline-кнопки.	Кнопки под сообщением.	Callback-кнопки под сообщением.	Кнопки под сообщением.
В поле ввода	Reply-клавиатура.	Не отправляется в MAX.	Обычная клавиатура VK.	Панель рядом с полем ввода.
Показывать один раз	Скрывается после выбора.	Работает для кнопок под сообщением.	Клавиатура скрывается после выбора.	Скрывается после выбора.
Показывать постоянно	Живет до следующего меню.	Не применяется к кнопкам в поле ввода.	Живет до замены или удаления.	Живет до следующего меню.
Ссылка	Доступна для кнопок под сообщением.	Доступна для кнопок под сообщением.	Открывает ссылку из кнопки под сообщением.	Доступна для кнопок под сообщением.
Поделиться контактом	Только кнопка в поле ввода Telegram.	Не поддерживается.	Не поддерживается; кнопка скрывается.	Не поддерживается; остальные кнопки продолжают работать.
Цвет кнопки	Цвет зависит от Telegram-клиента и может игнорироваться.	Может игнорироваться каналом.	Применяются стандартные цвета VK.	Применяется в виджете.
Заменять текущее сообщение	Редактирует сообщение с inline-кнопками.	Не рассчитывайте на одинаковое поведение во всех клиентах MAX.	Редактирует сообщение с callback-кнопками.	Обновляет сообщение виджета.
Убирать кнопки	Удаляет inline-кнопки, сохраняя сообщение.	Зависит от возможностей MAX-кнопок.	Удаляет клавиатуру, сохраняя сообщение.	Удаляет кнопки, сохраняя сообщение.

Если действие кнопки недоступно в конкретном канале, такая кнопка не отправляется в этот канал. Остальные кнопки и fallback продолжают работать.

Запрос контакта используйте только для кнопки в поле ввода Telegram. После отправки номер сохраняется в contact_phone; переменную phone при необходимости запишите отдельным слотом памяти.

Проверка конечного канала

Сообщения приходят без заметной задержки и в правильном порядке.
Кнопки полностью помещаются и ведут в нужные ветки.
Постоянное меню исчезает или заменяется в ожидаемый момент.
Ссылки открываются и не запускают лишнюю ветку.
Ошибки отображаются понятным клиентским сообщением.