Миграция из amoCRM: OAuth, batch и mapping пользователей

Для кого эта инструкция

Для сотрудника с правом «Миграция», который переносит данные из amoCRM в DoCRM. Результат — созданная задача миграции с проверенным mapping пользователей и применёнными строками.

Где находится

В левом меню нажмите «Миграция amoCRM». Пункт доступен только при праве «Миграция». На странице находятся блоки «Данные интеграции amoCRM», «OAuth», «Новая задача миграции» и «Задачи миграции».

Сохраните данные приложения amoCRM

В блоке «Данные интеграции amoCRM» заполните:

• «Субдомен amoCRM»;
• «ID клиента из приложения amoCRM»;
• «Секретный ключ из приложения amoCRM».

При необходимости заполните «ID поля amoCRM со ссылкой на клиента DoCRM (опционально)». Нажмите «Сохранить». Эти значения относятся к приложению Migration DoCRM в amoCRM.

Подключите OAuth

В блоке «OAuth» скопируйте значение из поля «Redirect URI для amoCRM» в настройки приложения amoCRM. После прохождения авторизации вставьте полученный код в поле «Код авторизации amoCRM» и нажмите «Подключить OAuth».

Проверьте статус в правом верхнем углу блока: он должен измениться с «Не подключен» на «Подключен». Этот доступ используется для чтения контактов, сделок, задач и notes из amoCRM.

Создайте задачу миграции

В блоке «Новая задача миграции» укажите название и выберите файл .csv или .xlsx. В файле должна быть хотя бы одна строка с колонкой amoId или Amo ID. Колонка customerId или Customer ID нужна только если вы обновляете уже существующего клиента DoCRM.

Нажмите «Создать задачу миграции». После создания DoCRM сразу откроет страницу этой задачи. В списке «Задачи миграции» позже видны её название, статус и счётчики «Всего», «Собрано», «Ошибки» и «Применено».

Соберите данные и настройте mapping пользователей

На странице задачи сначала нажмите «Собрать batch». DoCRM загружает данные по строкам и обновляет счётчики. После сбора откройте блок «Mapping amo users»: в нём появятся пользователи amoCRM, найденные в собранных профилях.

Для каждого пользователя выберите сотрудника DoCRM, «Оставить пустым» или не выбирайте значение. Затем нажмите «Сохранить mapping». Не переходите к применению, пока не проверили mapping: от него зависит сопоставление ответственных сотрудников.

Проверьте строки и примените batch

В блоке «Результат по строкам» просмотрите Amo ID, Customer ID, статус, предупреждения и ошибку. Для собранной строки доступны действия «Preview» и «Применить», а для несобранной — «Собрать».

После проверки нажмите «Применить batch». DoCRM последовательно применяет собранные строки и обновляет количество «Применено». Для остановки текущего запуска используйте «Пауза». Если часть строк завершилась с ошибкой, после исправления причины нажмите «Повторить ошибки».

Важно: для первого переноса используйте небольшой тестовый файл и проверьте preview и mapping до применения полного набора.

Готово: строки задачи имеют итоговый статус, а счётчик «Применено» отражает обработанные записи.