Событие в календаре компании из бизнес-процесса

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

Создание календаря мероприятий

Перейдите в Календарь компании и нажмите Календари —> Добавить.

Теперь нам нужно посмотреть ID секции календаря, чтобы создавать событие именно в нем. Для этого нажмите на название нужного календаря правой клавишей мыши и выберите Просмотреть код.

И ищем data-bx-calendar-section. В данном случае 11.

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

Переходим в Роботы сделок, находим нужную стадию и создаем/дополняем процесс.

Добавляем действие Событие календаря.

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

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

Заголовок — Событие календаря;
Тип календаря (не обязательно) — [company_calendar];
ID владельца календаря (не обязательно) — оставляем пустым;
ID секции календаря (не обязательно) — 11 (мы выяснили секцию после создания календаря);
Пользователь — {{Ответственный}};
Название события — Сделка №{{ID}}, {{ПОВОД ДЛЯ МЕРОПРИЯТИЯ}}, тариф {{ТАРИФ УЧАСТИЯ (текст)}};
Описание события — Сделка №[url=/crm/deal/details/{{ID}}/]{{ID}}[/url], {{ПОВОД ДЛЯ МЕРОПРИЯТИЯ}},
Тариф {{ТАРИФ УЧАСТИЯ (текст)}} {{Прайс-лист > printable}},
Количество участников {{КОЛИЧЕСТВО УЧАСТНИКОВ}},
Сумма предоплаты {{Предоплата 30% > printable}};
Дата начала — {{ДАТА И ВРЕМЯ МЕРОПРИЯТИЯ}};
Дата окончания — {=Variable:DateEnd};
Часовой пояс — выберите ваш часовой пояс.

Тип календаря может быть:

[company_calendar] — Календари компании;
[group] — Календари групп;
[user] — Календари пользователей.

ID владельца календаря

Если тип календаря [user], то указывается ID пользователя, в чьем календаре будет создано событие;

Если тип календаря [group], в поле указывается ID группы.

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

В Пользователя можно добавить несколько сотрудников, но не в случае с календарем компании, там эта опция пока не поддерживается.

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

Событие появляется в календаре мероприятий.

Сделка и тариф (поле типа файл в сделке) кликабельны.

Вебхук

Событие в календаре также можно создать вебхуком.

Для создания вебхука перейдите Разработчикам —> Другое —> Входящий вебхук.

В настройках вебхука укажите название, метод calendar.event.add, выдайте права Календарь (calendar).

Все параметры метода можно посмотреть тут.

Сохраните и скопируйте Вебхук для вызова rest api.

В бизнес-процессе используем действие Исходящий вебхук.

Исходящий Вебхук

Действие Исходящий Вебхук.

Заголовок — Исходящий Вебхук: Событие в календарь;
Хендлер — https://адрес_портала/rest/ID_пользователя/токен/calendar.event.add.json?type=company_calendar&ownerId=” “&name=Сделка №{{ID}}, {{ПОВОД ДЛЯ МЕРОПРИЯТИЯ}}, тариф {{ТАРИФ УЧАСТИЯ (текст)}}&from={{ДАТА И ВРЕМЯ НАЧАЛА МЕРОПРИЯТИЯ}}&to={{=dateadd({{ДАТА И ВРЕМЯ НАЧАЛА МЕРОПРИЯТИЯ}}, “2h 30i”)}}&section=11&description=Сделка №[url=/crm/deal/details/{{ID}}/]{{ID}}[/url], {{ПОВОД ДЛЯ МЕРОПРИЯТИЯ}}, Тариф {{ТАРИФ УЧАСТИЯ (текст)}} {{Прайс-лист > printable}}, Количество участников {{КОЛИЧЕСТВО УЧАСТНИКОВ}}, Сумма предоплаты {{Предоплата 30% > printable}}

Какие особенности при создании события в календаре компании? OwnerId обязательно нужно указать пробел или U_115, иначе будет ошибка CAL_REST_SECTION_ERROR

Для добавления участников добавьте:

&attendees[]={{Ответственный > int}}&attendees[]=359

(т.е. либо поле и переменную с параметром int, либо id пользователя числом).

В данном случае добавится ответственный и пользователь с id 359.

По информации от техподдержки Битрикса calendar.event.add на текущий момент не поддерживает добавление событий в календарь компании.