Triggers

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

Налаштування›Інтеграції й автоматизація›Тригери«Налаштування → Інтеграції й автоматизація → Тригери». Угорі — «З шаблону…» і «+ Новий тригер», нижче — один рядок фільтрів: пошук (назва, коментар, умова), таблиці з кількістю (лише ті, де є тригери), «Дія» і «Стан» (увімкнені, вимкнені, з помилкою останнього запуску) — випадними списками; «+ Новий тригер» бере дію з вибраного фільтра. Під назвою тригера — його коментар. У списку: перемикач «Увімкнено», «Назва», «Таблиця», «Умова», «Запуск», «Останнє спрацювання», «Разів», дії «Копія» і «Видалити».

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

2Створити тригер з шаблону

1. «З шаблону…» → виберіть, наприклад, «Сповіщення в Telegram: нова угода» або «Viber через TurboSMS».
2. Тригер створиться і відкриється шторка з уже заповненими URL, тілом і умовою; угорі — підказка шаблону й посилання на статтю.
3. Підставте свої дані (токен бота, номер чату, ключ) і натисніть «Зберегти».

Шаблони: «Viber через TurboSMS», «SMS через SMS Club», «SMS через AlphaSMS», «Сповіщення в Telegram: нова угода», «…: нове завдання», «…: новий лід/клієнт», «…: завдання прострочене», «Залишки на Хорошоп», «Синхронізація залишків з Kasta», «Інформація при русі товару», «Інформація з угод», «Інформація з розділу Фінанси».

Тригери «Отримано» і «Скасовано» (15.10). Готові, для всіх воронок: «Отримано» → фіскальний чек і «Завершити угоду: Виграно»; етап скасування (роль «lost») → «Завершити угоду: Програно» і повернення чека. Докладно — стаття «Фіскальні чеки», розділ «Автоматичний чек (тригер)». Один тригер на дію: умова за назвою чи роллю етапу діє в усіх воронках, тож окремий тригер на кожну воронку не потрібен.

3Створити тригер вручну

