Статья описывает, как подключить входящий вебхук к проекту в vivaVision: настроить маппинг полей, задать роутинг сделок по значению и получить готовый URL для интеграции.
Интеграция WebHook позволяет автоматически создавать сделки в нужном статусе при получении POST-запроса от внешней системы.
Открытие настроек интеграции
В левом меню нажмите на название нужного проекта, чтобы открыть его настройки.
В настройках проекта перейдите на вкладку Интеграция.
Нажмите на стрелку рядом с пунктом Интеграция Вебхук, чтобы развернуть блок настроек.
Основные параметры
Укажите статус, в который будут создаваться новые сделки, поступающие через вебхук. Нажмите на поле Статус по умолчанию и выберите нужный вариант из списка.
Укажите действие, которое будет присваиваться сделке при срабатывании вебхука. Это поле определяет тип ожидаемого действия от клиента.
:::
Маппинг входящих полей
В блоке Маппинг входящих полей вы определяете, как данные из входящего payload будут сохраняться в карточке сделки.
Нажмите Добавить поле и введите название параметра из входящего payload — например, name. Это имя вы задаёте самостоятельно и будете использовать его при отправке запроса.
В поле Тип значения выберите, куда будут сохраняться данные. Доступные варианты:
| Тип | Описание |
|---|---|
| Поле тикета | Стандартное поле карточки сделки |
| Телефон клиента | Номер телефона |
| Кастомные поля | Дополнительные поля проекта |
| Маркетинговое значение | Метка для аналитики |
| Игнорировать | Значение не сохраняется |
Для параметра name выберите Поле тикета.
После выбора типа Поле тикета появится дополнительный список. Выберите, куда именно сохранять значение — например, Название (name), чтобы параметр name записывался в название задачи.
Роутинг по значению поля
Роутинг позволяет направлять сделку в разные статусы в зависимости от значения одного из входящих параметров. Это необязательный блок — настраивайте его, только если нужна такая логика.
В блоке Роутинг по значению поля выберите поле из маппинга, которое будет использоваться как условие — например, name.
Нажмите Добавить правило. Введите значение поля-роутера, при котором должно срабатывать правило, и выберите статус назначения.
Например: если в параметре name придёт значение Пробное занятие — сделка будет направлена в статус Черновик.
Включение интеграции и получение URL
Нажмите кнопку Включить интеграцию. Система автоматически сформирует адрес вебхука.
Нажмите кнопку копирования рядом с полем Webhook URL. Этот адрес используется как точка приёма запросов во внешней системе.
:::
По желанию скопируйте пример запроса из блока Пример запроса — он поможет протестировать интеграцию.
Нажмите Сохранить, чтобы применить все настройки интеграции.