Вебхуки
Вхідний вебхук — адреса, на яку сторонній сервіс (сайт на 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«Інтеграції → Webhook». Бачить сторінку людина з доступом «Інтеграції»; створює й змінює вебхуки адміністратор або людина з «Налаштування CRM».
Сайти, підключені як окремі акаунти в Інтеграції›Сайти«Інтеграції → Сайти», мають власну адресу «Вебхук url» і вкладку «Поля» в картці сайту — стаття «Сайти». Вхідні вебхуки тут — для будь-якого іншого сервісу.
2Створити вхідний вебхук
- «+ Новий вебхук» → виберіть шаблон сервісу або «Webhook без налаштувань».
- Відкриється картка вебхука: назва, «шаблон: …», перемикач «Приймає запити», рядок «URL вебхука:» з кнопкою копіювання.
- Скопіюйте URL і вставте його в налаштуваннях сервісу (у WooCommerce — Webhooks, у формі — адреса відправки).
- Перевірте блоки мапінгу (розділ 3) і натисніть «Зберегти».
- Надішліть тестову заявку з сервісу (заповніть форму як клієнт) — вона з'явиться в «Історії запитів».
Якщо в налаштуваннях вебхука чогось бракує, над блоками з'являться попередження червоною крапкою.
3Мапінг: контрагент, угода, товари, завдання
Кожен блок — таблиця «Змінна запиту» → «Поле CRM». Змінні пишуться як a.b, a[].b, a[1].b, $.x, сталий текст — /текст/, кілька змінних разом — {{a}} {{b}}.
- «Контрагент» — створюється завжди; обов'язково заповнити «Назва компанії» або «Контактна особа». Тут же — тип (лід чи клієнт), відповідальний, джерело, статус, теги.
- «Створювати угоду» — галочка; обов'язково «Назва угоди». Воронка й етап, «ID замовлення» (не дасть створити дубль), додаткові поля угоди.
- «Товари» — масив товарів у запиті і чотири змінні елемента: назва, кількість, ціна, артикул. Артикул шукається на складі.
- «Створювати завдання» — галочка; обов'язково «Назва завдання». Чітка назва для всіх —
/Передзвонити/.
Унизу — «Зберегти», «Скасувати зміни» і «є незбережені зміни», якщо ви ще не зберегли.
4Перевірити на справжньому запиті
Блок «Історія запитів» — «Дата», «Результат», «Що сталось», «Тіло». У рядку запиту:
- «Змінні» — показує всі змінні з прикладами значень; клік по змінній вставляє її в рядок мапінгу;
- «Перевірити мапінг» — що вийде з цього запиту за поточним мапінгом, нічого не створюючи;
- «Обробити ще раз» — створити записи з цього запиту після виправлення мапінгу.
Якщо запит не пройшов, нічого не створюється, а причина видно в «Що сталось». Сервісу Helomi відповідає успіхом навіть на помилку мапінгу, щоб WooCommerce не вимкнув вебхук.
5Нова адреса, вимкнути, видалити
- «Нова адреса» — новий токен; стара адреса перестає працювати.
- Перемикач «Приймає запити» / «Вимкнено».
- «Видалити вебхук» прибирає профіль; створені ним клієнти, угоди й завдання лишаються.
6Вихідні вебхуки
Щоб Helomi сам надсилав дані назовні (нова угода → Telegram, етап → SMS, рух товару → сайт), створіть тригер: Налаштування›Автоматизація›Тригери (Webhook)«Налаштування → Автоматизація → Тригери (Webhook)» — стаття «Тригери».
Можливі помилки
| Що ви бачите | Чому | Що зробити |
|---|---|---|
| «Контрагент: не налаштовано поле «Назва компанії» або «Контактна особа» — без нього нічого не створиться» | Немає рядка для назви чи особи | Додайте змінну для одного з полів |
| «Угода: не налаштовано поле «Назва угоди»» / «Завдання: не налаштовано поле «Назва завдання»» | Увімкнено блок без назви | Додайте змінну або сталий текст /…/ |
| «не заповнено «Назва компанії / Контактна особа» — перевірте змінні контрагента» | У запиті нема даних за вказаною змінною | «Змінні» → виберіть правильну |
| «поле «…» — цифрове, а прийшло …» / «— Так/Ні…» / «— дата…» | Значення не того типу | Змініть мапінг або тип поля |
| «external_uid «…» вже зайнятий — угода #… уже створена раніше» | Повторне замовлення з тим самим ID | Нічого: дубль не створено |
| «додаткового поля «…» нема — оновіть мапінг» | Поле видалили | Виберіть інше поле |
| «етапу «…» нема» / «етапу #… нема — оновіть налаштування угоди» | Етап видалено чи змінено | Виберіть етап знову |
| «Змінювати вебхуки може адміністратор або хто має «Налаштування CRM»» | Немає прав | Попросіть адміністратора |
Для ШІ-співробітників
Інструментів для вебхуків нема — їх налаштовує людина. Угоди й клієнти, створені вебхуком, ви бачите й змінюєте звичайними deals_* і clients_*; джерело в такій угоді може бути заборонено змінювати (Налаштування›Продажі›Джерела«Налаштування → Продажі → Джерела»).
Додаткова інформація
Цю саму статтю читають ШІ-співробітники Helomi: help("settings-webhooks")