Интеграция
Получение заявок с сайта на Craftum → Создание заказа в RetailCRM
В этой инструкции мы по шагам с примерами разберём, как настроить оба сервиса и связать их между собой:
- Настройка приёма заявок с Craftum: выбор источника по имени, поля формы и установка скрипта «Форма на сайте» в код страниц.
- Настройка создания заказа в RetailCRM через HTTP: домен аккаунта, ключ API и JSON с именем, телефоном и другими полями заказа из сценария.
Отдельные инструкции: источник «Получение заявок с сайта на Craftum» · действие «Создание заказа в RetailCRM»
Не хотите настраивать сами? Сделаем бесплатно
Напишите, какие сервисы нужно связать. Специалист настроит интеграцию, проверит, что данные доходят, и оставит вам готовый процесс.
Создайте обработку
В левом меню откройте «Обработки» и нажмите «+».
Источник «Craftum»
Заявки из форм Craftum начнут поступать после выбора «Craftum» в списке источников. Укажите поля формы и вставьте скрипт в код сайта.
Выбор типа источника
- В списке типов источника выберите «Craftum» и нажмите «Выбрать».
Поля и сохранение
- Укажите название источника, добавьте поля формы и нажмите «Сохранить».
Скрипт
- Откройте вкладку «Источник данных» и скопируйте «Скрипт».
Код на сайте Craftum
- Откройте настройки выбранного сайта.
- Откройте «HTML» и в блоке пользовательского HTML перед
</body>нажмите «Добавить код».
- Вставьте скопированный «Скрипт», нажмите «Сохранить изменения», затем «Обновить все страницы».
Если заявка не приходит
- Скрипт должен стоять перед
</body>и страницы нужно обновить после сохранения. - Названия в блоке «Поля» должны совпадать с атрибутом name у полей формы.
Действие «RetailCRM»
В RetailCRM создаётся заказ через HTTP-запрос к API. Укажите домен аккаунта, ключ API и JSON с именем и телефоном клиента.
Перейдите в обработке во вкладку "Действия" и нажмите на кнопку "Добавить действие"
Ключ API
- В RetailCRM откройте раздел «Интеграция».
- Перейдите во вкладку «Ключи доступа к API» и скопируйте ключ.
Параметры запроса
Действие настраивается через «HTTP-запрос». Список полей заказа есть в документации API v5.
- Выберите «HTTP-запрос» и нажмите «Выбрать».
- В поле «HTTP-метод» выберите
POST. - В поле «Адрес» укажите
https://ваш-домен.retailcrm.ru/api/v5/orders/create. - В блоке «Параметры» добавьте
apiKeyсо значением ключа API. - В «Заголовки» добавьте
Content-Typeсо значениемapplication/json. - В поле «Тело» нажмите «Фн», выберите «Компоновщик JSON» и передайте как минимум
firstNameиphone.
- Нажмите «Сохранить».
Запустите обработку
- В обработку начнут поступать данные из настроенного источника.
- По очереди выполнятся все добавленные действия.
- Входящие данные, статус и история отобразятся в «Истории операций».
Застряли на подключении или полях?
Соберём обработку «Получение заявок с сайта на Craftum → Создание заказа в RetailCRM», проверим тест и запустим.