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

Суть работы интеграции с telegram-ботом такова: клиент подписывается на бота, отправляет в него сообщение. Сообщение передаётся в Swarmica в качестве заявки, и на неё может отвечать агент. Агент не может инициировать переписку с клиентом, который пока не подписался на бота и ничего не написал.

Telegram работает по принципу одно подключение = 1 бот, поэтому, если ваш бот уже подключен к какому-либо сервису, необходимо отключить бота от этого сервиса или создать нового бота.

Создание telegram-бота

Для создания нового бота перейдите по ссылке https://t.me/botfather в официальный бот Telegram, который создаёт новых ботов.

Запустите бота и введите или выберите /newbot

Введите и отправьте имя вашего бота. Это имя будут видеть ваши клиенты.

Затем задайте никнейм бота, по которому его можно будет найти в Telegram. Никнейм должен быть уникальным и заканчиваться на bot. Если никнейм уже занят, Telegram сообщит об этом в ответ.

Если никнейм не занят, бот будет успешно создан, и Telegram выдаст такое сообщение:

В первом сообщении BotFather, которое вы получили после запуска бота, можно найти список команд для редактирования бота:

Можно нажимать на эти команды или вводить в поле сообщения и отправлять.

Рекомендуем отключить возможность добавления бота в группы, так как групповые чаты не поддерживаются. Для этого выберите или введите команду /setjoingroups и нажмите Disable:

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

/setuserpic позволит вам установить аватар вашего бота. Картинку нужно будет прикрепить к ответному сообщению:

/setdescription позволит добавить боту описание, которое увидят ваши клиенты при подключении к боту:

Описание тоже нужно будет отправить ответным сообщением:

После завершения необходимых настроек подключите бот к Swarmica.

Подключение telegram-бота

Перейдите в Swarmica в раздел Настройки - Каналы и выберите Telegram. На открывшейся странице нажмите "Создать":

Введите название канала, на которое вам удобно будет ориентироваться при обработке заявок и нажмите

Откроется страница настроек:

Прежде всего, сюда нужно ввести токен вашего бота. Его можно найти в сообщении, которое пришло вам в ответ на успешно добавленный никнейм бота. Найдите его в чате с BotFather и нажмите на токен (сочетание букв и цифр) чтобы его скопировать:

Вставьте его в соответствующее поле настроек Swarmica.

Выберите, куда будут попадать сообщения, полученные из Telegram-бота: в заявки или в чаты:

Про отличие специфик заявок и чатов мы написали в отдельной статье.

Активируйте бегунок "Включен", чтобы активировать канал, и сохраните настройки:

После сохранения настроек бота зайдите на сервер Swarmica по SSH и выполните команду:

docker compose restart telegram