{
    "componentChunkName": "component---src-templates-doc-page-js",
    "path": "/docs/ru/JS_API/built_in_services/pushgate/createEvent/",
    "result": {"data":{"site":{"siteMetadata":{"title":"Gatsby-doc-engine"}},"markdownRemark":{"id":"2efb923b-4c86-5230-874a-06161528a273","excerpt":"$pushgate.createEvent Метод создает событие, которое наступит в заданное время. Синтаксис Принимаемые аргументы Метод  принимает 6 аргументов. Аргумент Описание…","html":"<h1>$pushgate.createEvent</h1>\n<hr>\n<p>Метод создает событие, которое наступит в заданное время.</p>\n<br>\n<h2>Синтаксис</h2>\n<h3>Принимаемые аргументы</h3>\n<p>Метод <code class=\"language-text\">$pushgate.createEvent</code> принимает 6 аргументов.</p>\n<table>\n<thead>\n<tr>\n<th>Аргумент</th>\n<th>Описание</th>\n<th>Тип</th>\n<th>Обязательный</th>\n<th>Значение по умолчанию</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code class=\"language-text\">dateTime</code></td>\n<td>Дата и время наступления события</td>\n<td>Строка</td>\n<td>Да</td>\n<td>—</td>\n</tr>\n<tr>\n<td><code class=\"language-text\">event</code></td>\n<td>Название события</td>\n<td>Строка</td>\n<td>Нет</td>\n<td><code class=\"language-text\">timerEvent</code></td>\n</tr>\n<tr>\n<td><code class=\"language-text\">eventData</code></td>\n<td>Данные, переданные вместе с событием</td>\n<td>Объект</td>\n<td>Нет</td>\n<td><code class=\"language-text\">{}</code></td>\n</tr>\n<tr>\n<td><code class=\"language-text\">channelType</code></td>\n<td>Тип канала</td>\n<td>Строка</td>\n<td>Нет</td>\n<td><code class=\"language-text\">$request.channelType</code></td>\n</tr>\n<tr>\n<td><code class=\"language-text\">botId</code></td>\n<td>Идентификатор бота</td>\n<td>Строка</td>\n<td>Нет</td>\n<td><code class=\"language-text\">$request.botId</code></td>\n</tr>\n<tr>\n<td><code class=\"language-text\">chatId</code></td>\n<td>Идентификатор пользователя</td>\n<td>Строка</td>\n<td>Нет</td>\n<td><code class=\"language-text\">$request.channelUserId</code></td>\n</tr>\n</tbody>\n</table>\n<p class='tip'>Обратите внимание на следующие особенности задания даты и времени события:</p>\n<ul>\n<li>Строка, переданная в аргументе <code class=\"language-text\">dateTime</code>, должна иметь формат <code class=\"language-text\">yyyy-MM-ddTHH:mm:ss</code>.</li>\n<li>Отправка, запланированная на прошедшее время, не вызовет ошибки, но будет выполнена немедленно.</li>\n</ul>\n<p class='warn'>В поле <code class=\"language-text\">eventData</code> вы можете передать любые данные, которые потребуются при наступлении события. Данные будут доступны в обработчике события в поле <code class=\"language-text\">$request.rawRequest.eventData</code>.</p>\n<br>\n<h3>Возвращаемое значение</h3>\n<p>Метод возвращает объект с одним полем <code class=\"language-text\">id</code> — идентификатором созданного события.</p>\n<blockquote>\n<p>Идентификатор используется для отмены события при помощи метода <a href=\"/1.11.1/docs/ru/JS_API/built_in_services/pushgate/cancelEvent\"><code class=\"language-text\">$pushgate.cancelEvent</code></a>.</p>\n</blockquote>\n<br>\n<h2>Учет часового пояса</h2>\n<p>Планирование событий из сценария происходит с учетом часового пояса, который был задан для клиента при помощи метода <a href=\"/1.11.1/docs/ru/JS_API/built_in_services/reactions/setClientTimezone\"><code class=\"language-text\">$reactions.setClientTimezone</code></a>.</p>\n<p class='tip'>Если часовой пояс для клиента не задан, по умолчанию используется часовой пояс, указанный в <a href=/1.11.1/docs/ru/platform_ux/nlu_core_caila/project_setting  >настройках проекта</a> на вкладке <em>Классификатор</em>.</p>\n<br>\n<h2>Пример</h2>\n<p>Рассмотрим пример создания будильника при помощи сообщений от бота.</p>\n<div class=\"gatsby-highlight\" data-language=\"sc\"><pre class=\"language-sc\"><code class=\"language-sc\"><span class=\"token keyword\">state:</span> SetAlarm\n    <span class=\"token storageType\">intent!:</span> /Будильник/Поставить\n    <span class=\"token variableParameter\">a:</span> На какое время?\n\n    <span class=\"token keyword\">state:</span> Time\n        <span class=\"token storageType\">q:</span> * @duckling.time *\n        <span class=\"token variableParameter\">script:</span>\n            $temp.time = $parseTree[\"_duckling.time\"];\n            $pushgate.createEvent($temp.time.value);\n        <span class=\"token variableParameter\">a:</span> Будильник установлен на <span class=\"token constantCharacter\">{{$temp.time.hour}}</span>:<span class=\"token constantCharacter\">{{$temp.time.minute}}</span>.\n\n<span class=\"token keyword\">state:</span> Alarm\n    <span class=\"token storageType\">event!:</span> timerEvent\n    <span class=\"token variableParameter\">a:</span> Пора вставать!</code></pre></div>\n<br>\n<ol>\n<li>Когда клиент отвечает, в какое время нужно поставить будильник, он попадает в стейт <code class=\"language-text\">Time</code>. Названное им время извлекается из запроса при помощи сущности <a href=\"/1.11.1/docs/ru/NLU_core/duckling\">Duckling</a> — <code class=\"language-text\">@duckling.time</code>.</li>\n<li>В значении сущности <code class=\"language-text\">@duckling.time</code> есть поле <code class=\"language-text\">value</code> — строка, описывающая распознанное время и удовлетворяющая формату, требуемому <code class=\"language-text\">$pushgate.createEvent</code>. Планируется событие на это время.</li>\n<li>По наступлении нужного времени запланированное событие <code class=\"language-text\">timerEvent</code> приходит в сценарий и обрабатывается в стейте <code class=\"language-text\">Alarm</code>.</li>\n</ol>\n<blockquote>\n<p>Вы можете создавать не только одноразовые, но и регулярные события. Для этого в стейте для обработки события снова вызовите метод <code class=\"language-text\">$pushgate.createEvent</code> и запланируйте новое событие на будущее. Обратите внимание, что события отправляются в сценарий не чаще, чем раз в 30 секунд.</p>\n</blockquote>\n<p class='warn'>Изучите подробнее пример использования данного метода, пройдя пошаговый сценарий <a href=/1.11.1/docs/ru/common/tutorials/scheduler/scheduler  >создания бота для отправки напоминаний</a>.</p>","frontmatter":{"title":"","description":null},"headings":[{"value":"$pushgate.createEvent"}]}},"pageContext":{"slug":"/docs/ru/JS_API/built_in_services/pushgate/createEvent/","previous":{"fields":{"slug":"/docs/ru/JS_API/built_in_services/pushgate/cancelEvent/"},"frontmatter":{"title":"","description":null}},"next":{"fields":{"slug":"/docs/ru/JS_API/built_in_services/nlp/tokenize/"},"frontmatter":{"title":"","description":null}}}},
    "staticQueryHashes": ["1209419333"]}