Загальна інформація
ЗмістЗагальна інформація#1. Типи тригерів#2. Умови#3. Метод запускуДодаткова інформація
Загальна інформація
Тригери дозволять автоматизувати роботу в KeepinCRM, структурувати процеси, налаштувати додаткові продажі, та не забувати про те що потрібно виконати. Тобто налаштувавши один раз тригер - він буде виконувати частину шаблонних робіт та допомагати.
Структурно тригери складаються з:
- Тип тригера
- Умова виконання
- Яку дію виконати, якщо умова підійшла
- Метод запуску
#1. Типи тригерів
Наразі доступно:
- Створення завдання
- Відправка SMS
- Зміна головного відповідального
- Зміна етапу угоди
- Архівація угоди
- Архівація контрагента (ліда, клієнта)
- Копіювання з поля в поле
- Заповнення полів
- Створення платежів
- Генерація документів
- Запис в нотатку
- Автоматичне тегування контрагентів (сегментація)
- Авторозподіл угод/контрагентів
- Сповіщення в середині системи або по Email працівників
- Переміщення між воронками продажів
- Робота з дзвінками
- Створення фіскальних чеків Checkbox
Створення тригера:
#2. Умови
В умові потрібно вказати, при якій дії повинен запуститись тригер. Наприклад: змінено відповідального, змінено статус ліда, значення поля дорівнює вказаному в умові й тому подібне.
Важливо:
- Умова має свій синтаксис
- Якщо умова некоректна, тригер не запуститься
- Якщо налаштовані додаткові контролі, то тригер це врахує. Наприклад заборона архівації, якщо фінанси не проведені, або товар не списано
#2.1 Умова складається з 3-х блоків
Розберемо на прикладі:
stage.name == 'Відправлено рахунок'
- "stage.name" - що саме відстежується (змінна)
- "==" - оператори: рівно (==), не рівно (!=), більше (>), менше (<)
- "Відправлено рахунок" - на яке значення повинно змінитись, щоб тригер спрацював
#2.2 Які змінні можна використовувати в умовах
В умовах можна використовувати 2 типи змінних: системні та користувацькі поля. Приклад системних змінних (інші можна знайти в колонці ID в налаштуваннях полів):
Змінна | Опис | Таблиця | Значення | Приклад |
stage.name |
Етап воронки продажів | Угоди | Точна назва етапу | stage.name == 'Відправлено' |
source_id |
Джерело | Угоди, Контрагенти | ID джерела для API з налаштувань | source_id == 4 |
status_id |
Статус | Контрагенти | ID статусу для API з налаштувань | status_id == 2 |
main_responsible_id |
Відповідальний | Угоди, Контрагенти | ID користувача для API з налаштувань | main_responsible_id == 29 |
comment |
Коментар | Угоди, Контрагенти | В одинарних дужках точна назва тексту яку треба відстежувати | comment == 'тестовий коментар' |
created_at |
Дата створення | Угоди, Контрагенти | Використовується для запуску тригеру тільки при створенні та без значень | created_at |
result |
Результат угоди | Угоди | Якщо результат угоди Виграно (successful) або Програно (failed) | result == 'successful' |
paid |
Сплачено | Угоди | Потрібна цифра з нулем після крапки | paid == 100.0 |
total |
Всього | Угоди | Потрібна цифра з нулем після крапки | total > 200.0 |
status_description |
Статус доставки | Доставка | Точна назва статусу ТТН | status_description == 'Прибуло у відділення' |
client.working_agreements_count |
К-сть угод контрагента | Угоди | К-сть (цифра) | client.working_agreements_count == 0 або client.working_agreements_count >= 1 |
any(documents, document, document.template.name == 'Рахунок') |
Наявність в угоді конкретного документа | Угоди | Точна назва документа | any(documents, document, document.template.name == 'Рахунок') |
archive_status.name |
Причина програшу угоди | Угоди | Точна назва причини | archive_status.name == 'Дорого' |
funnel.title |
Виконання в певній воронці продажів | Угоди | Точна назва воронки продажів | funnel.title == 'Продажі' |
finished |
Завдання виконане (архів) | Завдання | Виконане - true, невиконане - false | finished == true |
CONTAINS('текст нотатки', note) |
Моніторинг тексту в нотатках для контрагентів, угод, завдань | Нотатки | В лапках вказується чіткий текст, який потрібно моніторити, та запускати відповідний тригер | CONTAINS('текст нотатки', note) Додатково: Якщо потрібно додатково враховувати головного відповідального по контрагенті і нотатка створюється в угоді, то додається змінна: item.client.main_responsible_id == 1 якщо нотатка додається в картці контрагента, то додається змінна: item.main_responsible_id == 1 |
any(jobs, job, job.title == 'Назва товару') |
Перевірка наявності товару з потрібною назвою в угоді. Використовується з додатковою умовою: наприклад зміна етапу, відповідального і тому подібне | Угоди | Точна назва | any(jobs, job, job.title == 'Точна назва товару') and stage.name == 'Відправлено' |
any(jobs, job, job.sku == '33921') |
Перевірка наявності товару з потрібним артикулом в угоді. Використовується з додатковою умовою: наприклад зміна етапу, відповідального і тому подібне | Угоди | Точна назва | any(jobs, job, job.sku == '33921') and stage.name == 'Відправлено' |
any(jobs, job, any(job.product.category.full_path, category_name, category_name == 'Назва папки')) |
Перевірка наявності товару з потрібної папки в угоді. Використовується з додатковою умовою: наприклад зміна етапу, відповідального і тому подібне | Угоди | Точна назва | any(jobs, job, any(job.product.category.full_path, category_name, category_name == 'Мобільні телефони')) |
lead == true |
Перевірка, щоб контрагент був в розділі "Ліди" | Контрагенти | Лід - true Клієнт - false |
lead == true або lead == false, якщо створені додаткові розділи з лідами, то додається section_id == null and lead == true |
updated_at |
Запускати тригер при кожному оновленні (будь-яка зміна) | Угоди, Контрагенти, Завдання | Точна назва змінної | updated_at |
Приклад користувацьких змінних (полів):
Змінна | Опис | Таблиця | Значення | Приклад |
custom_fields.ІД змінної яка в дужках в налаштуванні полів |
Будь-яке користувацьке поле, включно з полями всіх маркетплейсів | Угоди, Контрагенти | Чіткий формат використання | Приклад #1: custom_fields.oplata_2 == 'Безготівкова оплата' Приклад #2: custom_fields.rozetka_payment_status == 'Оплачено' |
*Більше прикладів використання описано в кожному типі тригера
Корисно:
Якщо створюється тригер з таблицею угоди, то в умові тригера можна звертатись до полів картки клієнта по формату: client.назва змінної.
Приклад #1: Відправити SMS якщо відповідний статус ліда/клієнта та змінюється етап угоди:
client.status_id == 10 and stage.name == 'Відправлено ТОВ'
Приклад #2: Якщо відповідний тег ліда/клієнта і потрібно сформувати документи на певному етапі:
any(client.tags, tag, tag == 'B2B') and stage.name == 'Документи'
Приклад #3: Якщо в користувацькому полі ліда/клієнта з типом цифра є потрібне значення:
client.custom_fields.kol_vo_kliientov_50537 == 10 and stage.name == 'Повернення'
#2.3 Декілька умов в одному тригері
Для використання декількох умов в одному тригері потрібно використовувати: AND = "І" (уточнення), OR = "АБО". Приклад, потрібний статус ліда та потрібний відповідальний:
source_id == 1 AND main_responsible_id == 2
Приклад з умовою OR (АБО) та обов'язковим використанням дужок для цього. Приклад, потрібний статус ліда та декілька можливих відповідальних:
source_id == 1 AND (main_responsible_id == 2 or main_responsible_id == 3 or main_responsible_id == 10)
Якщо використовуються декілька SMS підписів і потрібне налаштування відправки SMS по посилці яка довго у відділенні, то використовуються декілька умов. Приклад:
status_description == 'Прибуло у відділення' AND source_id == 2
#3. Метод запуску
При створенні тригера в наявності поле "Метод запуску", воно відповідає за те, коли саме потрібно виконати тригер. Доступно три варіанти роботи:
- Якщо обрано "Відразу" - тригер виконується відразу
- Якщо обрано "З затримкою" - виконується, через вказану к-сть хвилин
- Якщо потрібно вказати виконання через 2 дні: 2 дні * 24 години * 60 хвилин = 2880
- Підходить для відправки SMS, створення завдань, переміщення між етапами в потрібні проміжки часу
- Якщо обрано "На основі поля з типом дата" - запуск тригера відбувається на основі дати яка обрана в полі. Тут можливі 2 варіанти:
- Якщо обирається системне поле: дата завершення завдання, дата завершення угоди або інше, то в цих полях є дата та час, тому тригер виконається в цю дату та час. Відхилення для таких полів може бути + або -. Наприклад:
- Дата завершення угоди: 01.10.2023 16:00, якщо вказати -5, то тригер запуститься в 01.10.2023 15:55
- Дата завершення угоди: 01.10.2023 16:00, якщо вказати 10, то тригер запуститься в 01.10.2023 16:10
- Дата завершення угоди: 01.10.2023 16:00, якщо вказати 0, то тригер запуститься в 01.10.2023 16:00
- Якщо обирається користувацьке поле з типом дата, то в цьому полі є тільки дата, час виконання вказується в полі "Додаткове відхилення". Наприклад:
- В полі вказано дату 05.11.2023, і потрібно щоб тригер запустився 05.11.2023 о 10:00, то в полі додаткове відхилення потрібно вказати: 10 годин * 60 хв. = 600
- В полі вказано дату 05.11.2023, і потрібно щоб тригер запустився 05.11.2023 о 15:30, то в полі додаткове відхилення потрібно вказати: 15 годин * 60 хв. + 30 хв. = 930
- Цей метод доступний не для всіх таблиць
- Якщо обирається системне поле: дата завершення завдання, дата завершення угоди або інше, то в цих полях є дата та час, тому тригер виконається в цю дату та час. Відхилення для таких полів може бути + або -. Наприклад:
- Якщо багато тригерів на одній умові (від 3-х), то рекомендуємо додавати затримку в +1 хв для тригера, щоб вони спрацьовували послідовно
Додаткова інформація
- Якщо тригер виконався, але спрацював додатковий контроль, повідомлення про це виведеться в нотатках
- Якщо тригер не запустився, звернути увагу на таке:
- Чи увімкнений тригер (при створенні він вимкнений)
- Яка таблиця використовується, якщо використовуються змінні з угоди, а вибрана таблиця - Контрагенти то тригер не спрацює
- Коректність написання назви змінної
- Чи вказана затримка виконання тригера
- При імпорті замовлень/клієнтів рекомендуємо вимкнути тригери які відповідають за відправку SMS або завдання
- Boolean поля (Так/Ні) в умовах вказуються як true або false, без лапок
- В кожного тригера є свій журнал спрацювань (стрілочка у вікні редагування тригера)
- Тригер запускається тільки у нових діях, тобто якщо було налаштовано тригер, який створює завдання на етапі, то в угодах які вже на цьому етапі завдання не створяться, тільки у тих які перейдуть на цей етап
- Тригери доступні на розширеному тарифі
- Додаткові умови можна також знайти у валідаціях, вони можуть використовуватись і в тригерах
- Якщо виникнуть складнощі при самостійному налаштуванні тригерів, зверніться до служби технічної підтримки
- Допомога, консультація в налаштуванні тригерів виконується тільки через запити або по email [email protected]
Оновлено 02.10.2023