Calendly
Типы встреч, слоты и отмена событий Calendly в процессах Pailot
Calendly — сервис записи на встречи: типы событий, слоты и приглашённые. Блок ходит в API (Application Programming Interface — программный интерфейс) по Personal Access Token (персональный токен доступа).
С Calendly в Pailot вы можете:
- Смотреть текущего пользователя, типы встреч и запланированные события
- Читать детали типа встречи и конкретного слота
- Получать список приглашённых и отменять событие
- Запускать процесс по вебхуку (входящему HTTP-запросу): запись, отмена, форма маршрутизации
Нужен персональный токен доступа Calendly. Блок ставят на холст как отдельный шаг или прикрепляют к агенту. Токен — в переменных окружения рабочего пространства. Если включён триггер — не публикуйте URL вебхука.
Данные текущего авторизованного пользователя Calendly.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Персональный токен доступа Calendly |
| Параметр | Тип | Описание |
|---|
resource | object | Данные текущего пользователя |
↳ uri | string | Каноническая ссылка на пользователя |
↳ name | string | Полное имя |
↳ slug | string | Уникальный идентификатор в URL |
↳ email | string | Адрес электронной почты |
↳ scheduling_url | string | Страница записи пользователя |
↳ timezone | string | Часовой пояс |
↳ avatar_url | string | URL аватара |
↳ created_at | string | Когда пользователя создали (ISO) |
↳ updated_at | string | Когда пользователя обновляли (ISO) |
↳ current_organization | string | URI текущей организации |
Список типов встреч пользователя или организации.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Персональный токен доступа Calendly |
user | string | Нет | Только типы встреч этого пользователя (формат URI) |
organization | string | Нет | Только типы встреч этой организации (формат URI) |
count | number | Нет | Результатов на страницу (по умолчанию 20, максимум 100) |
pageToken | string | Нет | Токен следующей страницы |
sort | string | Нет | Сортировка (например, name:asc, name:desc) |
active | boolean | Нет | true — только активные типы; иначе — все |
| Параметр | Тип | Описание |
|---|
collection | array | Массив типов встреч |
↳ uri | string | Каноническая ссылка на тип встречи |
↳ name | string | Название типа встречи |
↳ active | boolean | Тип встречи активен |
↳ booking_method | string | Способ записи |
↳ color | string | Цвет в hex |
↳ created_at | string | Когда создали (ISO) |
↳ description_html | string | Описание в HTML |
↳ description_plain | string | Описание обычным текстом |
↳ duration | number | Длительность в минутах |
↳ scheduling_url | string | Страница записи |
↳ slug | string | Уникальный идентификатор в URL |
↳ type | string | Классификация типа встречи |
↳ updated_at | string | Когда обновляли (ISO) |
pagination | object | Постраничный вывод |
↳ count | number | Число результатов на этой странице |
↳ next_page | string | URL следующей страницы (если есть) |
↳ previous_page | string | URL предыдущей страницы (если есть) |
↳ next_page_token | string | Токен следующей страницы |
↳ previous_page_token | string | Токен предыдущей страницы |
Карточка конкретного типа встречи.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Персональный токен доступа Calendly |
eventTypeUuid | string | Да | UUID типа встречи (полный URI или только UUID) |
| Параметр | Тип | Описание |
|---|
resource | object | Детали типа встречи |
↳ uri | string | Каноническая ссылка на тип встречи |
↳ name | string | Название типа встречи |
↳ active | boolean | Тип встречи активен |
↳ booking_method | string | Способ записи |
↳ color | string | Цвет в hex |
↳ created_at | string | Когда создали (ISO) |
↳ custom_questions | array | Вопросы для приглашённых |
↳ name | string | Текст вопроса |
↳ type | string | Тип вопроса (text, single_select, multi_select и др.) |
↳ position | number | Порядок вопроса |
↳ enabled | boolean | Вопрос включён |
↳ required | boolean | Вопрос обязателен |
↳ answer_choices | array | Варианты ответа |
↳ type | string | Классификация типа встречи |
↳ position | number | Порядок вопроса |
↳ enabled | boolean | Вопрос включён |
↳ required | boolean | Вопрос обязателен |
↳ answer_choices | array | Варианты ответа |
↳ description_html | string | Описание в HTML |
↳ description_plain | string | Описание обычным текстом |
↳ duration | number | Длительность в минутах |
↳ scheduling_url | string | Страница записи |
↳ slug | string | Уникальный идентификатор в URL |
↳ updated_at | string | Когда обновляли (ISO) |
Список запланированных событий пользователя или организации.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Персональный токен доступа Calendly |
user | string | Нет | События этого пользователя (формат URI). Нужен user или organization |
organization | string | Нет | События этой организации (формат URI). Нужен user или organization |
invitee_email | string | Нет | События, где у приглашённого этот email |
count | number | Нет | Результатов на страницу (по умолчанию 20, максимум 100) |
max_start_time | string | Нет | События, которые начинаются до этого времени (ISO 8601) |
min_start_time | string | Нет | События, которые начинаются после этого времени (ISO 8601) |
pageToken | string | Нет | Токен следующей страницы |
sort | string | Нет | Сортировка (например, start_time:asc, start_time:desc) |
status | string | Нет | Фильтр статуса (active или canceled) |
| Параметр | Тип | Описание |
|---|
collection | array | Массив запланированных событий |
↳ uri | string | Каноническая ссылка на событие |
↳ name | string | Название события |
↳ status | string | Статус (active или canceled) |
↳ start_time | string | Начало (ISO) |
↳ end_time | string | Конец (ISO) |
↳ event_type | string | URI типа встречи |
↳ location | string | Описание места |
↳ type | string | Тип места |
↳ join_url | string | Ссылка на онлайн-встречу (если есть) |
↳ invitees_counter | object | Счётчики приглашённых |
↳ total | number | Всего приглашённых |
↳ active | number | Активных приглашённых |
↳ limit | number | Максимум приглашённых |
↳ total | number | Всего приглашённых |
↳ active | number | Активных приглашённых |
↳ limit | number | Максимум приглашённых |
↳ created_at | string | Когда событие создали (ISO) |
↳ updated_at | string | Когда обновляли (ISO) |
pagination | object | Постраничный вывод |
↳ count | number | Число результатов на этой странице |
↳ next_page | string | URL следующей страницы (если есть) |
↳ previous_page | string | URL предыдущей страницы (если есть) |
↳ next_page_token | string | Токен следующей страницы |
↳ previous_page_token | string | Токен предыдущей страницы |
Карточка запланированного события.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Персональный токен доступа Calendly |
eventUuid | string | Да | UUID события (полный URI или только UUID) |
| Параметр | Тип | Описание |
|---|
resource | object | Детали события |
↳ uri | string | Каноническая ссылка на событие |
↳ name | string | Название события |
↳ status | string | Статус (active или canceled) |
↳ start_time | string | Начало (ISO) |
↳ end_time | string | Конец (ISO) |
↳ event_type | string | URI типа встречи |
↳ location | string | Описание места |
↳ type | string | Тип места |
↳ join_url | string | Ссылка на онлайн-встречу |
↳ invitees_counter | object | Счётчики приглашённых |
↳ total | number | Всего приглашённых |
↳ active | number | Активных приглашённых |
↳ limit | number | Максимум приглашённых |
↳ total | number | Всего приглашённых |
↳ active | number | Активных приглашённых |
↳ limit | number | Максимум приглашённых |
↳ event_memberships | array | Ведущие / участники |
↳ user | string | URI пользователя |
↳ user_email | string | Email пользователя |
↳ user_name | string | Имя пользователя |
↳ user | string | URI пользователя |
↳ user_email | string | Email пользователя |
↳ user_name | string | Имя пользователя |
↳ event_guests | array | Дополнительные гости |
↳ email | string | Email гостя |
↳ created_at | string | Когда гостя добавили |
↳ updated_at | string | Когда данные гостя обновляли |
↳ email | string | Email гостя |
↳ created_at | string | Когда событие создали (ISO) |
↳ updated_at | string | Когда обновляли (ISO) |
Список приглашённых на запланированное событие.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Персональный токен доступа Calendly |
eventUuid | string | Да | UUID события (полный URI или только UUID) |
count | number | Нет | Результатов на страницу (по умолчанию 20, максимум 100) |
email | string | Нет | Фильтр по email приглашённого |
pageToken | string | Нет | Токен следующей страницы |
sort | string | Нет | Сортировка (например, created_at:asc, created_at:desc) |
status | string | Нет | Фильтр статуса (active или canceled) |
| Параметр | Тип | Описание |
|---|
collection | array | Массив приглашённых |
↳ uri | string | Каноническая ссылка на приглашённого |
↳ email | string | Email приглашённого |
↳ name | string | Полное имя |
↳ first_name | string | Имя |
↳ last_name | string | Фамилия |
↳ status | string | Статус (active или canceled) |
↳ questions_and_answers | array | Ответы на дополнительные вопросы |
↳ question | string | Текст вопроса |
↳ answer | string | Ответ |
↳ position | number | Порядок вопроса |
↳ question | string | Текст вопроса |
↳ answer | string | Ответ |
↳ position | number | Порядок вопроса |
↳ timezone | string | Часовой пояс приглашённого |
↳ event | string | URI запланированного события |
↳ created_at | string | Когда приглашённого создали (ISO) |
↳ updated_at | string | Когда обновляли (ISO) |
↳ cancel_url | string | Ссылка для отмены записи |
↳ reschedule_url | string | Ссылка для переноса записи |
↳ rescheduled | boolean | Приглашённый перенёс встречу |
pagination | object | Постраничный вывод |
↳ count | number | Число результатов на этой странице |
↳ next_page | string | URL следующей страницы (если есть) |
↳ previous_page | string | URL предыдущей страницы (если есть) |
↳ next_page_token | string | Токен следующей страницы |
↳ previous_page_token | string | Токен предыдущей страницы |
Отменить запланированное событие.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Персональный токен доступа Calendly |
eventUuid | string | Да | UUID события для отмены (полный URI или только UUID) |
reason | string | Нет | Причина отмены (уйдёт приглашённым) |
| Параметр | Тип | Описание |
|---|
resource | object | Данные отмены |
↳ canceler_type | string | Кто отменил (host или invitee) |
↳ canceled_by | string | Имя того, кто отменил |
↳ reason | string | Причина отмены |
↳ created_at | string | Когда событие отменили (ISO) |
