Бот-будильник для любого часового пояса

В этой статье мы расскажем о том как с помощью платформы Метабот вы можете создать чат-бот, который будет работать как будильник в любом мессенджере или социальной сети.

Бот позволяет пользователю запланировать напоминание на нужный день и время с помощью триггеров и послужит хорошей основной для ваших грандиозных проектов. В сочетании с API интеграцией это решение может иметь массу практичных применений, например, мониторинг систем с уведомлением на смартфон, формирование отчетов по расписанию, передача данных между системами. Все это платформа Метабота позволяет реализовать.

А еще этот бот примечателен тем, что умеет работать в любом часовом поясе. Вся сложность этого примера в основном связана с тем, что приходится рассчитывать время для запуска будильника относительно часового пояса сервера. Те кто создает бота, в котором необходима поддержка разных часовых поясов, найдут здесь много полезного.

Мы здесь опустим базовую информацию о том как создать бота, настроить маршруты и подключить бота к каналам. Для тех кто только начинает знакомиться с Метабот, рекомендуем ознакомиться с уроком Бот за 5 минут.

I. Создайте сценарий с уведомлениями, которые пользователь будет получать при срабатывании будильника

 

1. Команда «Выполнить JavaScript»

var randomStrings = [
«ПОРА ВСТАВАТЬ ?»,
«ПОДЬЕМ !!! ?»,
«КУКАРЕКУ ?»
];

randomIndex = Math.ceil((Math.random()*randomStrings.length-1));

lead.setAttr(‘randomAnswer’, randomStrings[randomIndex]);

2. Команда «Отправить текст»

{{ $randomAnswer }}

II. Создайте триггер, который будем выполнять по заданию от пользователя

Назовите триггер «Уведомление о срабатывании будильника». Можете указать любое другое имя, но учтите, что мы позднее будем вызывать этот триггер из кода, обращаясь к нему по точному имени.

 

 

2. В поле «Запускаемый скрипт» выберите скрипт созданный ранее на этапе I.

 

III. Создайте скрипт «Запланировать будильник»

Этот скрипт будет содержать сценарий, в котором происходит следующее:

1. Спрашиваем у пользователя его временной пояс, а также необходимость сдвига на летнее время
2. Для установки будильника спрашиваем у пользователя день и время в его местном часовом поясе
3. Алгоритм, который позволяет установить время для будильника с учетом времени сервера, на котором выполняется бот
4. Планирование триггера, созданного на этапе II

 

1. Код расчета времени установки триггера с учетом временной зоны пользователя:

var dd = lead.getAttr(‘alarmDD’)*1; // + дней
var hh = lead.getAttr(‘alarmHH’)*1; // + часов
var mm = lead.getAttr(‘alarmMM’)*1; // + минут
var utc = lead.getAttr(‘utc’);
var summerTimeOffset = lead.getAttr(‘summerTimeOffset’);
var serverTimeOffset = 3; // Часовой пояс сервера (Москва) UTC(3)
var ms = 60 * 60 * 1000; // количеством миллисекунд в 1 часе

//////////////////////////////////
// 1. Текущая дата и время относительно сервера (Москва), в миллисекундах
//////////////////////////////////

var serverDatetime = new Date(Date.now());

var dateString =
serverDatetime.getFullYear() + «-» +
(«0» + (serverDatetime.getMonth()+1)).slice(-2) + «-» +
(«0″ + serverDatetime.getDate()).slice(-2) + » » +
(«0» + serverDatetime.getHours()).slice(-2) + «:» +
(«0» + serverDatetime.getMinutes()).slice(-2);

lead.setAttr(‘serverDatetime’, serverDatetime);
lead.setAttr(‘serverDatetimeAsText’, dateString);

/////////////////////////////////
// 2. Текущая дата и время пользователя по его местному часовому поясу
////////////////////////////////

// Отнимаем сдвиг на московское время, чтобы привести все к UTC(0)
// И потом добавляем сдвиг на часовой пояс пользователя и летнее время
var currentLocalDatetime = new Date(
serverDatetime
— (serverTimeOffset * ms)
+ utc * ms
+ summerTimeOffset * ms
);

dateString =
currentLocalDatetime.getFullYear() + «-» +
(«0» + (currentLocalDatetime.getMonth()+1)).slice(-2) + «-» +
(«0″ + currentLocalDatetime.getDate()).slice(-2) + » » +
(«0» + currentLocalDatetime.getHours()).slice(-2) + «:» +
(«0» + currentLocalDatetime.getMinutes()).slice(-2);

lead.setAttr(‘currentLocalDatetime’, currentLocalDatetime);
lead.setAttr(‘currentLocalDatetimeAsText’, dateString);

/////////////////////////////////
// 3. Расчитываем время будильника в часовом поясе пользователя
/////////////////////////////////

var localAlarmDatetime = new Date (
currentLocalDatetime // текущее местное время
— currentLocalDatetime.getHours() * 60 * 1000 // отнимаем часы,
— currentLocalDatetime.getMinutes() // минуты
— currentLocalDatetime.getSeconds() // и cекунды, т.е. теперь это 00:00
+ 24 * dd * ms // добавляем дни, если надо
);

// Устанавливем время будильника
localAlarmDatetime.setHours(hh);
localAlarmDatetime.setMinutes(mm);
localAlarmDatetime.setSeconds(0);

dateString =
localAlarmDatetime.getFullYear() + «-» +
(«0» + (localAlarmDatetime.getMonth()+1)).slice(-2) + «-» +
(«0″ + localAlarmDatetime.getDate()).slice(-2) + » » +
(«0» + localAlarmDatetime.getHours()).slice(-2) + «:» +
(«0» + localAlarmDatetime.getMinutes()).slice(-2);

lead.setAttr(‘localAlarmDatetime’, localAlarmDatetime);
lead.setAttr(‘localAlarmDatetimeAsText’, dateString);

/////////////////////////////////
// 4. Расчитываем время будильника в часовом поясе сервера для установки триггера
/////////////////////////////////

var d = new Date(
localAlarmDatetime
— utc * ms
— summerTimeOffset * ms
+ (serverTimeOffset * ms)
);

var runTriggerAt =
d.getFullYear() + «-» +
(«0» + (d.getMonth()+1)).slice(-2) + «-» +
(«0″ + d.getDate()).slice(-2) + » » +
(«0» + d.getHours()).slice(-2) + «:» +
(«0» + d.getMinutes()).slice(-2) + «:00»;

lead.setAttr(‘runTriggerAt’, runTriggerAt);

 

2. Код установки триггера

bot.runTriggerByNameForLead(‘Уведомление о срабатывании будильника’, lead.getData(‘id’), null, false, {
«run_at»: lead.getAttr(‘runTriggerAt’)
});

3. Сообщения для отладки

Время сервера: {{ $serverDatetime }}

Ваше местное время: {{ $currentLocalDateTimeAsText }}
Сдвиг часового пояса (UTC): {{ $utc }}
Сдвиг на летнее время: {{ $summerTimeOffset }}

Запускаем триггер в (Серверное время): {{ $runTriggerAt }}

 

Надеемся, что эти примеры окажутся вам полезны!