Cal.com — это гибкая и открытая платформа для планирования встреч, которая упрощает управление назначениями, бронированиями, типами событий и доступностью команд.
С помощью Cal.com вы можете:
- Автоматизировать планирование: Позволить пользователям просматривать доступные временные слоты и бронировать встречи автоматически, без переписки по электронной почте.
- Управлять событиями: Создавать и настраивать типы событий, продолжительность и правила для индивидуальных или групповых встреч.
- Интегрировать календари: Бесшовно подключаться к Google, Outlook, Apple или другим поставщикам календарей, чтобы избежать двойного бронирования.
- Обрабатывать участников и гостей: Собирать информацию об участниках, управлять гостями и отправлять приглашения или напоминания.
- Контролировать доступность: Определять пользовательские рабочие часы, буферное время и правила отмены/перебронирования.
- Запускать рабочие процессы: Активировать пользовательские действия через вебхуки при создании, отмене или переносе бронирования.
В AACFlow интеграция с Cal.com позволяет вашим агентам бронировать встречи, проверять доступность, управлять типами событий и автоматизировать задачи планирования программно. Это помогает агентам координировать встречи, отправлять бронирования от имени пользователей, проверять расписания или реагировать на события бронирования — всё без ручного вмешательства. Подключив AACFlow к Cal.com, вы открываете высокоавтоматизированные и интеллектуальные рабочие процессы планирования, которые могут бесшовно интегрироваться с вашими более широкими потребностями в автоматизации.
Инструкции по использованию
Интегрируйте Cal.com в ваш рабочий процесс. Создавайте и управляйте бронированиями, типами событий, расписаниями и проверяйте доступные слоты. Поддерживает создание, просмотр списка, перенос и отмену бронирований, а также управление типами событий и расписаниями. Также может запускать рабочие процессы на основе событий вебхуков Cal.com (бронирование создано, отменено, перенесено). Подключите свой аккаунт Cal.com через OAuth.
Инструменты
calcom_create_booking
Создать новое бронирование в Cal.com
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
eventTypeId | number | Да | ID типа события для бронирования |
start | string | Да | Время начала в формате UTC ISO 8601 (например, 2024-01-15T09:00:00Z) |
attendee | object | Да | Объект с информацией об участнике с полями name, email, timeZone и опциональным phoneNumber (формируется из отдельных полей участника) |
guests | array | Нет | Массив адресов электронной почты гостей |
items | string | Нет | Адрес электронной почты гостя |
lengthInMinutes | number | Нет | Продолжительность бронирования в минутах (переопределяет значение по умолчанию для типа события) |
metadata | object | Нет | Пользовательские метаданные для прикрепления к бронированию |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
status | string | Статус ответа |
data | object | Детали созданного бронирования |
↳ eventType | object | Детали типа события |
↳ id | number | ID типа события |
↳ slug | string | Слаг типа события |
↳ attendees | array | Список участников |
↳ name | string | Имя участника |
↳ email | string | Фактический адрес электронной почты участника |
↳ displayEmail | string | Электронная почта, отображаемая публично (может отличаться от фактической) |
↳ timeZone | string | Часовой пояс участника (формат IANA) |
↳ phoneNumber | string | Номер телефона участника |
↳ language | string | Языковые предпочтения участника (код ISO) |
↳ absent | boolean | Был ли участник отсутствующим |
↳ hosts | array | Список организаторов |
↳ id | number | ID пользователя-организатора |
↳ name | string | Отображаемое имя организатора |
↳ email | string | Фактический адрес электронной почты организатора |
↳ displayEmail | string | Электронная почта, отображаемая публично (может отличаться от фактической) |
↳ username | string | Имя пользователя Cal.com организатора |
↳ timeZone | string | Часовой пояс организатора (формат IANA) |
↳ id | number | Числовой ID бронирования |
↳ uid | string | Уникальный идентификатор бронирования |
↳ title | string | Название бронирования |
↳ status | string | Статус бронирования (например, accepted, pending, cancelled) |
↳ start | string | Время начала в формате ISO 8601 |
↳ end | string | Время окончания в формате ISO 8601 |
↳ duration | number | Продолжительность в минутах |
↳ eventTypeId | number | ID типа события |
↳ meetingUrl | string | URL для присоединения к встрече |
↳ location | string | Место проведения бронирования |
↳ absentHost | boolean | Был ли организатор отсутствующим |
↳ guests | array | Адреса электронной почты гостей |
↳ bookingFieldsResponses | json | Ответы на пользовательские поля бронирования (динамические ключи на основе конфигурации типа события) |
↳ metadata | json | Пользовательские метаданные, прикрепленные к бронированию (динамические пары ключ-значение) |
↳ icsUid | string | UID календаря ICS |
↳ createdAt | string | Когда было создано бронирование |
calcom_get_booking
Получить детали конкретного бронирования по его UID
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
bookingUid | string | Да | Уникальный идентификатор (UID) бронирования |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
status | string | Статус ответа |
data | object | Детали бронирования |
↳ eventType | object | Детали типа события |
↳ id | number | ID типа события |
↳ slug | string | Слаг типа события |
↳ attendees | array | Список участников |
↳ name | string | Имя участника |
↳ email | string | Фактический адрес электронной почты участника |
↳ displayEmail | string | Электронная почта, отображаемая публично (может отличаться от фактической) |
↳ timeZone | string | Часовой пояс участника (формат IANA) |
↳ phoneNumber | string | Номер телефона участника |
↳ language | string | Языковые предпочтения участника (код ISO) |
↳ absent | boolean | Был ли участник отсутствующим |
↳ hosts | array | Список организаторов |
↳ id | number | ID пользователя-организатора |
↳ name | string | Отображаемое имя организатора |
↳ email | string | Фактический адрес электронной почты организатора |
↳ displayEmail | string | Электронная почта, отображаемая публично (может отличаться от фактической) |
↳ username | string | Имя пользователя Cal.com организатора |
↳ timeZone | string | Часовой пояс организатора (формат IANA) |
↳ id | number | Числовой ID бронирования |
↳ uid | string | Уникальный идентификатор бронирования |
↳ title | string | Название бронирования |
↳ description | string | Описание бронирования |
↳ status | string | Статус бронирования (например, accepted, pending, cancelled) |
↳ start | string | Время начала в формате ISO 8601 |
↳ end | string | Время окончания в формате ISO 8601 |
↳ duration | number | Продолжительность в минутах |
↳ eventTypeId | number | ID типа события |
↳ meetingUrl | string | URL для присоединения к встрече |
↳ location | string | Место проведения бронирования |
↳ absentHost | boolean | Был ли организатор отсутствующим |
↳ guests | array | Адреса электронной почты гостей |
↳ bookingFieldsResponses | json | Ответы на пользовательские поля бронирования (динамические ключи на основе конфигурации типа события) |
↳ metadata | json | Пользовательские метаданные, прикрепленные к бронированию (динамические пары ключ-значение) |
↳ rating | number | Рейтинг бронирования |
↳ icsUid | string | UID календаря ICS |
↳ cancellationReason | string | Причина отмены, если отменено |
↳ reschedulingReason | string | Причина переноса, если перенесено |
↳ rescheduledFromUid | string | Исходный UID бронирования, если это бронирование было перенесено |
↳ rescheduledToUid | string | Новый UID бронирования после переноса |
↳ cancelledByEmail | string | Электронная почта лица, отменившего бронирование |
↳ rescheduledByEmail | string | Электронная почта лица, перенесшего бронирование |
↳ createdAt | string | Когда было создано бронирование |
↳ updatedAt | string | Когда бронирование было последний раз обновлено |
calcom_list_bookings
Показать все бронирования с опциональной фильтрацией по статусу
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
status | string | Нет | Фильтровать бронирования по статусу: upcoming, recurring, past, cancelled или unconfirmed |
take | number | Нет | Количество бронирований для возврата (лимит пагинации) |
skip | number | Нет | Количество бронирований для пропуска (смещение пагинации) |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
status | string | Статус ответа |
data | array | Массив бронирований |
↳ eventType | object | Детали типа события |
↳ id | number | ID типа события |
↳ slug | string | Слаг типа события |
↳ attendees | array | Список участников |
↳ name | string | Имя участника |
↳ email | string | Фактический адрес электронной почты участника |
↳ displayEmail | string | Электронная почта, отображаемая публично (может отличаться от фактической) |
↳ timeZone | string | Часовой пояс участника (формат IANA) |
↳ phoneNumber | string | Номер телефона участника |
↳ language | string | Языковые предпочтения участника (код ISO) |
↳ absent | boolean | Был ли участник отсутствующим |
↳ hosts | array | Список организаторов |
↳ id | number | ID пользователя-организатора |
↳ name | string | Отображаемое имя организатора |
↳ email | string | Фактический адрес электронной почты организатора |
↳ displayEmail | string | Электронная почта, отображаемая публично (может отличаться от фактической) |
↳ username | string | Имя пользователя Cal.com организатора |
↳ timeZone | string | Часовой пояс организатора (формат IANA) |
↳ id | number | Числовой ID бронирования |
↳ uid | string | Уникальный идентификатор бронирования |
↳ title | string | Название бронирования |
↳ description | string | Описание бронирования |
↳ status | string | Статус бронирования (например, accepted, pending, cancelled) |
↳ start | string | Время начала в формате ISO 8601 |
↳ end | string | Время окончания в формате ISO 8601 |
↳ duration | number | Продолжительность в минутах |
↳ eventTypeId | number | ID типа события |
↳ meetingUrl | string | URL для присоединения к встрече |
↳ location | string | Место проведения бронирования |
↳ absentHost | boolean | Был ли организатор отсутствующим |
↳ guests | array | Адреса электронной почты гостей |
↳ bookingFieldsResponses | json | Ответы на пользовательские поля бронирования (динамические ключи на основе конфигурации типа события) |
↳ metadata | json | Пользовательские метаданные, прикрепленные к бронированию (динамические пары ключ-значение) |
↳ rating | number | Рейтинг бронирования |
↳ icsUid | string | UID календаря ICS |
↳ cancellationReason | string | Причина отмены, если отменено |
↳ cancelledByEmail | string | Электронная почта лица, отменившего бронирование |
↳ reschedulingReason | string | Причина переноса, если перенесено |
↳ rescheduledByEmail | string | Электронная почта лица, перенесшего бронирование |
↳ rescheduledFromUid | string | Исходный UID бронирования, если это бронирование было перенесено |
↳ rescheduledToUid | string | Новый UID бронирования после переноса |
↳ createdAt | string | Когда было создано бронирование |
↳ updatedAt | string | Когда бронирование было последний раз обновлено |
постраничная выборка | object | Метаданные пагинации |
↳ totalItems | number | Общее количество элементов |
↳ remainingItems | number | Оставшиеся элементы после текущей страницы |
↳ returnedItems | number | Количество элементов, возвращенных в этом ответе |
↳ itemsPerPage | number | Элементов на странице |
↳ currentPage | number | Номер текущей страницы |
↳ totalPages | number | Общее количество страниц |
↳ hasNextPage | boolean | Есть ли следующая страница |
↳ hasPreviousPage | boolean | Есть ли предыдущая страница |