В данной статье покажем, как можно обогатить информацию о карточке компании amoCRM с помощью запросов к сервису Контур.Фокус, имея ИНН компании.
Содержание
Подключение сервиса Контур.Фокус в Morekit.
Получение API-ключа Контур.Фокус
Для начала — необходимо подключить сервис в MoreKit. Для авторизации сервиса потребуется получить API ключ сервиса Контур.Фокус.
Для этого переходим по данной ссылке и оставляем заявку на доступ к API.
После того, как получите API ключ — можно приступить к добавлению сервиса в MoreKit
Авторизация процесса в MoreKit
Будет предложено ввести API ключ, который был получен в результате подачи заявки на доступ к API
Если все сделано верно — Контур.Фокус появится в списке сервисов
Подключение сервиса amoCRM в MoreKit
По аналогии, ищем в списке сервисов amoCRM, нажимаем на кнопку Добавить, произойдет перенаправление на страницу переадресации amoCRM, где необходимо выбрать нужную CRM, которую надо подключить в MoreKit
После авторизации сервисов можно приступить к настройке процесса. Следующие шаги описывают процесс создания процесса в Morekit, настройки события, по которому будет запущен процесс в MoreKit из amoCRM, а также показывают алгоритм настройки блок-схемы
Установка webhook в amoCRM и создание процесса
Перед настройкой webhook на стороне amoCRM необходимо создать процесс, чтобы получить URL для нашего webhook. Создаем наш процесс. Тип процесса — amoCRM вебхук
В качестве события, которое будет запускать процесс в MoreKit — будет поле с типом флаг. При активации данного поля менеджером процесс отработает и автоматически выключит флаг.
Если вы создали новое поле уже после того, как добавили amoCRM в MoreKit, то необходимо перейти в карточку сервиса и нажать Обновить, чтобы MoreKit подтянул актуальные поля из crm системы
Для установки хука необходимо перейти в amoМаркет. Справа сверху будет кнопка установки web hooks. Ставим событие Компания изменена
Выстраивание логической схемы
Выстраиваем логическую схему в MoreKit
Описание блоков схемы
Первоначальный блок — в нем устанавливается фильтр, по которому процесс будет запускаться. Данный фильтр настроен таким образом, что процесс будет запускаться только тогда, когда флаг «Актуализировать компанию» будет активен
#10 — поиск компании по ID из входящих данных
#6 Базовые реквизиты — поиск базовых реквизитов компании по ИНН из блока поиска компании
#7 Получение расширенной аналитики по ИНН из блока компании
#8 Экспресс отчет — получение отчета по контрагенту по ИНН из компании
#9 создать переменную — запись значений в переменную для удобства подстановки значений
#12 Дата и время — конвертация даты под нужный формат для amoCRM. Дата со стороны фокуса приходит нам в формате Y-m-d, но для передачи ее в amoCRM необходимо привести к формату %Y-%m-%dT%H:%M:%S%z
#11 Обновить компанию — заполнение полей в карточке компании. В данном блоке происходит основная операция по заполнению данных. Важный момент — не забыть поставить значение флага, который запускает процесс на 0
тестирование процесса
После выстраивания схемы можно приступать к тестированию процесса. Заполняем ИНН компании и активируем флаг
После сохранения активации флага — видим что в ранее пустые поля подтянулись актуальные данные из фокуса
В логе событий MoreKit также ошибок нет. Все прошло успешно !
Тестирование процесса
В данной статье рассмотрели, как можно достать актуальную информацию о компании с помощью сервиса Контур.Фокус, выстроили логическую блок-схему, успешно получили данные по активации флагового поля