Триггер «По расписанию/дате»
Триггер «По расписанию/дате» запускает сценарий без сообщения клиента: в заданный час по расписанию или в день, связанный с датой из карточки клиента. Бот пишет первым. Работает во всех каналах ботов.
Два режима
| Режим | Когда запускается | Кому |
|---|---|---|
| По расписанию (cron) | По cron-выражению, с точностью до часа | Всем собеседникам бота в канале сценария |
| Относительно даты в карточке клиента | В заданный час в день, связанный с датой из поля клиента CRM | Клиентам, у которых дата в поле подходит |
Относительно даты в карточке клиента
Дата берётся из доп. поля клиента CRM. В триггере указывается ключ поля — например birthday.
- Формат значения — ГГГГ-ММ-ДД (в том числе с временем) или ДД.ММ.ГГГГ. Значения в другом формате пропускаются.
- День рождения. Для полей с ключами
birthday,birthdate,birth_date,date_of_birthиdobбот срабатывает каждый год в этот день. Родившихся 29 февраля в невисокосный год поздравит 28 февраля. - Другие поля — точная дата со сдвигом в днях: 0 — в день даты, −1 — за день до неё, 1 — на следующий день.
- Час — от 0 до 23 по часовому поясу организации, по умолчанию 10.
- Без ключа поля отсчёт идёт от даты, когда клиент появился в APX.
- Проверка поля. Если поля с таким ключом нет среди доп. полей клиента CRM, оно в архиве или это не дата и не текст, проверка сценария предупредит: запуск по такому полю не сработает.
Поле заполняют сотрудник в карточке клиента, импорт, API или шаг сценария с записью в поле CRM — «Вопрос», «Форма» или действие «Установить пользовательское поле».
Шаблоны «Поздравление с ДР и промокод» и «Подтверждение записи за день до визита» сами создают
нужное поле — «День рождения» (birthday) или «Дата следующего визита» (next_visit_date).
По расписанию (cron)
Расписание задаётся строкой из пяти полей: минуты, часы, день месяца, месяц, день недели.
- Бот проверяет расписание раз в час, поэтому минуты не учитываются: запуск происходит в начале указанного часа.
- Время — по часовому поясу организации.
- В каждом поле можно указать
*, число, список через запятую (1,15) или шаг (*/2). Диапазоны вида1-5не поддерживаются — перечислите значения через запятую. - День недели: 1 — понедельник, 0 или 7 — воскресенье.
Например, 0 10 * * 1 — каждый понедельник в 10:00 по часовому поясу организации.
Часовой пояс
Час запуска, день недели и «сегодня» считаются по часовому поясу организации. По умолчанию — Москва. Пояс меняют создатель и администратор: в профиле или в настройках сценария, поле «Часовой пояс организации». Пояс общий для всех ботов организации.
Раньше время расписания считалось по UTC. Если вы указывали час с поправкой на UTC (например, 7 вместо 10 по Москве), исправьте его: теперь 7 — это 7:00 по часовому поясу организации.
Общие правила
- Бот пишет только тем, кто уже писал в канал сценария, не заблокировал бота и не удалён из подписчиков.
- Сценарий запускается в открытом диалоге клиента, а если открытого нет — в последнем.
- Одному клиенту сценарий по расписанию запускается не чаще раза в сутки.
- Если у клиента в этот момент идёт сценарий, запуск пропускается.
- За один запуск сценарий обрабатывает до 1000 клиентов.
- В стартовой ноде учитывается первый триггер по расписанию.
Как настроить
Добавьте триггер
В стартовой ноде нажмите «Добавить триггер» и выберите «По расписанию/дате».
Выберите режим
«Относительно даты в карточке клиента» или «По расписанию (cron)».
Заполните параметры
Для даты — ключ поля, сдвиг в днях и час. Для расписания — cron-выражение.
Соберите сообщение и опубликуйте
Свяжите стартовую ноду с первым шагом и опубликуйте сценарий — расписание работает только у опубликованного сценария.
Пример
Поздравление с днём рождения: триггер в режиме «Относительно даты» с полем birthday, сдвигом 0 и часом 10. В этот день бот присылает клиенту поздравление с подарочным промокодом.