Calendly
Управление планированием и событиями Calendly
Calendly — популярная платформа автоматизации планирования, которая помогает легко бронировать встречи, события и назначения. С помощью Calendly команды и отдельные пользователи могут упростить планирование, сократить количество писем и автоматизировать задачи, связанные с событиями.
С интеграцией AACFlow Calendly ваши агенты могут:
- Получать информацию о вашем аккаунте и запланированных событиях: Используйте инструменты для получения информации о пользователе, типах событий и запланированных событиях для анализа или автоматизации.
- Управлять типами событий и планированием: Получать доступ и перечислять доступные типы событий для пользователей или организаций, получать детали о конкретных типах событий и отслеживать запланированные встречи и данные приглашенных.
- Автоматизировать последующие действия и рабочие процессы: Когда пользователи планируют, переносят или отменяют встречи, агенты AACFlow могут автоматически запускать соответствующие рабочие процессы — например, отправлять напоминания, обновлять CRM или уведомлять участников.
- Легко интегрироваться с помощью вебхуков: Настройте рабочие процессы AACFlow для реагирования на события вебхуков Calendly в реальном времени, включая случаи, когда приглашенные планируют, отменяют или взаимодействуют с формами маршрутизации.
Независимо от того, хотите ли вы автоматизировать подготовку к встречам, управлять приглашениями или запускать пользовательские рабочие процессы в ответ на активность планирования, инструменты Calendly в AACFlow предоставляют гибкий и безопасный доступ. Откройте новые возможности автоматизации, мгновенно реагируя на изменения в планировании — оптимизируя операции и коммуникации вашей команды.
Интегрируйте Calendly в ваш рабочий процесс. Управляйте типами событий, запланированными событиями, приглашенными и вебхуками. Также может запускать рабочие процессы на основе событий вебхуков Calendly (приглашенный запланировал, приглашенный отменил, форма маршрутизации отправлена). Требуется Personal Access Token.
Получить информацию о текущем аутентифицированном пользователе Calendly
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Calendly Personal Access Token |
| Параметр | Тип | Описание |
|---|
resource | object | Информация о текущем пользователе |
↳ uri | string | Каноническая ссылка на пользователя |
↳ name | string | Полное имя пользователя |
↳ slug | string | Уникальный идентификатор пользователя в URL |
↳ email | string | Адрес электронной почты пользователя |
↳ scheduling_url | string | URL страницы планирования пользователя |
↳ timezone | string | Часовой пояс пользователя |
↳ avatar_url | string | URL изображения аватара пользователя |
↳ created_at | string | Временная метка ISO создания пользователя |
↳ updated_at | string | Временная метка ISO последнего обновления пользователя |
↳ current_organization | string | URI текущей организации |
Получить список всех типов событий для пользователя или организации
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Calendly Personal Access Token |
user | string | Нет | Возвращать только типы событий, принадлежащие этому пользователю. Формат: URI (например, "https://api.calendly.com/users/abc123-def456") |
organization | string | Нет | Возвращать только типы событий, принадлежащие этой организации. Формат: URI (например, "https://api.calendly.com/organizations/abc123-def456") |
count | number | Нет | Количество результатов на странице. Формат: целое число (по умолчанию: 20, максимум: 100) |
pageToken | string | Нет | Токен страницы для пагинации. Формат: непрозрачная строка из предыдущего ответа next_page_token |
sort | string | Нет | Порядок сортировки результатов. Формат: "поле:направление" (например, "name:asc", "name:desc") |
active | boolean | Нет | Когда true, показывать только активные типы событий. Когда false или не отмечено, показывать все типы событий (как активные, так и неактивные). |
| Параметр | Тип | Описание |
|---|
collection | array | Массив объектов типов событий |
↳ uri | string | Каноническая ссылка на тип события |
↳ name | string | Название типа события |
↳ active | boolean | Активен ли тип события |
↳ booking_method | string | Метод бронирования (например, "round_robin_or_collect", "collective") |
↳ color | string | Шестнадцатеричный код цвета |
↳ created_at | string | Временная метка ISO создания |
↳ description_html | string | Описание в формате HTML |
↳ description_plain | string | Описание в виде обычного текста |
↳ duration | number | Продолжительность в минутах |
↳ scheduling_url | string | URL страницы планирования |
↳ slug | string | Уникальный идентификатор для URL |
↳ type | string | Классификация типа события |
↳ updated_at | string | Временная метка ISO последнего обновления |
постраничная выборка | object | Информация о пагинации |
↳ count | number | Количество результатов на этой странице |
↳ next_page | string | URL следующей страницы (если доступен) |
↳ previous_page | string | URL предыдущей страницы (если доступен) |
↳ next_page_token | string | Токен для следующей страницы |
↳ previous_page_token | string | Токен для предыдущей страницы |
Получить подробную информацию о конкретном типе события
| Параметр | Тип | Описание |
|---|
resource | object | Детали типа события |
↳ uri | string | Каноническая ссылка на тип события |
↳ name | string | Название типа события |
↳ active | boolean | Активен ли тип события |
↳ booking_method | string | Метод бронирования |
↳ color | string | Шестнадцатеричный код цвета |
↳ 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 | Доступные варианты ответов |
↳ description_html | string | Описание в формате HTML |
↳ description_plain | string | Описание в виде обычного текста |
↳ duration | number | Продолжительность в минутах |
↳ scheduling_url | string | URL страницы планирования |
↳ slug | string | Уникальный идентификатор для URL |
↳ type | string | Классификация типа события |
↳ updated_at | string | Временная метка ISO последнего обновления |
Получить список запланированных событий для пользователя или организации
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Calendly Personal Access Token |
user | string | Нет | Возвращать события, принадлежащие этому пользователю. Должен быть предоставлен либо "user", либо "organization". Формат: URI (например, "https://api.calendly.com/users/abc123-def456") |
organization | string | Нет | Возвращать события, принадлежащие этой организации. Должен быть предоставлен либо "user", либо "organization". Формат: URI (например, "https://api.calendly.com/organizations/abc123-def456") |
invitee_email | string | Нет | Возвращать события, где у приглашенного есть этот email |
count | number | Нет | Количество результатов на странице. Формат: целое число (по умолчанию: 20, максимум: 100) |
max_start_time | string | Нет | Возвращать события со временем начала до этого времени. Формат: ISO 8601 (например, "2024-01-15T09:00:00Z") |
min_start_time | string | Нет | Возвращать события со временем начала после этого времени. Формат: ISO 8601 (например, "2024-01-01T00:00:00Z") |
pageToken | string | Нет | Токен страницы для пагинации. Формат: непрозрачная строка из предыдущего ответа next_page_token |
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 | object | Детали местоположения события |
↳ type | string | Тип местоположения (например, "zoom", "google_meet", "physical") |
↳ location | string | Описание местоположения |
↳ join_url | string | URL для присоединения к онлайн-встрече (если применимо) |
↳ invitees_counter | object | Информация о количестве приглашенных |
↳ total | number | Общее количество приглашенных |
↳ active | number | Количество активных приглашенных |
↳ limit | number | Максимальное количество приглашенных |
↳ created_at | string | Временная метка ISO создания события |
↳ updated_at | string | Временная метка ISO последнего обновления |
постраничная выборка | object | Информация о пагинации |
↳ count | number | Количество результатов на этой странице |
↳ next_page | string | URL следующей страницы (если доступен) |
↳ previous_page | string | URL предыдущей страницы (если доступен) |
↳ next_page_token | string | Токен для следующей страницы |
↳ previous_page_token | string | Токен для предыдущей страницы |
Получить подробную информацию о конкретном запланированном событии
| Параметр | Тип | Описание |
|---|
resource | object | Детали запланированного события |
↳ uri | string | Каноническая ссылка на событие |
↳ name | string | Название события |
↳ status | string | Статус события (active или canceled) |
↳ start_time | string | Временная метка ISO начала события |
↳ end_time | string | Временная метка ISO окончания события |
↳ event_type | string | URI типа события |
↳ location | object | Детали местоположения события |
↳ type | string | Тип местоположения |
↳ location | string | Описание местоположения |
↳ join_url | string | URL для присоединения к онлайн-встрече |
↳ invitees_counter | object | Информация о количестве приглашенных |
↳ total | number | Общее количество приглашенных |
↳ active | number | Количество активных приглашенных |
↳ limit | number | Максимальное количество приглашенных |
↳ event_memberships | array | Организаторы/участники события |
↳ user | string | URI пользователя |
↳ user_email | string | Email пользователя |
↳ user_name | string | Имя пользователя |
↳ event_guests | array | Дополнительные гости |
↳ email | string | Email гостя |
↳ created_at | string | Когда гость был добавлен |
↳ updated_at | string | Когда информация о госте была обновлена |
↳ created_at | string | Временная метка ISO создания события |
↳ updated_at | string | Временная метка ISO последнего обновления |
Получить список приглашенных для запланированного события
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Calendly Personal Access Token |
eventUuid | string | Да | UUID запланированного события. Формат: UUID (например, "abc123-def456") или полный URI (например, "https://api.calendly.com/scheduled_events/abc123-def456") |
count | number | Нет | Количество результатов на странице. Формат: целое число (по умолчанию: 20, максимум: 100) |
email | string | Нет | Фильтровать приглашенных по адресу электронной почты |
pageToken | string | Нет | Токен страницы для пагинации. Формат: непрозрачная строка из предыдущего ответа next_page_token |
sort | string | Нет | Порядок сортировки результатов. Формат: "поле:направление" (например, "created_at:asc", "created_at:desc") |
status | string | Нет | Фильтр по статусу. Формат: "active" или "canceled" |
| Параметр | Тип | Описание |
|---|
collection | array | Массив объектов приглашенных |
↳ uri | string | Каноническая ссылка на приглашенного |
↳ email | string | Адрес электронной почты приглашенного |
↳ name | string | Полное имя приглашенного |
↳ first_name | string | Имя приглашенного |
↳ last_name | string | Фамилия приглашенного |
↳ status | string | Статус приглашенного (active или canceled) |
↳ questions_and_answers | array | Ответы на пользовательские вопросы |
↳ question | string | Текст вопроса |
↳ answer | string | Ответ приглашенного |
↳ position | number | Порядок вопроса |
↳ timezone | string | Часовой пояс приглашенного |
↳ event | string | URI запланированного события |
↳ created_at | string | Временная метка ISO создания приглашенного |
↳ updated_at | string | Временная метка ISO обновления приглашенного |
↳ cancel_url | string | URL для отмены бронирования |
↳ reschedule_url | string | URL для переноса бронирования |
↳ rescheduled | boolean | Перенес ли приглашенный встречу |
постраничная выборка | object | Информация о пагинации |
↳ count | number | Количество результатов на этой странице |
↳ next_page | string | URL следующей страницы (если доступен) |
↳ previous_page | string | URL предыдущей страницы (если доступен) |
↳ next_page_token | string | Токен для следующей страницы |
↳ previous_page_token | string | Токен для предыдущей страницы |
Отменить запланированное событие
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Calendly Personal Access Token |
eventUuid | string | Да | UUID запланированного события для отмены. Формат: UUID (например, "abc123-def456") или полный URI (например, "https://api.calendly.com/scheduled_events/abc123-def456") |
reason | string | Нет | Причина отмены (будет отправлена приглашенным) |
| Параметр | Тип | Описание |
|---|
resource | object | Детали отмены |
↳ canceler_type | string | Тип отменяющего (host или invitee) |
↳ canceled_by | string | Имя человека, который отменил |
↳ reason | string | Причина отмены |
↳ created_at | string | Временная метка ISO, когда событие было отменено |
