Перейти к основному содержимому

Создать событие календаря

Создает новое событие календаря

Функция СоздатьСобытиеКалендаря(Знач URL, Знач ОписаниеСобытия, Знач Токен = "") Экспорт

ПараметрCLI опцияТипОбяз.Назначение
URL--urlСтрока✔URL внешнего вебхука или адрес Bitrix24 при использовании токена
ОписаниеСобытия--fieldsСтруктура Из КлючИЗначение✔Описание события. См. ПолучитьСтруктуруСобытияКалендаря
Токен--tokenСтрока✖Токен авторизации, если используется не вебхук

Возвращаемое значение: Соответствие Из КлючИЗначение - сериализованный JSON ответа от Bitrix24


подсказка

Метод в документации API: calendar.event.add


Пример использования для 1С:Предприятие/OneScript
    URL         = "https://b24-ar17wx.bitrix24.by/rest/1/h0m...";
    IDКалендаря = "362";

    Завтра = OPI_Инструменты.ПолучитьТекущуюДату() + 86400;
    Час    = 3600;

    СтруктураСобытия = Новый Структура;

    СтруктураСобытия.Вставить("type"         , "user");
    СтруктураСобытия.Вставить("ownerId"      , 1);
    СтруктураСобытия.Вставить("from"         , XMLСтрока(Завтра));
    СтруктураСобытия.Вставить("to"           , XMLСтрока(Завтра + Час));
    СтруктураСобытия.Вставить("section"      , IDКалендаря);
    СтруктураСобытия.Вставить("name"         , "Новое событие");
    СтруктураСобытия.Вставить("skip_time"    , "N");
    СтруктураСобытия.Вставить("timezone_from", "Europe/Minsk");
    СтруктураСобытия.Вставить("timezone_to"  , "Europe/Minsk");
    СтруктураСобытия.Вставить("description"  , "Описание события");
    СтруктураСобытия.Вставить("color"        , "%23000000>");
    СтруктураСобытия.Вставить("text_color"   , "%23FFFFFF");
    СтруктураСобытия.Вставить("accessibility", "quest");
    СтруктураСобытия.Вставить("importance"   , "normal");
    СтруктураСобытия.Вставить("private_event", "Y");

        СтруктураПовторяемости = Новый Структура;
        СтруктураПовторяемости.Вставить("FREQ"    , "DAILY");
        СтруктураПовторяемости.Вставить("COUNT"   , 3);
        СтруктураПовторяемости.Вставить("INTERVAL", 10);

            МассивДней = Новый Массив;
            МассивДней.Добавить("SA");
            МассивДней.Добавить("MO");

        СтруктураПовторяемости.Вставить("BYDAY"   , МассивДней);
        СтруктураПовторяемости.Вставить("UNTIL"   , XMLСтрока(Завтра + Час * 24 * 10));

    СтруктураСобытия.Вставить("rrule"     , СтруктураПовторяемости);
    СтруктураСобытия.Вставить("is_meeting", "Y");
    СтруктураСобытия.Вставить("location"  , "Офис");

        МассивНапоминаний = Новый Массив;

            СтруктураНапоминания = Новый Структура;
            СтруктураНапоминания.Вставить("type" , "day");
            СтруктураНапоминания.Вставить("count", 1);

        МассивНапоминаний.Добавить(СтруктураНапоминания);

    СтруктураСобытия.Вставить("remind"   , МассивНапоминаний);
    СтруктураСобытия.Вставить("attendees", СтрРазделить("1,10", ","));
    СтруктураСобытия.Вставить("host"     , 1);

        СтруктураВстречи = Новый Структура;
        СтруктураВстречи.Вставить("notify"      , "Y");
        СтруктураВстречи.Вставить("reinvite"    , "Y");
        СтруктураВстречи.Вставить("allow_invite", "N");
        СтруктураВстречи.Вставить("hide_guests" , "N");

    СтруктураСобытия.Вставить("meeting", СтруктураВстречи);

    Результат = OPI_Bitrix24.СоздатьСобытиеКалендаря(URL, СтруктураСобытия);

    URL         = "b24-ar17wx.bitrix24.by";
    Токен       = "8536b467006e9f06006b12e400000001000...";
    IDКалендаря = "364";

    СтруктураСобытия.Вставить("section", IDКалендаря);

    Результат = OPI_Bitrix24.СоздатьСобытиеКалендаря(URL, СтруктураСобытия, Токен);
    # JSON данные также могут быть переданы как путь к файлу .json
    
    oint bitrix24 СоздатьСобытиеКалендаря \
      --url "b24-ar17wx.bitrix24.by" \
      --fields "{'type':'user','ownerId':1,'from':'2025-02-19T12:37:07.9090548','to':'2025-02-19T13:37:07.9090548','section':376,'name':'Новое событие','skip_time':'N','timezone_from':'Europe/Minsk','timezone_to':'Europe/Minsk','description':'Описание события','color':'%23000000>','text_color':'%23FFFFFF','accessibility':'busy','importance':'high','private_event':'N','rrule':{'FREQ':'DAILY','COUNT':3,'INTERVAL':10,'BYDAY':['SA','MO'],'UNTIL':'2025-03-01T12:37:07.9090548'},'is_meeting':'Y','location':'Офис','remind':[{'type':'day','count':1}],'attendees':['1','10'],'host':1,'meeting':{'notify':'Y','reinvite':'Y','allow_invite':'N','hide_guests':'N'}}" \
      --token "***"
Результат
{
 "result": 30,
 "time": {
  "start": 1737893979.47614,
  "finish": 1737893979.69477,
  "duration": 0.218628883361816,
  "processing": 0.192880868911743,
  "date_start": "2025-01-26T15:19:39+03:00",
  "date_finish": "2025-01-26T15:19:39+03:00",
  "operating_reset_at": 1737894579,
  "operating": 0.192862033843994
 }
}