> Усі статті WIKI Helomi: /wiki/llms.txt

# Вебхуки

Вхідний вебхук — адреса, на яку сторонній сервіс (сайт на WooCommerce, форма Contact Form 7, Weblium, WIX, Facebook Leads) надсилає заявку чи замовлення, а Helomi сам створює з неї контрагента, угоду й завдання за вашим мапінгом полів. Вихідні вебхуки — навпаки, Helomi шле дані в інший сервіс; вони налаштовуються тригерами.

## Можливості
- Шаблони: «Webhook без налаштувань», «WooCommerce (кошик)», «WordPress (Contact Form 7)», «Weblium (форми)», «Weblium (кошик)», «Facebook Leads (Apix-Drive)», «WIX (форми)».
- Свій URL на кожен вебхук; ключ — токен в адресі.
- Мапінг змінних запиту в поля контрагента, угоди (з товарами) і завдання, у тому числі в додаткові поля.
- Захист від дубля угоди за ID замовлення.
- «Історія запитів»: що прийшло, що створено, чому не створено; повторна обробка після виправлення мапінгу.

## 1. Налаштування
«Налаштування → Автоматизація → Вхідні вебхуки» — відкриває «Інтеграції → Webhook». Бачить сторінку людина з доступом «Інтеграції»; створює й змінює вебхуки адміністратор або людина з «Налаштування CRM».

Сайти, підключені як окремі акаунти в «Інтеграції → Сайти», мають власну адресу «Вебхук url» і вкладку «Поля» в картці сайту — стаття «Сайти». Вхідні вебхуки тут — для будь-якого іншого сервісу.

## 2. Створити вхідний вебхук
1. «+ Новий вебхук» → виберіть шаблон сервісу або «Webhook без налаштувань».
2. Відкриється картка вебхука: назва, «шаблон: …», перемикач «Приймає запити», рядок «URL вебхука:» з кнопкою копіювання.
3. Скопіюйте URL і вставте його в налаштуваннях сервісу (у WooCommerce — Webhooks, у формі — адреса відправки).
4. Перевірте блоки мапінгу (розділ 3) і натисніть «Зберегти».
5. Надішліть тестову заявку з сервісу (заповніть форму як клієнт) — вона з'явиться в «Історії запитів».

Якщо в налаштуваннях вебхука чогось бракує, над блоками з'являться попередження червоною крапкою.

## 3. Мапінг: контрагент, угода, товари, завдання
Кожен блок — таблиця «Змінна запиту» → «Поле CRM». Змінні пишуться як `a.b`, `a[].b`, `a[1].b`, `$.x`, сталий текст — `/текст/`, кілька змінних разом — `{{a}} {{b}}`.
- **«Контрагент»** — створюється завжди; обов'язково заповнити «Назва компанії» або «Контактна особа». Тут же — тип (лід чи клієнт), відповідальний, джерело, статус, теги.
- **«Створювати угоду»** — галочка; обов'язково «Назва угоди». Воронка й етап, «ID замовлення» (не дасть створити дубль), додаткові поля угоди.
- **«Товари»** — масив товарів у запиті і чотири змінні елемента: назва, кількість, ціна, артикул. Артикул шукається на складі.
- **«Створювати завдання»** — галочка; обов'язково «Назва завдання». Чітка назва для всіх — `/Передзвонити/`.

Унизу — «Зберегти», «Скасувати зміни» і «є незбережені зміни», якщо ви ще не зберегли.

## 4. Перевірити на справжньому запиті
Блок «Історія запитів» — «Дата», «Результат», «Що сталось», «Тіло». У рядку запиту:
- «Змінні» — показує всі змінні з прикладами значень; клік по змінній вставляє її в рядок мапінгу;
- «Перевірити мапінг» — що вийде з цього запиту за поточним мапінгом, нічого не створюючи;
- «Обробити ще раз» — створити записи з цього запиту після виправлення мапінгу.

Якщо запит не пройшов, нічого не створюється, а причина видно в «Що сталось». Сервісу Helomi відповідає успіхом навіть на помилку мапінгу, щоб WooCommerce не вимкнув вебхук.

## 5. Нова адреса, вимкнути, видалити
- «Нова адреса» — новий токен; стара адреса перестає працювати.
- Перемикач «Приймає запити» / «Вимкнено».
- «Видалити вебхук» прибирає профіль; створені ним клієнти, угоди й завдання лишаються.

## 6. Вихідні вебхуки
Щоб Helomi сам надсилав дані назовні (нова угода → Telegram, етап → SMS, рух товару → сайт), створіть тригер: «Налаштування → Автоматизація → Тригери (Webhook)» — стаття «Тригери».

## Можливі помилки
| Що ви бачите | Чому | Що зробити |
| --- | --- | --- |
| «Контрагент: не налаштовано поле «Назва компанії» або «Контактна особа» — без нього нічого не створиться» | Немає рядка для назви чи особи | Додайте змінну для одного з полів |
| «Угода: не налаштовано поле «Назва угоди»» / «Завдання: не налаштовано поле «Назва завдання»» | Увімкнено блок без назви | Додайте змінну або сталий текст `/…/` |
| «не заповнено «Назва компанії / Контактна особа» — перевірте змінні контрагента» | У запиті нема даних за вказаною змінною | «Змінні» → виберіть правильну |
| «поле «…» — цифрове, а прийшло …» / «— Так/Ні…» / «— дата…» | Значення не того типу | Змініть мапінг або тип поля |
| «external_uid «…» вже зайнятий — угода #… уже створена раніше» | Повторне замовлення з тим самим ID | Нічого: дубль не створено |
| «додаткового поля «…» нема — оновіть мапінг» | Поле видалили | Виберіть інше поле |
| «етапу «…» нема» / «етапу #… нема — оновіть налаштування угоди» | Етап видалено чи змінено | Виберіть етап знову |
| «Змінювати вебхуки може адміністратор або хто має «Налаштування CRM»» | Немає прав | Попросіть адміністратора |

## Для ШІ-співробітників
Інструментів для вебхуків нема — їх налаштовує людина. Угоди й клієнти, створені вебхуком, ви бачите й змінюєте звичайними `deals_*` і `clients_*`; джерело в такій угоді може бути заборонено змінювати («Налаштування → Продажі → Джерела»).

## Додаткова інформація
- Пов'язані статті: [Тригери](settings-triggers.md), [Сайти](int-sites.md), [Webhook](int-webhook.md), [Угоди](deals.md), [Клієнти](clients.md).