Как подключить Telegram-бота к Chatix

Чтобы AI-агент отвечал клиентам в Telegram, нужен отдельный бот и его токен. Бота создаёт официальный сервис Telegram — @BotFather. В Chatix достаточно вставить полученный токен: платформа проверит его, определит username бота и автоматически настроит получение сообщений через webhook.

Инструкция подходит для нового и уже существующего бота. В текущей версии Chatix Telegram-канал работает в личных чатах пользователя с ботом. Сообщения из групп и Telegram-каналов не обрабатываются.

Что подготовить перед подключением#

Проверьте, что у вас есть:

• аккаунт Telegram с доступом к @BotFather;
• созданный AI-агент Chatix;
• опубликованная конфигурация агента и актуальная база знаний;
• доступ к разделу подключения каналов в рабочем пространстве Chatix.

Если агент ещё не наполнен информацией, сначала выберите подходящий источник по гайду по базе знаний. Telegram использует ту же конфигурацию и те же источники, что песочница и другие каналы агента.

1. Откройте официальный @BotFather#

Перейдите по ссылке t.me/BotFather и проверьте две детали: username должен быть именно @BotFather, а рядом с именем должна стоять отметка верификации Telegram. Не передавайте токен сторонним ботам с похожими названиями.

Нажмите Start или отправьте команду /start. Официальное руководство Telegram также указывает @BotFather как способ регистрации бота и получения токена.

2. Создайте нового Telegram-бота#

Отправьте @BotFather команду /newbot. Затем последовательно укажите:

1. Отображаемое имя — его увидят пользователи в профиле и диалоге. Укажите название, по которому клиент поймёт, кому пишет: название компании, службы поддержки или конкретного сервиса.
2. Username — уникальный адрес бота латиницей. По правилам Telegram обычный username бота должен заканчиваться на bot. Выберите короткий вариант, связанный с вашим названием, и избегайте непонятных сокращений.

Если username занят, @BotFather попросит выбрать другой. После успешного создания бот пришлёт ссылку на профиль и токен доступа.

Для существующего бота отправьте /mybots, выберите нужного бота и откройте раздел управления токеном. Не создавайте второго бота, если клиенты уже используют первый и вы хотите сохранить его username.

3. Скопируйте токен и сохраните его как пароль#

Токен выглядит примерно так: 123456789:AAExampleToken.... Он авторизует управление ботом через Telegram Bot API. Человек, получивший токен, может отправлять сообщения от имени бота и менять его интеграцию, поэтому:

• не публикуйте токен в инструкции, переписке или скриншоте;
• не вставляйте его в адресную строку браузера;
• не храните токен в открытом документе;
• при утечке немедленно перевыпустите его через @BotFather.

Chatix не показывает сохранённый токен обратно в интерфейсе. На сервере он хранится в зашифрованном виде.

4. Подключите токен в Chatix#

В Chatix откройте нужного агента и перейдите в раздел Каналы. На карточке Telegram нажмите Подключить.

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

Дальше Chatix выполняет настройку автоматически:

1. Вызывает метод getMe Telegram Bot API и проверяет, что токен действителен.
2. Получает ID и username бота для отображения в интерфейсе.
3. Создаёт отдельный секрет для входящих запросов.
4. Регистрирует webhook через setWebhook.
5. Разрешает Telegram передавать входящие сообщения подключённому агенту.

Самостоятельно создавать URL webhook, копировать confirmation-код или запускать сервер не требуется. Если Telegram отвергнет токен или webhook, Chatix не оставит частично настроенный канал и покажет ошибку подключения.

5. Проверьте бота в личном чате#

Откройте ссылку на бота или найдите его по username. Нажмите Start и задайте 5–10 вопросов, ответы на которые точно есть в базе знаний агента.

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

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

Какие сообщения обрабатывает Telegram-канал#

Chatix принимает текстовые сообщения и подписи к медиа. Поддерживаемые фотографии и документы могут быть сохранены как вложения диалога и переданы в обработку в рамках ограничений Chatix по типу и размеру файла. Контакт, которым пользователь поделился через Telegram, может дополнить карточку клиента, но сам по себе не считается подтверждением владения телефонным номером.

Длинный ответ агента автоматически делится на несколько Telegram-сообщений, чтобы не превысить лимит Bot API. Все личные обращения одного пользователя появляются в общем helpdesk Chatix; оператор может забрать разговор и ответить клиенту обратно через того же бота.

Группы сейчас не поддерживаются. Если добавить бота в группу, Chatix пропустит групповые сообщения: это защищает историю диалога от смешивания между личным и групповыми чатами.

Как заменить или отключить Telegram-бота#

Если токен скомпрометирован, перевыпустите его в @BotFather. После этого старый токен перестанет быть безопасным основанием для интеграции, поэтому переподключите Telegram-канал в Chatix.

Чтобы временно остановить ответы, отключите канал в настройках агента. Для окончательного удаления используйте действие удаления канала. Удаление подключения не удаляет самого бота в Telegram — бот по-прежнему управляется через @BotFather.

Чек-лист перед запуском#

• Открыт именно верифицированный @BotFather.
• Username бота понятен клиентам и ведёт на правильный профиль.
• Токен нигде не опубликован и доступен только ответственным сотрудникам.
• Chatix подтвердил подключение и показывает username бота.
• Агент проверен в личном чате на типовых вопросах клиентов.
• В базе знаний нет устаревших или противоречивых условий.
• Команда понимает, что групповые чаты пока не обрабатываются.

Подробное описание возможностей канала доступно на странице Telegram для Chatix. После проверки можно разместить ссылку на бота на сайте, в разделе контактов и в материалах поддержки.