Подключение webHook интеграции для появления сделок
Статья описывает, как подключить входящий вебхук к проекту в vivaVision: настроить маппинг полей, задать роутинг сделок
по значению и получить готовый URL для интеграции.
Интеграция WebHook позволяет автоматически создавать сделки в нужном статусе при получении
POST-запроса от внешней системы.
Открытие настроек интеграции
В левом меню нажмите на название нужного проекта, чтобы открыть его настройки.
Шаг 1
В настройках проекта перейдите на вкладку Интеграция.
Шаг 2
Нажмите на стрелку рядом с пунктом Интеграция Вебхук, чтобы развернуть блок настроек.
Шаг 3
Основные параметры
Укажите статус, в который будут создаваться новые сделки, поступающие через вебхук. Нажмите на поле [[Статус по
умолчанию]] и выберите нужный вариант из списка.
Шаг 4
Укажите действие, которое будет присваиваться сделке при срабатывании вебхука. Это поле определяет тип
ожидаемого действия от клиента.
Шаг 6
Поле необязательно — можно оставить значение Без действия.
Маппинг входящих полей
В блоке Маппинг входящих полей вы определяете, как данные из входящего payload будут сохраняться в карточке сделки.
Шаг 9
Нажмите Добавить поле и введите название параметра из входящего payload — например, name. Это имя вы задаёте
самостоятельно и будете использовать его при отправке запроса.
Шаг 10
В поле Тип значения выберите, куда будут сохраняться данные. Доступные варианты:
| Тип | Описание | | -------------------------- | -------------------------------- | | Поле тикета | Стандартное поле
карточки сделки | | Телефон клиента | Номер телефона | | Кастомные поля | Дополнительные поля проекта | |
Маркетинговое значение | Метка для аналитики | | Игнорировать | Значение не сохраняется |
Для параметра name выберите Поле тикета.
Шаг 11
После выбора типа Поле тикета появится дополнительный список. Выберите, куда именно сохранять значение —
например, Название (name), чтобы параметр name записывался в название задачи.
Шаг 14
Роутинг по значению поля
Роутинг позволяет направлять сделку в разные статусы в зависимости от значения одного из входящих параметров. Это
необязательный блок — настраивайте его, только если нужна такая логика.
В блоке Роутинг по значению поля выберите поле из маппинга, которое будет использоваться как условие —
например, name.
Шаг 16
Нажмите Добавить правило. Введите значение поля-роутера, при котором должно срабатывать правило, и выберите
статус назначения.
Шаг 18
Например: если в параметре name придёт значение Пробное занятие — сделка будет направлена в статус Черновик.
Шаг 22
Включение интеграции и получение URL
Нажмите кнопку Включить интеграцию. Система автоматически сформирует адрес вебхука.
Шаг 23
Нажмите кнопку копирования рядом с полем Webhook URL. Этот адрес используется как точка приёма запросов во
внешней системе.
Метод запроса — POST.
Шаг 24
По желанию скопируйте пример запроса из блока Пример запроса — он поможет протестировать интеграцию.
Шаг 25
Нажмите Сохранить, чтобы применить все настройки интеграции.
Шаг 26
