Webhook

1Налаштування

Дорога до вхідних: «Налаштування» → «Інтеграції» → вкладка «Інше» → картка «Webhook»; або Налаштування›Автоматизація›Вхідні вебхуки«Налаштування → Автоматизація → Вхідні вебхуки». Дорога до вихідних: Налаштування›Автоматизація›Тригери (Webhook)«Налаштування → Автоматизація → Тригери (Webhook)».

Дивитися може кожен з доступом до «Інтеграцій»; створювати й змінювати — адміністратор або людина з доступом до «Налаштувань CRM». Ключів у картці нема («Ключ доступу: Не потрібен.»). «Стан роботи» показує «Вхідних вебхуків: N з M увімкнено» і «Тригерів Webhook: N з M увімкнено».

Ключі сторонніх сервісів для вихідних тригерів (напр. токен SMS-сервісу) у тексті тригера не пишуться: вони задаються на сервері як CRM_SECRET_<НАЗВА> і вставляються змінною {{secrets.НАЗВА}}; у журналі вони приховані.

2Створити вхідний вебхук

1. Картка «Webhook» → блок «Вхідні вебхуки» → «+ Новий вебхук».
2. Оберіть шаблон сервісу або «Webhook без налаштувань».
3. Вебхук з'явиться в таблиці («Назва», «Шаблон», «Запитів», «Останній»). Відкрийте його: «Назва вебхука», перемикач «Приймає запити» / «Вимкнено», адреса для сервісу зі «Скопіювати».
4. Вставте адресу в налаштування вебхука на сайті чи в сервісі й надішліть тестовий запит (заповніть форму як клієнт).
5. «Нова адреса» генерує іншу адресу; стара перестане приймати запити — її треба замінити в сервісі.
6. «Зберегти». «Видалити вебхук» — прибрати.

3Мапінг: контрагент, угода, завдання

• Контрагент (створюється завжди): «Тип контрагента» (Лід / Клієнт), «Головний відповідальний», «Джерело», «Статус ліда (ID)», «Теги (через кому)», «Наявний контрагент» (що робити, якщо такий уже є), і таблиця «Поле CRM» ← змінна; «+ Додати змінну». Обов'язково — «Назва компанії» або «Контактна особа».
• «Створювати угоду»: обов'язково «Назва угоди»; «ID замовлення» не дасть створити дубль. «Воронка», «Етап», «Товари» — масив товарів у запиті і чотири стандартні змінні елемента (назва, кількість, ціна, артикул); артикул шукається на складі.
• «Створювати завдання»: обов'язково «Назва завдання» (чітка назва в скісних рисках, напр. /Передзвонити/), «Термін, хвилин від запиту».

Синтаксис змінних: a.b, a[].b, a[1].b, $.x, /текст/ (постійний текст), {{a}} {{b}} (склеїти кілька).

4Історія запитів і повторна обробка

У вебхуку — «Історія запитів»: «Дата», «Що сталось», «Результат», «Тіло» («показати»). «Змінні» — назви полів з тіла запиту; клік вставляє змінну в поле мапінгу. «Перевірити мапінг» показує результат без створення записів. «Обробити ще раз» — обробити запит за поточним мапінгом. Якщо запит не вдалося обробити, нічого не створюється, а причина пишеться в історії.

5Вихідні: тригер з дією Webhook

1. Налаштування›Автоматизація›Тригери (Webhook)«Налаштування → Автоматизація → Тригери (Webhook)» → «+ Новий тригер» або «З шаблону…» (Viber і SMS через TurboSMS, SMS Club, AlphaSMS, Telegram, Хорошоп, Kasta, рух товару та інші).
2. «Назва», «Таблиця з даними», «Умова виконання» (напр. stage.name == 'Відправлено', result == 'successful', AND / OR), «Метод запуску» («Відразу», «З затримкою» — «Затримка, хвилин», «На основі поля з типом дата» — поле, «До дати» / «Після дати», дні, година).
3. Дія: «URL», «Метод відправки», «Content-Type», «Успішний статус запиту», «Заголовки запиту (Headers)», «Параметри запиту (Params)», «Тіло запиту (Body)» зі змінними (товари — {{#jobs}}…{{/jobs}}), «Успішна відповідь (Response)» — значення з відповіді в поле запису.
4. «Перевірка» → «Виконати на записі» — пробний запуск. «Журнал спрацювань» — останні 100 спрацювань; ключі в запитах приховано.

Імпорт і дзеркало KeepinCRM тригерів не запускають; тригер спрацьовує лише на нові дії. Докладно про тригери — Налаштування: тригери.