Переезд в Битрикс24 почти всегда упирается в вопрос: как перенести накопленные задачи из прежней системы без потерь. Готового «универсального импорта задач» в интерфейсе нет, поэтому миграция выполняется через штатные переносы, интеграции и REST API — выбор зависит от источника и объёма.
Какими способами переносят задачи
В отличие от CRM, где есть мастер импорта из CSV, у задач нет единой кнопки «загрузить из файла» в общем случае. Перенос выполняют одним из подходов:
| Способ | Когда подходит | Сложность |
|---|---|---|
| Штатные переносы (миграторы) | Trello, Asana и другие популярные сервисы | Низкая |
| Приложения из Маркета | Готовые коннекторы к Jira, Trello и т. п. | Низкая-средняя |
| REST API | Любой источник, гибкое сопоставление полей | Средняя-высокая |
| Ручное создание по шаблонам | Небольшой объём, разовый перенос | Низкая, но трудозатратно |
Выбор зависит от трёх факторов: источник (есть ли готовый мигратор), объём (десятки или тысячи задач) и требования к точности (нужно ли сохранить исполнителей, сроки, комментарии, вложения).
Штатные переносы и приложения Маркета
Для популярных сервисов Битрикс24 предлагает готовые инструменты миграции, которые не требуют программирования. Они подключаются к аккаунту источника и переносят доски, списки и карточки в проекты и задачи.
Что обычно удаётся перенести автоматически:
- названия и описания задач;
- структуру досок и списков (превращаются в группы и стадии);
- исполнителей — при условии, что пользователи заранее заведены на портале;
- сроки и часть меток.
Готовые приложения ищите в Битрикс24.Маркет по названию исходной системы. Внимательно читайте описание: часть коннекторов односторонние (только импорт), часть поддерживает синхронизацию.
Импорт через REST API
Когда штатных инструментов нет или нужен полный контроль над сопоставлением полей, задачи создают через REST API. Основной метод — tasks.task.add, принимающий поля задачи в структуре fields.
Минимальный набор полей при создании:
TITLE— название задачи;RESPONSIBLE_ID— ID ответственного;DESCRIPTION— описание;DEADLINE— крайний срок;GROUP_ID— проект/группа, куда поместить задачу.
Пример вызова через входящий вебхук:
POST https://portal.bitrix24.ru/rest/1/xxxx/tasks.task.add.json
{"fields":{"TITLE":"Перенесённая задача","RESPONSIBLE_ID":17,"GROUP_ID":42,"DEADLINE":"2026-08-01T18:00:00"}}
Для массового переноса пишется скрипт, который читает выгрузку из источника (CSV/JSON или его API) и по строкам вызывает tasks.task.add. Чтобы не упереться в лимиты, вызовы группируют пакетным методом batch.
batch и паузы между пачками, иначе портал начнёт отклонять вызовы по превышению лимита.Сопоставление полей источника и Битрикс24
Самая кропотливая часть миграции — маппинг. Поля во внешних системах называются иначе и не всегда имеют прямой аналог. Составьте таблицу соответствий заранее:
| Внешняя система | Поле Битрикс24 |
|---|---|
| Card name / Summary | TITLE |
| Assignee | RESPONSIBLE_ID |
| Due date | DEADLINE |
| Board / List | GROUP_ID + стадия канбана |
| Labels / Tags | Метки задачи или пользовательское поле |
| Comments | Комментарии (отдельным методом) |
Отдельная проблема — идентификаторы пользователей: во внешней системе исполнитель задан e-mail или логином, а в Битрикс24 нужен числовой ID. Заранее выгрузите список пользователей портала (user.get) и сделайте словарь соответствий e-mail → ID.
Что часто теряется при миграции
Ни один перенос не бывает стопроцентным. Заранее решите, что для вас критично, а чем можно пожертвовать:
- История и даты создания. Импортированная задача получает текущую дату создания; исходную историю переносят в описание или комментарий.
- Вложения. Файлы переносятся не всегда автоматически — крупные вложения нередко приходится загружать отдельно.
- Комментарии. Их добавляют отдельным методом после создания задачи, и авторство обычно теряется (все комментарии от имени интеграции).
- Связи и зависимости. Иерархию подзадач и зависимости восстанавливают вторым проходом, когда все задачи уже созданы и известны их новые ID.
Чек-лист безопасной миграции
Перед боевым переносом пройдите по шагам:
- Завести и сопоставить всех пользователей на портале;
- Подготовить структуру проектов и групп-приёмников;
- Составить таблицу маппинга полей;
- Прогнать тестовый импорт на 10–20 задачах и проверить результат;
- Убедиться, что сроки, ответственные и группы проставились верно;
- Запустить основной перенос пакетами через
batch; - Вторым проходом восстановить подзадачи, зависимости и комментарии;
- Сверить контрольные суммы: число задач в источнике и на портале.
Итог
Импорт задач в Битрикс24 выполняется штатными переносами и приложениями Маркета для популярных сервисов либо через REST API (tasks.task.add + batch) для произвольных источников и точного контроля. Ключ к успеху — заранее завести пользователей, составить маппинг полей, прогнать тестовый импорт и переносить связи вторым проходом.
Мы выполняем миграцию задач и проектов из Trello, Jira, Asana и таблиц с сохранением исполнителей, сроков и структуры, а также настраиваем интеграции для постоянной синхронизации. Если переезд большой или источник нестандартный, поможем спроектировать перенос так, чтобы команда продолжила работать без потери данных.
Частые вопросы
Есть ли в Битрикс24 импорт задач из файла?
Единой штатной кнопки импорта задач из CSV, как в CRM, нет. Перенос выполняется штатными миграторами для популярных сервисов, приложениями из Маркета или через REST API.
Как перенести задачи из Trello или Asana?
Для популярных сервисов есть готовые переносы и приложения в Битрикс24.Маркет. Они подключаются к аккаунту источника и переносят доски, карточки, исполнителей и сроки без программирования.
Каким методом API создавать задачи?
Основной метод — tasks.task.add, он принимает поля задачи в структуре fields: TITLE, RESPONSIBLE_ID, DESCRIPTION, DEADLINE, GROUP_ID и другие. Для массового переноса вызовы группируют методом batch.
Почему задачи импортировались без ответственных?
Потому что пользователи источника не сопоставлены с пользователями портала. Заведите всех сотрудников заранее и подготовьте словарь соответствий e-mail или логин на числовой ID Битрикс24.
Переносятся ли комментарии и вложения?
Не всегда автоматически. Комментарии добавляются отдельным методом после создания задачи и обычно теряют авторство, а крупные вложения часто приходится загружать отдельно.
Как перенести подзадачи и зависимости?
Вторым проходом. Сначала создайте все задачи и соберите таблицу соответствия старых и новых ID, затем проставьте иерархию подзадач и зависимости, когда новые идентификаторы уже известны.
Что делать при большом объёме задач?
Используйте пакетный метод batch и паузы между пачками, чтобы не превысить лимиты частоты запросов REST. Обязательно прогоните тестовый импорт на небольшой выборке перед основным переносом.
Поможем с настройкой и поддержкой Битрикс24
Поможем с настройкой, доработкой и поддержкой Битрикс24.