1. Заходим в чат с ботом @its_bitrix24_bot
2.Отправляем боту команду /start
3. Отправляем боту команду /auth [адрес портала Битрикс24] для авторизации на портале
4. Пересылаем боту любые сообщения из Телеграм
5. Бот в ответ отправляет вопрос "Хотите создать задачу?" и кнопки для выбора ответа
6.1. Если нажимаем "Да", то бот отправит сообщение, что задача создана.
Нажав на название задачи, можно сразу перейти к этой задаче на портал Битрикс24.
6.2. Если нажимаем нет, кнопки пропадают и не беспокоят нас, пока мы снова не перешлем сообщение.
Если после этого просто отправим боту сообщение (не пересылка), то он не спрашивает, создавать ли задачу.
7. Рекомендуем сразу же указать группу/проект для задачи. Для этого нажимаем на "Сменить группу"
8. Бот в строку ввода сообщения вставляет текст. После последний вертикальной черточки
нужно начать писать название группы. Опираясь на введенный текст, бот выведет список групп.
Кликаем на название нужной нам группы/проекта, в котором должна находится созданная задача.
9.1 Если задача добавлена в группу, то бот пришлет сообщение "Группа успешно изменена".
9.2 Если группу сменить не удалось, то бот отправит уведомление об этом.
Скорее всего, у вас недостаточно прав доступа на портале Битрикс24.
10. Итог: задача создана на портале Битрикс24
Название задачи: текст первого пересланного боту сообщения.
Описание задачи: имя Телеграм пользователя и текст его сообщения.
Все фотографии, видео, стикеры и др., которые были прикреплены к
Телеграм сообщению остаются в файлах, прикрепленных к задаче.
Что нужно учитывать?
1. Чем разнообразнее файлы по формату и чем их больше, тем дольше будет создаваться задача на портале Битрикс24.
2. Бот подтягивает в задачу весь текст, картинки, гифки, ссылки, эмодзи и другую информацию, которая была переслана ему в течение 10 последних минут. Если не хотим, чтобы что-то из пересланного раннее в задачу попадало, придется выждать время.
3. При пересылке сообщений боту учитывать статус чата с ботом. Если мы переслали сообщение и не нажали ни да, ни нет на появившейся клавиатуре, а просто свернули ее и продолжаем пересылать сообщения, то бот не будет предлагать создать задачу и реагировать на пересылаемые сообщения, пока мы снова не развернем панель с кнопками и не выберем нужный вариант, "Да" или "Нет".
4. Если в чате Телеграм пользователь отправил картинку, видео или другой файл без текста, в созданной задаче на портале Битрикс24 будет рядом с его именем пусто. При этом то, что он скинул в чат, попадет в файлы, прикрепленные к задаче.
5. Некоторые эмодзи в Битрикс24 не отображаются или отображаются не совсем корректно.
6. Гифка прикрепляется в Битрикс как mp4. Стикеры - картинки в формате webp. Анимированные стикеры - файлы в формате tgs. Телеграм-кружочки сохраняются как видео в формате mp4.