Calendly

• AI 에이전트가 미팅 시간을 제안하기 전에 사용자의 Calendly 가용성을 확인하도록 하려는 경우.
• 워크플로의 일부로 예약된 이벤트를 목록 조회, 검색 또는 취소해야 하는 경우.
• Calendly 웹훅을 설정하거나 관리(invitee.created, invitee.canceled)하여 예약 활동에 반응하는 자동화를 구축하는 경우.
• 알려진 이벤트 유형에 대해 초대자를 생성하여 프로그래밍 방식으로 미팅을 예약해야 하는 경우 (Calendly 유료 플랜 필요).

• 이벤트 유형을 생성하거나 수정해야 하는 경우 — Calendly API는 이를 지원하지 않으며, 이 스킬도 마찬가지입니다.
• 단일 요청에서 7일을 초과하는 가용성 기간이 필요한 경우 — 가용성 엔드포인트는 이 제한을 적용합니다.
• Calendly 무료 플랜을 사용 중이며 웹훅 또는 예약(초대 대상자 생성) API가 필요한 경우 — 해당 기능은 유료 플랜이 필요합니다.

모든 요청은 gateway.maton.ai를 통해 프록시되며, 이 게이트웨이가 자동으로 Calendly OAuth 토큰을 주입합니다. MATON_API_KEY로 한 번만 인증하면 OAuth 갱신 흐름을 직접 관리할 필요가 없습니다.

상태, 초대받은 사람의 이메일, 시간 범위, 사용자별 풍부한 필터링 기능을 통해 예약된 이벤트를 목록 조회, 검색 및 취소할 수 있습니다. page_token을 사용하여 대규모 결과 집합을 페이지별로 탐색하세요.

특정 이벤트 유형에 대한 가용 시간대를 조회하거나(/event_type_available_times), 사용자의 바쁜 시간 블록(/user_busy_times) 및 설정된 가용성 일정을 가져올 수 있습니다 — 요청당 최대 7일까지 지원합니다.

예약된 이벤트에 대한 초대받은 사람 목록을 조회하고 세부 정보를 확인하세요. 사전 질문에 대한 답변, 취소/일정 변경 URL, 추적 데이터 등을 포함합니다. 사용자를 대신하여 미팅을 예약하기 위해 프로그래밍 방식으로 초대받은 사람을 생성할 수 있습니다 (Calendly 유료 플랜 필요).

사용자 또는 조직 범위의 webhook 구독을 생성, 조회 및 삭제합니다. 지원되는 이벤트에는 invitee.created, invitee.canceled, routing_form_submission.created가 포함됩니다(유료 Calendly 플랜 필요).

하나의 MATON_API_KEY 아래에서 여러 Calendly OAuth 연결을 관리하세요. Maton-Connection 헤더를 사용하여 요청별로 특정 연결을 지정하거나, 게이트웨이가 기본 활성 연결을 사용하도록 설정할 수 있습니다.

에이전트가 향후 5일간 사용자의 Calendly 가능 슬롯을 확인하고, 채팅 인터페이스에서 옵션을 제시한 후, 초대 대상자를 생성하여 선택한 슬롯을 예약합니다 — 사용자가 대화를 벗어날 필요 없이 모든 과정이 진행됩니다.

일별 자동화를 통해 영업 팀의 모든 활성 예약 이벤트를 가져오고, 초대된 참석자의 세부 정보 및 사전 답변으로 내용을 보강한 후, 구조화된 브리핑을 Slack 또는 CRM에 게시합니다.

조직에서 invitee.created 및 invitee.canceled 이벤트에 대한 웹훅을 등록한 다음, 예약이 변경될 때마다 다운스트림 작업(확인 이메일 발송, 데이터베이스 업데이트, Slack 채널 알림)을 트리거합니다.

반복 작업이나 알림을 자동으로 예약하기 전에, 에이전트는 user_busy_times를 조회하여 기존 캘린더 일정과의 충돌을 방지한 다음, 사용자의 가용 일정에 맞는 빈 시간대를 선택합니다.