WebJack
Вход Начать
Получение заявок из YClients Создание контакта и сделки в S2 (Salesap)

Интеграция

Получение заявок из YClients → Создание контакта и сделки в S2 (Salesap)

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

  1. Настройка приёма заявок из YClients: HTTP-источник с URL вебхука, непубличное приложение в кабинете разработчика и установка в филиал.
  2. Создание контакта и сделки в Salesap через HTTP POST на api.salesap.ru: сначала JSON контакта, затем запрос сделки с ID из предыдущего шага.

Отдельные инструкции: источник «Получение заявок из YClients» · действие «Создание контакта и сделки в S2 (Salesap)»

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

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

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

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

Источник «YClients»

Заявки и уведомления из YClients начнут приходить на URL HTTP-источника. Создайте HTTP-источник, скопируйте URL и укажите его в приложении маркетплейса YClients.

Выбор типа источника

  1. Отметьте «HTTP» и нажмите «Выбрать».
    Получение заявок из YClients: Отметьте «HTTP» и нажмите «Выбрать»

URL приёма

  1. Не меняя параметры, нажмите «Сохранить».
    Получение заявок из YClients: Не меняя параметры, нажмите «Сохранить»
  2. Откройте вкладку «Источник данных» и скопируйте «URL».
    Получение заявок из YClients: Откройте вкладку «Источник данных» и скопируйте «URL»

Приложение в YClients

  1. Откройте кабинет разработчика маркетплейса YClients и создайте личный кабинет.
  2. Заполните поля и нажмите «Зарегистрироваться».
    Получение заявок из YClients: Заполните поля и нажмите «Зарегистрироваться»
  3. Нажмите «Создать приложение».
    Получение заявок из YClients: Нажмите «Создать приложение»
  4. Выберите тип «Непубличное» и нажмите «Далее».
    Получение заявок из YClients: Выберите тип «Непубличное» и нажмите «Далее»
  1. В разделе «Мои приложения» нажмите «Управление» на карточке приложения.
    Получение заявок из YClients: В разделе «Мои приложения» нажмите «Управление» на карточке приложения
  2. В «Настройки подключения» в поле «Адрес, на который отправлять уведомления» вставьте скопированный «URL» и нажмите «Сохранить».
    Получение заявок из YClients: В «Настройки подключения» в поле «Адрес, на который отправлять уведомления» вставьте скопированный «URL» и нажмите «Сохранить»
  3. В «Общая информация» скопируйте «Ссылка на приложение».
    Получение заявок из YClients: В «Общая информация» скопируйте «Ссылка на приложение»
  4. Откройте ссылку в браузере и нажмите «Подключить».
    Получение заявок из YClients: Откройте ссылку в браузере и нажмите «Подключить»
  5. Нажмите «Продолжить» - в выбранном филиале будут установлены вебхуки.
    Получение заявок из YClients: Нажмите «Продолжить» - в выбранном филиале будут установлены вебхуки

Действие «S2. Создание контакта и сделки»

Salesap API создаёт контакт и сделку отдельными запросами. Сначала POST контакта, затем POST сделки с привязкой к созданному контакту.

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

API Salesap

  1. В кабинете Salesap получите доступ к API https://api.salesap.ru/.
  2. Создайте первое действие «HTTP-запрос» для создания контакта JSON.

Параметры запроса

Действие настраивается через «HTTP-запрос».

  1. Выберите «HTTP-запрос» и нажмите «Выбрать».
    Выберите «HTTP-запрос» и нажмите «Выбрать»
  2. В первом запросе выберите POST на endpoint контактов Salesap.
  3. В «Тело» через «Компоновщик JSON» передайте поля контакта.
  4. Создайте второе действие «HTTP-запрос» для создания сделки.
  5. Во втором запросе передайте ID контакта из ответа первого шага и поля сделки.
  6. Нажмите «Сохранить».

Запустите обработку

  1. В обработку начнут поступать данные из настроенного источника.
  2. По очереди выполнятся все добавленные действия.
  3. Входящие данные, статус и история отобразятся в «Истории операций».

integrations: Входящие данные, статус и история отобразятся в «Истории операций»