Описание

Приложение позволяет связать личные и групповые чаты Telegram с чатами Bitrix24.

После настройки сотрудники смогут получать сообщения из Telegram и отвечать на них прямо из Bitrix24.

Приложение позволяет:

• Подключить собственного Telegram-бота
• Создать и настроить бота Bitrix24
• Включать и отключать обработку сообщений ботами
• Работать с пользователями и группами Telegram
• Связывать чаты Telegram с пользователями и групповыми чатами Bitrix24
• Автоматически сохранять сопоставления
• Передавать сообщения в обе стороны
• Передавать документы, изображения и другие файлы
• Отображать имя отправителя при пересылке сообщения
• Обновлять информацию и состояние подключённых ботов
• Удалять и повторно подключать ботов
• Выполнить первую настройку по встроенному чек-листу

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

Первая настройка

После установки приложения на главной странице появится чек-лист первоначальной настройки.

Необходимо выполнить пять этапов:

1. Подключить Telegram-бота
2. Создать бота Bitrix24
3. Инициализировать нужные чаты Telegram
4. Создать или подготовить чат Bitrix24
5. Сопоставить чаты

Этапы отмечаются пользователем вручную. При необходимости чек-лист можно скрыть и снова открыть кнопкой Чек-лист настройки.

Telegram-бот

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

Если у Вас ещё нет Telegram-бота:

1. Откройте BotFather
2. Отправьте команду /newbot
3. Укажите название бота
4. Укажите username, который заканчивается на bot
5. Скопируйте полученный токен

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

1. Откройте в приложении раздел Боты
2. Перейдите на вкладку Telegram
3. Вставьте токен, полученный от BotFather
4. Нажмите Подключить

Приложение проверит токен через Telegram API и попытается автоматически установить webhook.

После подключения будут показаны:

• ID бота
• Название
• Username
• Состояние обработки сообщений
• Текущий статус webhook

Включение и отключение Telegram-бота

Обработка сообщений включается и отключается с помощью переключателя Состояние.

При включении приложение устанавливает webhook Telegram-бота.

При отключении webhook удаляется, и новые сообщения перестают поступать в приложение.

Обновление информации

Нажмите Обновить, чтобы повторно получить:

• Название бота
• Username
• Состояние webhook
• Текущий статус подключения

Открытие и копирование username

Рядом с username доступны две кнопки:

• Скопировать username
• Открыть Telegram-бота

При копировании в буфер обмена username добавляется вместе с символом @.

Удаление Telegram-бота

1. Откройте раздел Боты → Telegram
2. Нажмите Удалить
3. Подтвердите удаление

Приложение удалит webhook и очистит сохранённый токен Telegram-бота.

Настройка групп Telegram

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

Чтобы бот получал все сообщения группы:

1. Откройте BotFather
2. Отправьте команду /setprivacy
3. Выберите подключённого бота
4. Нажмите Disable

Если бот отвечает на команду /start, но не получает остальные сообщения группы, проверьте настройку /setprivacy.

После изменения настройки рекомендуется удалить бота из группы и добавить его повторно.

Бот Bitrix24

Создание бота Bitrix24

1. Откройте раздел Боты
2. Перейдите на вкладку Bitrix24
3. Укажите имя бота
4. При необходимости укажите должность
5. Нажмите Создать

Имя и должность будут отображаться сотрудникам в чатах и профиле бота Bitrix24.

Изменение бота Bitrix24

1. Откройте раздел Боты → Bitrix24
2. Измените имя или должность
3. Нажмите Сохранить

Включение и отключение бота Bitrix24

Используйте переключатель Состояние, чтобы включить или отключить обработку входящих сообщений Bitrix24.

При отключении бот останется зарегистрирован в Bitrix24, но приложение перестанет обрабатывать поступающие от него сообщения.

Обновление информации

Нажмите Обновить, чтобы повторно получить актуальные данные бота непосредственно из Bitrix24.

Удаление бота Bitrix24

1. Откройте раздел Боты → Bitrix24
2. Нажмите Удалить
3. Подтвердите действие

Регистрация бота и его настройки будут удалены.

Инициализация чатов Telegram

Добавление пользователя Telegram

1. Откройте подключённого Telegram-бота
2. Нажмите Старт или отправьте команду /start
3. Дождитесь сообщения об успешной инициализации
4. Откройте в приложении раздел Сопоставление
5. Пользователь появится в таблице

Добавление группы Telegram

1. Добавьте Telegram-бота в нужную группу
2. Убедитесь, что через BotFather отключён режим конфиденциальности
3. Отправьте в группу команду /start
4. Дождитесь сообщения об успешной инициализации
5. Откройте раздел Сопоставление
6. Группа появится в таблице

В таблице отображаются:

• Название пользователя или группы
• Username, если он доступен
• ID Telegram-чата
• Тип: Пользователь или Группа

Инициализация чата Bitrix24

1. Создайте новый групповой чат Bitrix24 или откройте существующий
2. Добавьте в чат созданного бота Bitrix24
3. Отправьте команду /start
4. Дождитесь сообщения Бот успешно инициализирован

После этого чат станет доступен для выбора на странице сопоставлений.

Таким же способом можно инициализировать личный диалог с ботом Bitrix24.

Сопоставление чатов

1. Откройте раздел Сопоставление
2. Найдите нужного пользователя или группу Telegram
3. В колонке Сопоставление выберите пользователя или чат Bitrix24
4. Сопоставление будет сохранено автоматически

Для поиска доступны:

• Фильтр Все
• Фильтр Группы TG
• Фильтр Пользователи TG
• Поиск по названию, username или ID

Один чат Telegram может быть связан только с одним диалогом Bitrix24. Один диалог Bitrix24 также нельзя одновременно связать с несколькими чатами Telegram.

Удаление сопоставления

Чтобы удалить связь между чатами:

1. Найдите нужную строку
2. Нажмите кнопку с крестиком справа от выбранного сопоставления
3. Дождитесь обновления таблицы

После удаления сообщения между этими чатами больше не передаются.

Передача сообщений

Из Telegram в Bitrix24

Когда пользователь отправляет сообщение в сопоставленный чат Telegram:

1. Приложение определяет связанный диалог Bitrix24
2. В сообщение добавляется имя отправителя
3. При наличии username он указывается после имени
4. Текст и файлы отправляются в выбранный чат Bitrix24

Из Bitrix24 в Telegram

Когда сотрудник отправляет сообщение в сопоставленный чат Bitrix24:

1. Приложение определяет связанный Telegram-чат
2. Имя сотрудника добавляется перед сообщением
3. Текст и файлы отправляются через подключённого Telegram-бота

Если отправлено несколько файлов, текст сообщения добавляется к первому файлу. Остальные файлы отправляются отдельно без повторения текста и имени отправителя.