Каналы

Через что пользователь общается с агентом

Канал — это то, через что вы общаетесь с агентом: чат в дашборде, приложение в телефоне, бот в Telegram, IDE. Он связывает подключение с одним конкретным агентом, и связь двусторонняя — входящие сообщения идут этому агенту, ответы уходят обратно тем же путём.

Канал всегда принадлежит одному агенту. Поэтому одного бота на нескольких агентов не разделить: чтобы отвечал другой агент, нужен другой канал и другое подключение.

Webchat заводится сам

Канал для чата в дашборде настраивать не нужно. Когда вы первый раз открываете чат с агентом, платформа сама находит или создаёт подключение webchat и канал с именем «Webchat: имя агента». Дальше он просто есть.

Поэтому у свежесозданного агента на вкладке «Каналы» может быть пусто до первого сообщения — это нормально, а не признак того, что что-то не настроено.

Telegram настраивается руками

Порядок обратный: сначала коннектор, потом канал.

Завести бота у BotFather и создать подключение Telegram с его токеном — это раздел Подключить Telegram.
Создать канал, который свяжет это подключение с агентом — Канал в Telegram.

Само по себе подключение только принимает сообщения. Без канала их некому передать, и бот будет молчать.

Тот же чат в телефоне

Отдельного канала для телефона заводить не нужно: приложение для Android работает через тот же вебчат и те же переписки, что и дашборд, и добавляет к ним пуши о новых сообщениях.

Какие бывают обработчики

Обработчик канала решает, как сообщения разбираются на входе и как собирается ответ.

webchat — чат в дашборде. Заводится сам.
telegram — бот: текст, фото и документы на входе, текст и вложения в ответ.
acp — диалог из IDE по Agent Client Protocol. Тоже заводится сам, при первой сессии из редактора.
generic — универсальный обработчик для коннекторов, у которых триггеры и инструменты объявляет само приложение. Мапинг задаётся настройками: какие триггеры слушать, по какому пути в событии лежит текст сообщения и каким инструментом отправлять ответ.

Сессии

Разговоры канала лежат на его вкладке «Сессии». Одна сессия — одна тема разговора; её можно открыть и прочитать целиком, переименовать или закрыть. Закрытая сессия остаётся читаемой, писать в неё уже нельзя.

Удалить канал

Канал немедленно перестаёт получать триггеры. История сессий при этом сохраняется и остаётся доступной.