Интеграция

Сбор почты через IMAP → Создание заказа в RetailCRM

В этой инструкции мы по шагам с примерами разберём, как настроить оба сервиса и связать их между собой:

Настройка сбора почты через IMAP: сервер, порт и шифрование, логин и пароль ящика, каталог писем для регулярного опроса.
Настройка создания заказа в RetailCRM через HTTP: домен аккаунта, ключ API и JSON с именем, телефоном и другими полями заказа из сценария.

Создайте обработку

В левом меню откройте «Обработки» и нажмите «+».

В списке типов источника выберите «Сбор почты через IMAP» и нажмите кнопку «Выбрать».

Письма из выбранного каталога почтового ящика начнут поступать по расписанию опроса. Укажите сервер IMAP, порт, шифрование, логин, пароль и каталог.

Заполните поля «Сервер», «Порт» и «Шифрование».
Укажите «Логин» и «Пароль» почтового ящика.
В поле «Каталог» укажите папку, из которой нужно получать письма (обычно INBOX).
Нажмите «Сохранить».

В RetailCRM создаётся заказ через HTTP-запрос к API. Укажите домен аккаунта, ключ API и JSON с именем и телефоном клиента.

Перейдите в обработке во вкладку "Действия" и нажмите на кнопку "Добавить действие"

Действие настраивается через «HTTP-запрос». Список полей заказа есть в документации API v5.

Выберите «HTTP-запрос» и нажмите «Выбрать».
В поле «HTTP-метод» выберите POST.
В поле «Адрес» укажите https://ваш-домен.retailcrm.ru/api/v5/orders/create.
В блоке «Параметры» добавьте apiKey со значением ключа API.
В «Заголовки» добавьте Content-Type со значением application/json.
В поле «Тело» нажмите «Фн», выберите «Компоновщик JSON» и передайте как минимум firstName и phone.
Нажмите «Сохранить».