Коннектор OkoCRM: инструкция
Решение связывает OkoCRM и МойСклад. Сделка, дошедшая до выбранного этапа воронки, создает в МоемСкладе контрагента и заказ покупателя. Когда вы меняете статус этого заказа, сделка в OkoCRM переезжает на этап, указанный в настройках.
Что нужно до начала
- Аккаунт OkoCRM с настроенной воронкой продаж.
- Тариф МоегоСклада с поддержкой вебхуков: любой платный или пробный. На бесплатном тарифе МойСклад не отправляет уведомления об изменениях документов, поэтому направление из МоегоСклада в OkoCRM работать не будет.
- Права в МоемСкладе на контрагентов, юрлица и заказы покупателей. Они запрашиваются при установке решения, отдельно настраивать ничего не нужно.
Шаг 1. Установка
Установите решение из каталога решений МоегоСклада. После установки откройте его: раздел Решения, карточка решения, кнопка Перейти в решение.
Откроется окно настройки внутри МоегоСклада. Никаких паролей вводить не нужно: решение узнает вас по учетной записи МоегоСклада.
Шаг 2. Подключение OkoCRM
В окне решения найдите поле API токен OkoCRM.
Токен берется в OkoCRM: профиль пользователя, графа Токен для API.
Вставьте токен и нажмите Подключить. Токен сохраняется только после успешной проверки связи: если OkoCRM его не приняла, вы увидите сообщение с причиной. Сохраненный токен шифруется.
После подключения индикатор OkoCRM станет зеленым, и откроется доступ к правилам синхронизации.
Шаг 3. Правила синхронизации
Настройки находятся в том же окне, в карточке Правила синхронизации.
Воронка и этап-триггер
Выберите воронку, сделки которой должны попадать в МойСклад, и этап, при достижении которого создается заказ. Обычно это этап вида Счет оплачен или Согласовано. Сделки на других этапах коннектор не трогает.
Соответствие статусов
Таблица для обратного направления. Слева перечислены статусы заказа покупателя из вашего аккаунта, справа выбирается этап сделки. Например:
| Статус заказа в МоемСкладе | Этап сделки в OkoCRM |
|---|---|
| Отгружен | Успешно реализовано |
| Отменен | Закрыто и не реализовано |
Строки со значением не переводить оставляют сделку на месте. Это обычный способ настроить реакцию только на важные статусы.
Поля контакта
Чем заполнять карточку контрагента при создании. По умолчанию переносятся имя, телефон и почта, даже если ни одной строки не добавлено. Дополнительные строки позволяют перенести другие поля, включая дополнительные поля обеих систем.
Выключатель синхронизации
Пока он выключен, коннектор ничего не создает и не меняет, но записывает в журнал, что он нашел бы. Удобно посмотреть на поведение до запуска.
Нажмите Сохранить правила.
Шаг 4. Проверка
- Создайте в OkoCRM тестовую сделку и привяжите к ней контакт с телефоном и почтой.
- Переведите сделку на этап-триггер.
- В течение минуты в МоемСкладе появятся контрагент и заказ покупателя. В комментарии заказа будут номер сделки и ее сумма.
- Смените статус заказа на тот, для которого настроено соответствие, и сохраните заказ.
- Сделка в OkoCRM переедет на указанный этап.
Журнал синхронизаций
Внизу окна решения есть журнал. В нем видно каждое событие: направление обмена, результат и краткое описание. Записи фильтруются по статусу и направлению.
| Статус записи | Что означает |
|---|---|
| успешно | действие выполнено |
| пропущено | коннектор осознанно ничего не сделал, причина указана рядом: например, заказ по этой сделке уже создан или для статуса не настроен этап |
| ошибка | действие не удалось, показывается полный текст ошибки |
Частые вопросы
- Почему в заказе нет товарных позиций?
- В сделке OkoCRM товарных позиций нет, есть только сумма, а МойСклад считает сумму заказа по позициям. Поэтому заказ создается с контрагентом и комментарием, в котором указана сумма сделки, а позиции добавляются уже в МоемСкладе.
- Создаст ли коннектор второй заказ по той же сделке?
- Нет. Связь сделки и заказа сохраняется, повторная обработка исключается независимо от того, сколько раз сделка попадет в выборку.
- Что будет, если клиент уже есть в справочнике контрагентов?
- Коннектор найдет его по почте, затем по телефону, и привяжет заказ к существующему контрагенту. Данные найденного контрагента не перезаписываются.
- Заказ изменил я сам, сделка переедет?
- Да, если для нового статуса заказа настроено соответствие. Изменения, которые сделал сам коннектор, ответной синхронизации не вызывают.
- Как временно остановить обмен?
- Снимите галочку Синхронизация включена и сохраните правила. Настройки при этом сохранятся.
- Как отключить OkoCRM?
- В карточке подключений нажмите Отключить. Токен будет удален из хранилища.
Поддержка
Вопросы и сообщения об ошибках: dentrancer@mail.ru. Если речь об ошибке, укажите время события и его описание из журнала синхронизаций, это ускорит разбор.