1. «+ Новий тригер». У шторці «Новий тригер · Webhook»: «Назва», «Таблиця з даними», «Дія» — Webhook.
2. «URL», «Метод відправки» (GET, POST, PUT, PATCH, DELETE), «Успішний статус запиту» (порожньо — будь-який 2xx), «Content-Type».
3. «Заголовки запиту (Headers)», «Параметри запиту (Params)», «Тіло запиту (Body)». Змінні запису — у блоці «Змінні запису» під дією: клік по змінній вставляє її туди, де стоїть курсор. Список товарів угоди — {{#jobs}}…{{^_last}},{{/_last}}{{/jobs}}.
4. «Успішна відповідь (Response)» — $.змінна відповіді → поле запису («+ Додати»); наприклад, номер повідомлення з відповіді SMS-сервісу в поле угоди.
5. Галочка «Записувати відповідь у журнал картки (помилки записуються завжди)».
6. «Зберегти». Тригер з'явиться в списку; вмикається й вимикається перемикачем.

3аДії тригера

«Дія» в шторці тригера; поля дії — під нею. Тексти в полях дії — шаблони: {{title}}, {{client.company}}, {{client.phone}}, {{credit_amount}}, {{custom_fields.<ключ>}} (клік по змінній під умовою вставляє її, де курсор).

Приклад як у KeepinCRM: «Заповнити поля», умова custom_fields.prom_payment_type == 'Пром-оплата', поле «Тип оплати checkbox» ← Rozetkapay, «Лише якщо поле порожнє». Так налаштовано всі правила «Тип оплати checkbox» (Prom, Rozetka, OLX, Kasta, Епіцентр, сайти, «Спосіб оплати») — їх можна змінювати тут, у тригерах.

Результат дії пишеться в «Журнал спрацювань» і нотаткою в картку (помилка — завжди). Зміни, зроблені тригером, інших тригерів не запускають.

4Умова виконання

Угорі шторки — «Назва» і «Коментар»: для чого цей тригер (наприклад «накладений OLX — у чек як UAPay»); його видно під назвою в списку, за ним шукає пошук. Далі кожен крок — окрема картка; внизу — «Додатково» (записувати результат у картку), «Змінні запису» і «Перевірити на записі». Шторка тригера — три кроки: 1 Коли (таблиця і запуск), 2 Якщо (умова), 3 Що зробити (дія та її поля). У кроці «Якщо» умова складається рядками «поле · як · значення» без формул:

• поле — зі списку (етап, воронка, сума, відповідальний, клієнт, додаткові поля запису…);
• як — «дорівнює», «не дорівнює», «містить», «більше», «менше», «не менше», «не більше», «порожнє», «заповнене»;
• значення — текст або число; для етапу, воронки, відповідального й результату є підказки зі списку;
• «Лише для нового запису (щойно створеного)» — тригер діє лише при створенні;
• кілька рядків — «Усі умови» (і) або «Будь-яка з умов» (або); «+ Умова» додає рядок, «×» прибирає.

Приклад власника: «Дод. поле: Тип оплати OLX» · «містить» · «доставк» → «Заповнити поля»: «Тип оплати checkbox» ← UAPay. Кнопка «Формулою» праворуч показує ту саму умову мовою KeepinCRM; складні умови (any(…), дужки, змішані «і» та «або») пишуться лише формулою — шторка відкриває їх одразу у формулі, «Простими умовами» повертає рядки, коли це можливо. Змінні запису для текстів дій — у згорнутому блоці «Змінні запису» під дією.

Тригер спрацьовує, коли умова стала істинною після зміни запису; для нового запису — коли вона істинна одразу. Приклади формул:

• created_at — лише при створенні;
• stage.name == 'Відправлено' — угода перейшла на етап «Відправлено»;
• result == 'successful' — угоду закрито «Виграно»;
• any(jobs, job, job.sku == '1') — в угоді є товар з артикулом 1;
• is_overdue == true — завдання прострочене.

Угоди, що вже стоять на етапі, тригер не зачіпає — лише нові дії. Тригер спрацьовує на зміни людей, ШІ-співробітників, вхідних замовлень і вебхуків; імпорт і дзеркало KeepinCRM тригерів не запускають, як і зміни, зроблені самим тригером.

5Коли запускати: відразу, із затримкою, за датою

«Метод запуску»:

• «Відразу» — одразу після дії;
• «З затримкою» — «Затримка, хвилин» (2 дні = 2880, 1 год 30 хв = 90);
• «На основі поля з типом дата» — «Поле з типом дата», «Метод виконання» («До дати» / «Після дати»), «Днів», «Годин», «Хвилин». Для дат без часу (власні поля, день народження) години й хвилини означають «о котрій».

6Перевірити перед увімкненням

Унизу шторки — згорнутий блок «Перевірити на записі»: впишіть «ID запису» (порожньо — останній) → «Перевірити». Побачите, чи умова зараз істинна і чи була б при створенні, помилки в тілі чи шаблоні й готовий запит. Для збереженого тригера є «Виконати на записі» — справжня відправка на вибраному записі (у журналі позначено «перевірка»).

7Журнал спрацювань

Відкрийте тригер → вкладка «Журнал спрацювань»: «Коли», «Стан» («успішно», «помилка», «пропущено», «у черзі», «виконується»), «Запис», «Відповідь» з «запит / відповідь». «Повторити» — для помилки, «Скасувати» — для відкладеного запуску в черзі. Показано останні 100 спрацювань, ключі в запитах приховано. Відповідь також записується нотаткою в картку угоди, клієнта чи товару.

Автодії етапу (відповідальний, перенести, в архів) налаштовуються й у «Воронки й етапи» — для простих правил «потрапила на етап». Тригер потрібен, коли є умова по полях («Пром-оплата», служба доставки) або затримка.

8Дозволити адресу для вебхуків

Адреси внутрішньої мережі сервера заборонені завжди — так чужий тригер не дістане службові сторінки Helomi. Компанія, якій належить сервер Helomi, може кликати й власні служби на ньому, як раніше. Якщо ваш сервіс приймає запити лише по http:// або на свій порт, додайте його в список дозволених.

1. Відкрийте Налаштування›Інтеграції й автоматизація›Тригери«Налаштування → Інтеграції й автоматизація → Тригери».
2. Під списком тригерів розгорніть «Дозволені адреси вебхуків».
3. Впишіть сайт, по одному в рядок: crm.example.com — дозволяє http://, crm.example.com:8080 — ще й свій порт.
4. Натисніть «Зберегти». Зміна діє одразу, без перезапуску; хто й коли змінив список, видно в «Журналі змін» налаштувань.