Подключение Telegram

Telegram-канал нужен, чтобы Senler AI получал сообщения из Telegram-бота и отправлял ответы агента или оператора.

Перед началом подготовьте токен бота из BotFather. Если бота еще нет, создайте его в BotFather и скопируйте токен вида 123456789:ABC....

Как подключить

1. Откройте раздел через пункт «Каналы» в боковом меню.
2. Нажмите "Добавить канал".
3. Выберите Telegram.
4. Вставьте токен в поле для токена Telegram-бота.
5. Нажмите кнопку подключения Telegram-бота.
6. После подключения откройте настройки канала и проверьте статус.

Что важно знать про токен

Токен похож на 123456789:ABC.... Его нельзя отправлять в чат поддержки, публиковать в документах или передавать третьим лицам. Вводите токен только в форму подключения канала в кабинете.

Если токен был раскрыт, обновите его в BotFather и замените в настройках канала.

После подключения

На странице настроек канала проверьте:

• статус токена;
• имя и username бота;
• вебхук;
• включен ли канал.

Назначение агента проверяйте в диалоге и в настройках самого агента, а не в блоке подключения канала.

Альбомы с несколькими вложениями

Если пользователь отправляет несколько фото или видео одним альбомом Telegram, Senler AI собирает их в одно сообщение диалога. Доступные подписи из частей альбома объединяются, а части без подписи не мешают сборке; все вложения остаются в одной карточке. Обработка начинается после сборки: альбом считается одним входящим сообщением и не создаёт отдельный запуск для каждого файла. Итоговое количество ответов определяется назначенными агентами и их ролями в диалоге.

Отдельного переключателя для альбомов нет: сборка применяется автоматически к входящим Telegram-альбомам. В истории события во время сборки может быть статус collecting, а после завершения — complete. Это состояние альбома, а не ошибка и не статус доставки ответа.

Канал или бот как отправитель

В группе Telegram сообщение может прийти от человека, стороннего бота либо от имени канала или чата через sender_chat. Senler хранит эти случаи по-разному:

• сторонний бот отображается как лид типа «Канал»; его входящее сообщение может назначить и запустить агента по обычным правилам диалога;
• внешний канал, от имени которого отправлено сообщение через sender_chat, остаётся пространством Telegram и не создаёт отдельного лида; его входящее сообщение также может запустить агента;
• сообщение от имени самой текущей группы или связанного с ней канала считается действием со стороны проекта, сохраняется в истории и не запускает агента.

Если внешний чат или канал принадлежит вашей команде, но Senler воспринимает его сообщения как клиентские, отметьте соответствующее пространство как «Оператор проекта». Для внешнего аккаунта сотрудника, который отображается лидом, используйте такую же отметку в профиле лида.

Чтобы понять, почему агент запустился или не запустился, откройте исходное сообщение в диалоге и проверьте отправителя: человек или бот относится к лиду, отправка от имени канала или чата - к пространству либо к стороне проекта.

Если Telegram не отвечает

Проверьте по порядку:

1. Токен не изменился в BotFather.
2. Вебхук установлен без ошибки.
3. Канал не остановлен.
4. В диалоге уже назначен агент либо правила автоназначения подходят для этого Telegram-канала и типа диалога.
5. Назначенный агент опубликован и активен.
6. В истории событий нет ошибок доставки.