Добавления действия создания записи

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

Чтобы создать новую запись в календаре выполните следующие действия:

  1. В приложении Twin откройте вкладку импорта шаблона телефонии или чатов, и выберите чат/шаблон/линию, в зависимость от вкладки.



  2. Нажмите Выберите действие и в выпавшем списке выберите Создать запись в календаре, затем нажмите Добавить.



  3.  После этого вам откроется окно настроек записи в календаре.

Заголовки со звездочками обозначают обязательные к заполнению поля.

Выбор владельца календаря*

Выберите владельца календаря из выпадающего списка.

Выбор календаря*

Выберите интересующий вас календарь, куда будет добавлена запись.

Пересечение событий

Поставьте галку, если вы хотите, чтобы записи могли накладываться друг на друга по времени.

Ограничение по рабочему времени

Поставьте галку, если вы хотите, чтобы записи создавались только в период рабочего времени календаря.

Часовой пояс

Выберите часовой пояс для создания события.

Время начала события*

В поле От укажите дату и время начала события.

Поле принимает данные в формате переменных типа дата и время в сценарии – 2022-08-08 12:05:00. 


Используйте переменную из сценария, для этого нажмите на в поле, чтобы открыть выпадающий список и добавить {input.}. Далее, после точки, укажите точное название переменной, которая используется в сценарии. Например: {input.from}, где {input.} – шаблон обращения к переменной в сценарии, а from – точное название переменной в сценарии бота. При создании события в это поле подтянется значение из этой переменной. 


Подробнее о создании переменных в сценарии описано в этой статье.

Время конца события*

В поле До укажите дату и время окончания события.

Поле принимает данные в формате переменных типа дата и время в сценарии – 2022-08-08 12:05:00. 


Используйте переменную из сценария, для этого нажмите на в поле, чтобы открыть выпадающий список и добавить {input.}. Далее, после точки, укажите точное название переменной, которая используется в сценарии. Например: {input.from}, где {input.} – шаблон обращения к переменной в сценарии, а from – точное название переменной в сценарии бота. При создании события в это поле подтянется значение из этой переменной. 


Подробнее о создании переменных в сценарии описано в этой статье.

Обязательно должно быть заполнено поле До или Длительность (минуты)

Если заполнены оба поля, то приоритет будет отдан полю До.

Длительность события*

Укажите длительность события в минутах

Обязательно должно быть заполнено поле До или Длительность (минуты)

Если заполнены оба поля, то приоритет будет отдан полю До.

Возможно использовать переменную из сценария, для этого нажмите на в поле, чтобы открыть выпадающий список и добавить {input.}. Далее, после точки, укажите точное название переменной, которая используется в сценарии. Например: {input.nameSpace}, где {input.} – шаблон обращения к переменной в сценарии, а nameSpace – точное название переменной в сценарии бота. При создании события в это поле подтянется значение из этой переменной. 


Подробнее о создании переменных в сценарии описано в этой статье.

Название события

Название события, которое будет отображаться в календаре.

Возможно использовать переменную из сценария, для этого нажмите на в поле, чтобы открыть выпадающий список и добавить {input.}. Далее, после точки, укажите точное название переменной, которая используется в сценарии. Например: {input.nameSpace}, где {input.} – шаблон обращения к переменной в сценарии, а nameSpace – точное название переменной в сценарии бота. При создании события в это поле подтянется значение из этой переменной. 


Подробнее о создании переменных в сценарии описано в этой статье.

Описание события

Описание события, которое будет отображаться в календаре.

Возможно использовать переменную из сценария, для этого нажмите на в поле, чтобы открыть выпадающий список и добавить {input.}. Далее, после точки, укажите точное название переменной, которая используется в сценарии. Например: {input.nameSpace}, где {input.} – шаблон обращения к переменной в сценарии, а nameSpace – точное название переменной в сценарии бота. При создании события в это поле подтянется значение из этой переменной. 


Подробнее о создании переменных в сценарии описано в этой статье.

Место события

Место, которое будет указано в событии.

Возможно использовать переменную из сценария, для этого нажмите на в поле, чтобы открыть выпадающий список и добавить {input.}. Далее, после точки, укажите точное название переменной, которая используется в сценарии. Например: {input.nameSpace}, где {input.} – шаблон обращения к переменной в сценарии, а nameSpace – точное название переменной в сценарии бота. При создании события в это поле подтянется значение из этой переменной. 


Подробнее о создании переменных в сценарии описано в этой статье.

Занятость

Укажите занятость, которая будет указана в событии.

Доступны варианты: Занят, Отсутствую, Под вопросом, Свободен.

Важность события

Установите важность создаваемого события.

Доступны варианты: Обычная, Высокая, Низкая.

По завершению всех настроек нажмите кнопку Импортировать.

После этого под окном настроек появится окно с URL для активации этого действия, он понадобится при настройке в редакторе сценариев.


Пример сценария для создания записи в календаре

Ниже приведен пример сценария, который добавляет событие в календарь.


Чтобы воссоздать этот сценарий, выполните следующие действия:

  1. В стартовом блоке добавьте переменную, назовите ее from. Она должна иметь тип данных Дата и время.



  2. Сохраните ответ клиента в переменную, которую вы создали в стартовом блоке.

    Подробнее о сохранении ответа клиента в переменную можно узнать в этой статье.

  3. Заполните блок запроса к серверу согласно таблице ниже.

    НомерНазваниеОписание
    1Выберите тип запросаУкажите тип запроса типа POST.
    2URLУкажите URL, который вы получили после импорта шаблона в Битрикс 24.
    3Выберите тип содержимогоУкажите тип содержимого json.
    4Тело запросаДобавьте тело запроса, назовите его from и поместите в него значение переменной, в которую вы сохранили ответ пользователя, прописав ее название в фигурных скобках

    Подробнее о работе с блоком запроса к серверу можно узнать в этой статье.

  4. Сценарий готов.


Чтобы отслеживать результативность создания записи, в сценарии выводится две стрелки в соответствующие блоки информации. Если запись создана успешно, то запрос вернется с кодом ответа 200 и параметром eventId, который будет содержать ID события в Битрикс 24. В случае неудачи вернется ответ с кодом 500.


В календаре события выглядят следующим образом.