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

Что понадобится

• Telegram-аккаунт, переписку которого нужно вести в AISAR, и телефон или компьютер, где он открыт. Telegram Premium не нужен.
• Свой бот в @BotFather с включённым Business Mode. Его можно создать по ходу подключения (шаг 1 ниже). Клиенты бота не видят: он служит пропуском к вашему аккаунту.
• Новый или свободный бот. Бот, который уже подключён к AISAR (в том числе как канал Telegram Bot), второй раз не подключится. У бота, который работает в другом сервисе, AISAR заберёт приём сообщений: у бота может быть только один webhook.
• Один бот на один аккаунт. Если клиентам отвечают несколько менеджеров со своих аккаунтов, каждому нужен свой бот и свой канал.
• Доступ к my.aisar.app с правом подключать каналы (роль администратора или менеджера) и свободное место в лимите каналов тарифа: Telegram Business считается как любой другой канал. Состав тарифов — на aisar.app.

Что будет работать

• Новые сообщения из чатов, к которым вы дадите боту доступ, приходят в общий инбокс AISAR: текст, фото, видео, аудио, голосовые, документы, стикеры, геопозиция.
• Ответы операторов и ИИ-агента уходят от имени вашего аккаунта. Клиент видит обычную переписку с вами, а не с ботом.
• Ответы, которые вы пишете с телефона, тоже попадают в AISAR с пометкой «Отправлено из Telegram». Приветствие и «нет на месте», настроенные в Telegram для бизнеса, приходят с пометкой «Автоответ Telegram».
• Контакт тот же, что и в личном Telegram-канале: если клиент раньше писал вам туда, его карточка, сделки и история останутся при нём.
• Автоматизации с условием по каналу Telegram срабатывают и на этот канал.

Ограничения Telegram

• Ответить можно только в течение 24 часов после последнего сообщения клиента. Если клиент молчит дольше, Telegram не доставит ответ, пока клиент не напишет снова. В чате AISAR в этом случае появится подсказка.
• Написать клиенту первым нельзя. Новый диалог через этот канал не начать, и в рассылках он не участвует.
• Переписку до подключения Telegram боту не отдаёт: в AISAR появятся только новые сообщения.
• Только личные чаты, без групп и каналов Telegram.
• Кнопки в сообщениях пока не поддерживаются, поэтому опрос качества уходит текстом. Реакции из AISAR на этом канале недоступны.

Шаг 1. Создайте бота и включите Business Mode

1. Откройте в Telegram @BotFather и отправьте /newbot. Придумайте боту имя и адрес, например «Dental Almaty ресепшн» и @dentalmaty_desk_bot. Адрес должен заканчиваться на bot.
2. Включите Business Mode: /mybots → ваш бот → Bot Settings → Business Mode → Turn on.
3. Скопируйте токен из сообщения BotFather. Он выглядит как 7412869035:AAG…. Для уже созданного бота токен покажет команда /token.

Шаг 2. Проверьте бота в AISAR

1. В my.aisar.app откройте Настройки → Каналы → Добавить канал и на карточке Telegram Business нажмите Подключить. Откроется мастер «Подключить Telegram Business» из четырёх шагов: Обзор, Бот, Подключение в Telegram, Готово.
2. На шаге Обзор прочитайте, чем этот канал отличается от личного Telegram и Telegram-бота, и перейдите к шагу Бот.
3. Вставьте токен в поле Токен бота. Название канала можно не заполнять: тогда канал назовётся по аккаунту, который вы подключите.
4. Нажмите Проверить и подключить. AISAR проверит токен, убедится, что Business Mode включён, и настроит приём сообщений. Токен хранится в зашифрованном виде. После этого канал уже создан и ждёт подключения бота в Telegram.

Шаг 3. Подключите бота в приложении Telegram

1. На телефоне или компьютере, где открыт нужный аккаунт, откройте Настройки → Telegram для бизнеса → Чат-боты.
2. Введите адрес своего бота и выберите его.
3. В разделе доступа к чатам выберите «Только выбранные чаты» и отметьте клиентов или типы чатов. Можно оставить «Все чаты», но тогда добавьте личные контакты в исключения.
4. Выдайте боту права, как описано в следующем разделе, и сохраните.
5. Вернитесь в мастер AISAR. Как только Telegram сообщит о подключении, на шаге Подключение в Telegram появятся аккаунт и выданные права, обновлять страницу не нужно. Мастер можно закрыть кнопкой Закончу позже: канал подключится, когда вы добавите бота. Кнопка Отменить подключение удаляет канал и освобождает бота и место в тарифе.

Какие права дать боту

Права меняются только в Telegram, AISAR видит их после каждого изменения. Если вы выдали боту лишние права, на странице канала появится предупреждение со списком: снимите их в Telegram, подключение продолжит работать, а предупреждение исчезнет само. Без права «Отвечать на сообщения» канал подключится в режиме «только чтение», а отправка из чата будет недоступна, пока вы его не включите.

Если аккаунт уже подключён как личный Telegram

Если этот же аккаунт уже подключён в компании как канал «Telegram» (личный, по QR-коду), AISAR остановит подключение через бота: иначе каждое сообщение приходило бы в AISAR дважды, а ИИ-агент отвечал бы дважды. Мастер и страница канала покажут, что аккаунт уже подключён как личный Telegram. Так же выглядит переход с личного канала на Telegram Business:

1. Отключите личный канал Telegram в AISAR. История и чаты в нём останутся.
2. В Telegram откройте Настройки → Telegram для бизнеса → Чат-боты, уберите бота и добавьте его снова. Вместо этого можно нажать Переподключить на странице канала Telegram Business.
3. Подключение пройдёт, и новые сообщения пойдут через Telegram Business. Контакт останется тем же, что в личном канале, а прежняя переписка останется в личном канале: в Telegram Business её не перенести.

Иногда AISAR не может проверить, тот же ли это аккаунт, и показывает предупреждение «Похоже, этот аккаунт уже ведёт личный Telegram-канал». Подключение при этом проходит. Если аккаунт действительно тот же, отключите личный канал, иначе сообщения будут приходить дважды. Работает только один из двух каналов: если личный канал с этим аккаунтом позже подключат снова, AISAR остановит канал Telegram Business.

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

В списке каналов (Настройки → Каналы) у канала появится статус Подключён, а на его странице блок «Подключение Telegram Business» покажет аккаунт, бота и выданные права. Попросите коллегу написать вам в Telegram: сообщение должно появиться в разделе Чат в течение нескольких секунд, а ответ из AISAR должен прийти от вашего имени.

Если канал отключился

• Бот отключён в Telegram. Новые сообщения не приходят, ответы не отправляются, история в AISAR сохранена. Включите бота снова в Настройки → Telegram для бизнеса → Чат-боты, канал вернётся сам.
• Токен бота больше не действует. Обычно так бывает после перевыпуска токена в @BotFather. На странице канала нажмите Переподключить и вставьте новый токен этого же бота. Токен другого бота не подойдёт: для другого бота подключите новый канал.
• Канал отключён в AISAR. Нажмите Переподключить на странице канала и оставьте поле токена пустым: AISAR переподключит канал с сохранённым токеном.

Частые проблемы

Смотрите также

Нужен канал без привязки к личному аккаунту, где клиенты пишут боту? Смотрите «Подключение Telegram Bot». Про личный Telegram по QR-коду — «Подключение Telegram», про статусы каналов — «Канал ушёл в переподключение: что делать».