Статья описывает, как подключить входящий вебхук к проекту в vivaVision: настроить маппинг полей, задать роутинг сделок по значению и получить готовый URL для интеграции.

:::callout{type="info"}
Интеграция WebHook позволяет автоматически создавать сделки в нужном статусе при получении POST-запроса от внешней системы.

:::

## Открытие настроек интеграции

:::step
В левом меню нажмите на название нужного проекта, чтобы открыть его настройки.

![Шаг 1](https://2a54f57b-f328-4b00-8f83-049bef127c91.selstorage.ru/824e139d-cb7e-4630-9a00-36dbb28e16f7)

:::

:::step
В настройках проекта перейдите на вкладку [[Интеграция]].

![Шаг 2](https://2a54f57b-f328-4b00-8f83-049bef127c91.selstorage.ru/1a9efd8b-2cfd-4a87-837d-85f886f007c6)

:::

:::step
Нажмите на стрелку рядом с пунктом **Интеграция Вебхук**, чтобы развернуть блок настроек.

![Шаг 3](https://2a54f57b-f328-4b00-8f83-049bef127c91.selstorage.ru/e3423396-b16f-4f22-bce9-3e59fde1e89e)

:::

## Основные параметры

:::step
Укажите статус, в который будут создаваться новые сделки, поступающие через вебхук. Нажмите на поле [[Статус по умолчанию]] и выберите нужный вариант из списка.

![Шаг 4](https://2a54f57b-f328-4b00-8f83-049bef127c91.selstorage.ru/0c639652-40c9-4552-831e-f2919770ebfc)

:::

:::step
Укажите действие, которое будет присваиваться сделке при срабатывании вебхука. Это поле определяет тип ожидаемого действия от клиента.

![Шаг 6](https://2a54f57b-f328-4b00-8f83-049bef127c91.selstorage.ru/81a698e5-d9dd-48f7-8d7a-34af7ff37c58)

:::callout{type="tip"}
Поле необязательно — можно оставить значение **Без действия**.

:::

:::

:::

## Маппинг входящих полей

В блоке [[Маппинг входящих полей]] вы определяете, как данные из входящего payload будут сохраняться в карточке сделки.

![Шаг 9](https://2a54f57b-f328-4b00-8f83-049bef127c91.selstorage.ru/a96e3e5d-5229-48f6-8c11-8bb698300092)

:::step
Нажмите **Добавить поле** и введите название параметра из входящего payload — например, `name`. Это имя вы задаёте самостоятельно и будете использовать его при отправке запроса.

![Шаг 10](https://2a54f57b-f328-4b00-8f83-049bef127c91.selstorage.ru/f83aa231-bba7-47ab-952f-82e8c3276acd)

:::

:::step
В поле [[Тип значения]] выберите, куда будут сохраняться данные. Доступные варианты:

| Тип                        | Описание                         |
| -------------------------- | -------------------------------- |
| **Поле тикета**            | Стандартное поле карточки сделки |
| **Телефон клиента**        | Номер телефона                   |
| **Кастомные поля**         | Дополнительные поля проекта      |
| **Маркетинговое значение** | Метка для аналитики              |
| **Игнорировать**           | Значение не сохраняется          |

Для параметра `name` выберите **Поле тикета**.

![Шаг 11](https://2a54f57b-f328-4b00-8f83-049bef127c91.selstorage.ru/7671af6e-e598-4429-b2ba-93ab8e950ae8)

:::

:::step
После выбора типа **Поле тикета** появится дополнительный список. Выберите, куда именно сохранять значение — например, [[Название (name)]], чтобы параметр `name` записывался в название задачи.

![Шаг 14](https://2a54f57b-f328-4b00-8f83-049bef127c91.selstorage.ru/9fe8a473-62ee-486c-8214-94335002da3c)

:::

## Роутинг по значению поля

Роутинг позволяет направлять сделку в разные статусы в зависимости от значения одного из входящих параметров. Это необязательный блок — настраивайте его, только если нужна такая логика.

:::step
В блоке [[Роутинг по значению поля]] выберите поле из маппинга, которое будет использоваться как условие — например, `name`.

![Шаг 16](https://2a54f57b-f328-4b00-8f83-049bef127c91.selstorage.ru/26b4624e-acbe-473f-ac89-3b5faf06b173)

:::

:::step
Нажмите **Добавить правило**. Введите значение поля-роутера, при котором должно срабатывать правило, и выберите статус назначения.

![Шаг 18](https://2a54f57b-f328-4b00-8f83-049bef127c91.selstorage.ru/58f30bc5-8848-4265-ae9f-6425868e25a2)

Например: если в параметре `name` придёт значение `Пробное занятие` — сделка будет направлена в статус **Черновик**.

![Шаг 22](https://2a54f57b-f328-4b00-8f83-049bef127c91.selstorage.ru/8d5949a4-a116-4f60-93a9-0a1ab614d2bb)

:::

## Включение интеграции и получение URL

:::step
Нажмите кнопку **Включить интеграцию**. Система автоматически сформирует адрес вебхука.

![Шаг 23](https://2a54f57b-f328-4b00-8f83-049bef127c91.selstorage.ru/bae2de09-8498-44b8-8a06-56f70b6d75ac)

:::

:::step
Нажмите кнопку копирования рядом с полем [[Webhook URL]]. Этот адрес используется как точка приёма запросов во внешней системе.

:::callout{type="info"}
Метод запроса — **POST**.

:::

:::

![Шаг 24](https://2a54f57b-f328-4b00-8f83-049bef127c91.selstorage.ru/d1d40c17-fe25-4af3-99bb-197cdd545b4c)

\
:::

По желанию скопируйте пример запроса из блока [[Пример запроса]] — он поможет протестировать интеграцию.

![Шаг 25](https://2a54f57b-f328-4b00-8f83-049bef127c91.selstorage.ru/ea8afd87-e310-4d32-b587-dfdf531335f6)

:::step
Нажмите **Сохранить**, чтобы применить все настройки интеграции.

![Шаг 26](https://2a54f57b-f328-4b00-8f83-049bef127c91.selstorage.ru/2d184c6d-6660-40f3-91f1-afde270093c5)

:::