Создать событие в календаре
Робот «Создать событие в календаре» добавляет событие в календарь выбранного сотрудника в бизнес-процессах и роботах Битрикс24. Принимает название, дату и время начала, длительность в минутах, описание, место, участников и напоминание; умеет ставить событие на весь день. Возвращает признак «Успешно» Y/N, ID созданного события и текст ошибки.
Робот ставит встречу или напоминание прямо в календарь сотрудника, не открывая календарь руками. Владелец календаря — любой сотрудник, например ответственный по сделке. Начало задаётся датой и временем, в том числе из поля карточки или выражения «сейчас плюс день»; длительность — в минутах, по умолчанию час. Можно поставить событие на весь день, добавить описание и место проведения. Если указать участников, событие становится встречей и участники получают приглашение. Напоминание задаётся числом минут до начала. Время понимается так же, как в конструкторе бизнес-процессов. Типовые случаи применения: назначить менеджеру звонок клиенту на завтра; поставить встречу с клиентом после перехода сделки на стадию «Презентация»; отметить в календаре дату окончания договора. Возвращает «Успешно» Y/N, ID события — по нему событие можно найти или удалить — и текст ошибки.
Какие параметры принимает робот?
| Параметр | Тип | Обязательный? | По умолчанию |
|---|---|---|---|
| Чей календарь | user | да | |
| Название события | string | да | |
| Начало | datetime | да | |
| Длительность, минут (по умолчанию 60) | int | — | 60 |
| Весь день | bool | — | N |
| Описание | text | — | |
| Участники (приглашения) | user | — | |
| Место проведения | string | — | |
| Напомнить за, минут | int | — |
Что возвращает робот?
| Параметр | Тип |
|---|---|
| Успешно (Y/N) | string |
| ID события | int |
| Ошибка | string |
Какие ошибки может вернуть робот?
Эти сообщения робот пишет в журнал бизнес-процесса, когда не может выполнить шаг. По тексту видно, что исправить в настройках или данных.
- Ошибка: не выбран владелец календаря (отделы и группы не поддерживаются)
- Ошибка: пустое название события
- Ошибка: не удалось разобрать дату начала «{value}»
- Ошибка календаря: {message}
Сценарий: встреча после квалификации
- Сделка переходит на стадию «Встреча назначена», в карточке заполнена дата встречи
- Робот создаёт в календаре ответственного событие на эту дату длительностью 90 минут и приглашает руководителя
- За 30 минут до начала оба получают напоминание