Что переносится и куда
Инструмент миграции импортирует клиентов, сделки и историю активности из Bitrix24 или amoCRM в Mavibot CRM.
Чтобы получить к нему доступ, перейдите в CRM → Настройки воронки (значок шестеренки) → «Миграция CRM» → «Открыть».
Если в вашем проекте еще нет воронок, вы увидите ссылку «Перенесите свои данные» на пустом экране CRM.
| Данные | Bitrix24 | amoCRM | Назначение в Mavibot |
|---|---|---|---|
| Клиенты | Контакты | Контакты | Клиенты CRM |
| Компании | Включая реквизиты компании и банковскую информацию | Включая данные из поля «Юридическое лицо» | Компании клиентов |
| Сделки | Все воронки | Все воронки | Сделки в выбранных воронках |
| Закрытые сделки | Необязательно | Необязательно | Статусы «Выиграно» и «Проиграно» |
| Лиды | Необязательно, импортируются в отдельную воронку | В amoCRM нет отдельных лидов | Воронка «Лиды (Bitrix24)» |
| Задачи | Действия и задачи | Задачи | Задачи CRM |
| Комментарии | Комментарии в ленте | Примечания и SMS | Заметки в диалогах с клиентами |
| Звонки | Включая ссылки на записи | Включая ссылки на записи | Записи звонков в диалогах с клиентами |
| Диалоги | Открытые линии, опционально с файлами | Недоступно: amoCRM не предоставляет диалоги через API | Диалоги с клиентами |
| Пользовательские поля | Поля контактов, сделок и лидов | Поля контактов и сделок | Переменные клиентов и сделок |
| Назначенные сотрудники | Через сопоставление сотрудников | Через сопоставление сотрудников | Участники команды проекта |
| Теги | Тип контакта и источник | Теги | Теги клиентов |
Перед началом работы
Только сотрудники с правом редактирования данных CRM в Mavibot могут запустить миграцию.
В вашей предыдущей CRM учетные данные для доступа должен создать администратор. Инструмент миграции может получить доступ только к тем данным, которые уполномочен видеть создатель учетных данных.
- Ваша предыдущая CRM остается без изменений. Инструмент миграции только читает данные. Вы можете продолжать работать в Bitrix24 или amoCRM как обычно.
- Без дубликатов клиентов. Если клиент с таким же номером телефона или адресом электронной почты уже существует в Mavibot (например, кто-то, кто ранее связывался с вами через WhatsApp), его существующий профиль будет обновлен. Заполняются только пустые поля; существующие значения остаются без изменений.
- Клиентам не отправляются сообщения. Автоматизации CRM, боты и кампании не запускаются во время миграции. Импортированные клиенты не перемещаются в начало списка диалогов.
- Вы можете безопасно запустить миграцию повторно. Ранее импортированные записи обновляются или пропускаются, добавляются только новые данные.
Перед началом необходимо установить флажок, подтверждающий:
«Данные принадлежат нашей компании, и мы разрешаем Mavibot перенести их».
Миграция не может начаться без этого подтверждения.
Миграция из Bitrix24
Для подключения Bitrix24 вам понадобится входящий вебхук. Его создание занимает примерно две минуты.
Создайте вебхук с помощью учетной записи администратора Bitrix24, чтобы миграция могла получить доступ ко всем сделкам и диалогам.
- В Bitrix24 перейдите в Разработчикам → Другое → Входящий вебхук.
- Выберите разрешения, перечисленные в таблице ниже. Строго обязательно только CRM, но без остальных разрешений некоторые данные не будут импортированы.
- Нажмите Сохранить и скопируйте URL из поля «Вебхук для вызова REST API». Он выглядит так:
https://your-portal.bitrix24.ru/rest/1/xxxxxxxxxxxx/. - В Mavibot откройте Миграция CRM, выберите вкладку Bitrix24 и вставьте URL в поле «URL входящего вебхука».
- Подтвердите, что вы владеете данными, и нажмите «Проверить доступ и обнаружить данные». Затем следуйте шагам мастера миграции, описанным ниже.
| Разрешение вебхука | Что оно дает | Без него |
|---|---|---|
| CRM | Клиенты, компании, сделки, лиды, действия, комментарии | Миграция не может начаться |
| Пользователи (базовое) | Список сотрудников для сопоставления | У сделок не будет назначенных сотрудников |
| Открытые линии | Диалоги с клиентами | Диалоги не будут импортированы |
| Задачи | Задачи из модуля «Задачи» | Будут импортированы только действия CRM |
| Телефония | Длительность звонков и ссылки на записи | У звонков не будет длительности или ссылок на записи |
| Диск | Файлы из диалогов | Некоторые файлы останутся ссылками в сообщениях |
Если какое-либо разрешение отсутствует, мастер отобразит предупреждение на шаге «Данные найдены».
Добавьте необходимое разрешение в настройках вебхука Bitrix24 и нажмите «Обнаружить снова».
Bitrix24 допускает не более двух запросов в секунду, поэтому сбор данных с крупного портала может занять больше времени.
Вы можете закрыть страницу, пока миграция выполняется в фоновом режиме.
Ошибки подключения
| Сообщение об ошибке | Что делать |
|---|---|
| «Это не URL вебхука» | Вы ввели адрес портала или электронную почту. Скопируйте URL из поля «Вебхук для вызова REST API» |
| «URL вебхука должен начинаться с https://» | Скопируйте полный URL, включая https://
|
| «Bitrix24 отклонил вебхук» | Вебхук был удален или URL скопирован неправильно. Создайте новый вебхук |
| «Вебхук не имеет разрешения CRM» | Включите разрешение CRM в настройках вебхука |
| «Bitrix24 не отвечает» | Проверьте адрес портала в URL вебхука и попробуйте снова |
| «Bitrix24 не снял ограничение на количество запросов» | Портал может быть занят другими интеграциями. Попробуйте позже |
Если раздел Разработчикам отсутствует в меню Bitrix24 или вы не можете сохранить вебхук, проверьте тарифный план Bitrix24.
Вебхуки могут быть недоступны на бесплатном тарифе Bitrix24.
Миграция из amoCRM
Для подключения amoCRM вам понадобятся адрес вашего аккаунта и долгосрочный токен от внешней интеграции.
Только администратор аккаунта может сгенерировать токен.
При создании интеграции amoCRM отправляет проверочный код на адрес электронной почты администратора, поэтому убедитесь, что у вас есть доступ к этому почтовому ящику.
- В amoCRM откройте amoMarket → ⋯ (в правом верхнем углу) → Создать интеграцию → Внешняя интеграция → Создать.
- Заполните форму:
- URL перенаправления — любой HTTPS-адрес, например, ваш сайт. Он не используется для токена.
- Предоставить доступ — выберите «Доступ к данным аккаунта». Другие разрешения не требуются.
- Название и описание — например, «Миграция в Mavibot».
- Логотип — любое изображение 400×272. Без логотипа amoCRM может не сохранить интеграцию.
- Нажмите Сохранить. amoCRM попросит подтвердить интеграцию. Нажмите Отправить код, введите шестизначный код из письма и нажмите Подтвердить.
- Откройте созданную интеграцию и перейдите в Ключи и доступ → Сгенерировать долгосрочный токен. Выберите срок действия. Одного месяца обычно достаточно для миграции.
- Скопируйте токен сразу. amoCRM отображает его только один раз.
- В Mavibot откройте Миграция CRM и выберите вкладку amoCRM. Введите
company.amocrm.ruили простоcompanyв поле «Адрес аккаунта». Адресcompany.amocrm.comтакже поддерживается. Вставьте ваш токен в поле «Долгосрочный токен». - Подтвердите, что вы владеете данными, и нажмите «Проверить доступ и обнаружить данные». Затем следуйте шагам мастера, описанным ниже.
Адрес аккаунта и токен хранятся в зашифрованном виде и удаляются при удалении записи миграции.
amoCRM не предоставляет доступ к диалогам через свой API. Мастер миграции отображает предупреждение об этом перед началом миграции.
Ошибки подключения
| Сообщение об ошибке | Что делать |
|---|---|
| Проверочный код не получен | Код отправляется на электронную почту, связанную с вашим аккаунтом amoCRM. Проверьте папку «Спам» или создайте интеграцию с помощью другой учетной записи администратора |
| «Адрес аккаунта должен быть доменом, например company.amocrm.ru, а не адресом электронной почты» | Введите домен, который отображается в адресной строке браузера, когда amoCRM открыт |
| «amoCRM отклонил токен» | Токен скопирован неправильно, истек или был отозван. Сгенерируйте новый |
| «Подписка amoCRM истекла» | Данные могут оставаться доступными в течение 30 дней после истечения срока. Продлите подписку или свяжитесь с amoCRM |
| «amoCRM заблокировал доступ» | В интеграции может отсутствовать разрешение «Доступ к данным аккаунта», или аккаунт может быть временно заблокирован из-за чрезмерного количества запросов. Проверьте доступ и попробуйте позже |
| «amoCRM не отвечает» или «amoCRM не смог найти…» | Проверьте адрес аккаунта и попробуйте снова |
Шаги мастера миграции
После подключения вашей CRM процесс миграции одинаков для Bitrix24 и amoCRM.
Никакие данные не записываются в Mavibot, пока вы не дойдете до шага «Миграция».
1. Сбор данных
Мастер получает данные из вашей предыдущей CRM и показывает, какой раздел обрабатывается в данный момент.
Вы можете закрыть страницу, пока сбор данных продолжается в фоновом режиме.
2. «Данные найдены»
Мастер отображает количество найденных воронок, сделок, контактов, компаний, задач, звонков и сотрудников.
Раздел «Что нужно проверить» показывает, какие данные не могут быть перенесены и почему, например, из-за отсутствующих разрешений вебхука.
3. Сопоставление
Настройте, как данные из вашей предыдущей CRM должны быть сопоставлены с Mavibot.
Воронки и этапы
Для каждой исходной воронки выберите существующую воронку Mavibot или выберите «Создать новую воронку».
Этапы с совпадающими названиями сопоставляются автоматически. Отсутствующие этапы создаются в том же порядке, что и в вашей предыдущей CRM.
Сотрудники
Сотрудники с совпадающими адресами электронной почты сопоставляются автоматически и помечаются как «Совпадение по электронной почте».
Для остальных выберите подходящего сотрудника или оставьте «Без назначения».
Поля в переменные
Выберите пользовательские поля, которые хотите перенести, и проверьте их ключи переменных.
Вы можете сразу использовать эти ключи переменных в ботах и кампаниях.
Что перенести
Настройте следующие параметры:
- Включить закрытые сделки.
- Импортировать только данные, созданные после указанной даты.
- Для Bitrix24 опционально включить неконвертированные лиды, диалоги открытых линий и файлы из диалогов.
Когда выбран фильтр по дате, все клиенты и компании импортируются, а сделки, задачи, комментарии, звонки и диалоги импортируются только с указанной даты.
Нажмите «Сохранить сопоставление», когда закончите.
4. «Просмотр»
Мастер рассчитывает, что произойдет во время миграции, без записи каких-либо данных.
Для каждой категории данных отображается:
- Будет создано — записи, которые будут добавлены.
- Уже существует — записи, уже найденные в Mavibot.
- Пропущено — записи, которые не могут быть импортированы.
Для клиентов «Уже существует» означает, что в Mavibot был найден совпадающий номер телефона или адрес электронной почты.
Вы можете изменить сопоставление и запустить просмотр снова.
5. «Миграция»
Миграция выполняется в фоновом режиме, поэтому вы можете закрыть страницу.
Кнопка «Стоп» прерывает процесс.
Уже импортированные записи остаются в Mavibot, и повторный запуск миграции продолжается без создания дубликатов.
6. Результаты миграции
На финальном экране отображается таблица с:
- Создано
- Уже существует
- Пропущено
Также включен список пропущенных записей с пояснениями.
Чтобы скачать полный отчет, нажмите «Скачать CSV-отчет».
Чтобы просмотреть импортированные записи, нажмите «Открыть CRM».
Импорт новых данных позже
Если ваша команда продолжает работать в предыдущей CRM, вы можете использовать «Перенести новые данные» для импорта последних изменений.
Новые записи будут добавлены, а ранее импортированные сделки получат обновленные этапы, суммы и назначенных сотрудников.
Кнопка «Обнаружить снова» только обновляет собранные данные, например, после добавления новых разрешений в вебхук.
Что не может быть перенесено
Любые данные, которые не могут быть импортированы, появляются в отчете миграции с указанием причины.
Следующие ограничения известны заранее:
- Диалоги amoCRM. amoCRM не предоставляет историю диалогов через свой API. Примечания, SMS-сообщения и звонки все еще могут быть импортированы.
- Файлы amoCRM. Примечания, содержащие файлы, импортируются с именем файла, но сами файлы остаются в amoCRM. Пользовательские поля типа «Файл» не могут быть импортированы ни из одной CRM.
- Пользовательские поля компаний. Mavibot хранит только название компании и реквизиты компании.
- Системная история amoCRM. Изменения этапов и сообщения, отправленные роботами автоматизации, не импортируются.
- Конвертированные лиды Bitrix24. Исходный лид пропускается, но сделка и контакт, созданные из этого лида, импортируются.
- Записи без корректной связи. Например, сделка, принадлежащая удаленной воронке, или задача, связанная с удаленной сделкой. Сделки без контактов не теряются: они связываются с профилем компании или профилем «Без контакта».
- Записи звонков. Импортируются только ссылки на записи в предыдущей CRM. Эти ссылки могут перестать работать после отключения старого портала или аккаунта.
Телефонные номера и адреса электронной почты
Первый телефонный номер и первый адрес электронной почты добавляются в основные поля профиля клиента.
Дополнительные телефонные номера, полные номера с добавочными, а также значения, не соответствующие стандартным форматам телефонов или электронной почты, сохраняются в переменных "Телефонные номера" и "Адреса электронной почты".
После миграции
Импортированные сделки появляются в ваших воронках Mavibot CRM.
История активности клиентов отображается в диалогах с клиентами, включая заметки, звонки и импортированные сообщения с их исходными датами.
Переменные профиля клиента содержат "Bitrix24 ID" или "amoCRM ID", а также дополнительную информацию, такую как:
- Источник
- Валюта
- Дата закрытия
- Причина проигранной сделки
- Теги
Внизу мастера миграции вы найдете список "Миграции".
В нем отображается статус каждой миграции и количество клиентов и сделок, импортированных в Mavibot.
Отключите вашу предыдущую CRM
После завершения миграции отзовите доступ к вашей предыдущей CRM.
Bitrix24
Удалите вебхук в разделе Разработчики → Интеграции.
amoCRM
Перейдите в amoMarket → Ваша интеграция → Отозвать доступ.
Mavibot
Вы можете нажать "Удалить миграцию", чтобы удалить URL вебхука или токен, а также собранные данные миграции.
Импортированные клиенты и сделки останутся в Mavibot.
Часто задаваемые вопросы
Могу ли я запустить миграцию снова?
Да. Используйте кнопку "Мигрировать новые данные".
Дубликаты записей не будут созданы. Ранее импортированные записи будут обновлены, а новые записи будут добавлены.
Клиент уже связался с нами через мессенджер. Будет ли создан дубликат профиля?
Нет.
Mavibot автоматически находит существующих клиентов с совпадающими телефонными номерами или адресами электронной почты.
Их существующие профили обновляются, а импортированные сделки привязываются к этим профилям.
Почему некоторым сделкам не назначены ответственные сотрудники?
Сотрудник может не быть сопоставлен, или у вебхука Bitrix24 может отсутствовать разрешение Пользователи.
Добавьте сотрудника в ваш проект Mavibot, выберите его в настройках сопоставления и нажмите "Мигрировать новые данные".
Ответственный сотрудник будет обновлен.
Где я могу увидеть, какие записи не были импортированы?
Откройте результаты миграции и просмотрите список пропущенных записей.
Вы также можете скачать CSV-отчет.
Каждая пропущенная запись содержит объяснение.
Будут ли запущены роботы и кампании CRM для импортированных сделок?
Нет.
Миграция выполняется в фоновом режиме. Автоматизации CRM, боты и кампании не запускаются, и клиенты не получают никаких сообщений.
Что если я мигрировал данные в неправильный проект? Могу ли я отменить это?
Автоматического отката нет.
Импортированные клиенты и сделки остаются в Mavibot даже после нажатия "Удалить миграцию".
Перед началом убедитесь, что вы выбрали правильный проект, и внимательно просмотрите результаты на шаге "Проверка".