Интеграция
Получение данных из Яндекс Форм → Создание заказа в RetailCRM
В этой инструкции мы по шагам с примерами разберём, как настроить оба сервиса и связать их между собой:
- Получение данных из Яндекс Форм: HTTP-источник, копирование URL, настройка API-запроса в форме и получение параметров из тестового ответа.
- Настройка создания заказа в RetailCRM через HTTP: домен аккаунта, ключ API и JSON с именем, телефоном и другими полями заказа из сценария.
Отдельные инструкции: источник «Получение данных из Яндекс Форм» · действие «Создание заказа в RetailCRM»
Создайте обработку
В левом меню откройте «Обработки» и нажмите «+».
В списке типов источника выберите «Яндекс.Формы» и нажмите кнопку «Выбрать».
Источник «Яндекс.Формы»
Настроите приём ответов из Яндекс.Форм через HTTP-источник: скопируете URL, укажете его в интеграции формы и получите параметры полей из тестового ответа.
Выберите тип источника
В списке типов источника выберите «HTTP» и нажмите «Выбрать», затем «Сохранить».
Скопируйте URL вебхука
Откройте вкладку «Источник данных» и скопируйте URL - он понадобится в настройках Яндекс.Форм.
Настройте интеграцию в Яндекс.Формах
- Откройте нужную форму в Яндекс.Формах.
- Перейдите на вкладку «Интеграция».
- Нажмите «Добавить группу действий», выберите «API», затем «Запрос заданным методом».
- В поле «URL» вставьте скопированную ссылку.
- Выберите метод «POST».
- В тело запроса добавьте параметры, которые нужно получать.
- Добавьте заголовок
Content-Type: application/x-www-form-urlencoded. - Нажмите «Сохранить».
Получите параметры из тестового ответа
- Отправьте тестовую заявку: заполните и отправьте Яндекс.Форму.
- Вернитесь к источнику, откройте вкладку «Источник данных» и нажмите на изображение карандаша рядом с «Настройки».
- Нажмите «Получить параметры из последнего запроса», дождитесь загрузки и нажмите «Сохранить».
Действие «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.
- Нажмите «Сохранить».
Запустите обработку
- В обработку начнут поступать данные из настроенного источника.
- По очереди выполнятся все добавленные действия.
- Входящие данные, статус и история отобразятся в «Истории операций».