Cal.com으로 예약하기

캘린더 연결#

에이전트 → 작업 → Cal.com을 여세요. cal_로 시작하는 Cal.com API 키, 양의 정수 이벤트 유형 ID, Asia/Seoul 같은 IANA 시간대를 입력하고 연결 저장을 누르세요. 에이전트마다 별도 연결을 사용합니다. 키는 서버에서 암호화되며 대시보드에는 마지막 네 글자만 표시됩니다. 기존 연결을 수정할 때 키를 비워 두면 현재 키를 유지합니다.

연결 테스트는 입력한 설정으로 앞으로 7일 동안의 가능한 시간 중 최대 3개를 조회합니다. 연결을 저장하거나 예약을 만들지 않습니다. 빈 결과는 해당 기간에 가능한 시간이 없다는 뜻일 수 있습니다. 실패하면 Cal.com의 키, 이벤트 유형, 일정을 확인하세요. 연결을 삭제하면 새 Cal.com 예약을 중단하지만 기존 예약은 취소하지 않습니다.

결제는 범위 밖입니다. Google Calendar는 아직 일반 제공되지 않는 별도 옵션입니다.

시간 선택부터 예약까지#

1. 에이전트가 find_slots로 실제 미래의 가능한 시간을 조회하고 설정된 시간대로 최대 8개를 보여 줍니다. 기본 조회 범위는 오늘부터 7일 뒤까지이며 최대 날짜 간격은 14일입니다. 하나만 있으면 그 시간만 표시합니다.
2. 고객이 시간을 고르고 이름, 이메일, 선택적 메모를 제공합니다. 에이전트는 이 대화에 제시했던 시간인지, 아직 가능한지 다시 확인합니다. 시간 제안의 유효 기간은 15분입니다.
3. 확인 카드에 날짜, 시간, 시간대, 참석자 정보가 표시됩니다. 고객이 확인을 눌러야 합니다. 채팅 메시지나 시간 선택만으로는 예약하지 않습니다. 예약 제안은 15분 후 만료되며 시간을 선점하지 않습니다.
4. 확인 후에만 Cal.com에 예약을 요청합니다. accepted는 done으로 표시되며 예약 UID를 참조 번호로 제공합니다. pending과 awaiting_host는 대기 상태로, 거절·취소는 실패로 처리합니다.

메시징 채널의 예약 제안은 개인 채팅에서만 가능합니다. 리허설은 Cal.com을 호출하거나 예약을 생성하지 않습니다. Cal.com 연결이 없으면 기존 예약 요청 흐름을 사용하며, 이는 캘린더 예약 완료를 뜻하지 않습니다. 키·이벤트 유형·시간대를 바꾸면 기존 제안의 실행 대상이 무효화되므로 새로 시작하세요.

시간이 이미 예약됐거나 결과가 불확실한 경우#

확인이 끝나기 전에 다른 고객이 시간을 예약할 수 있습니다. 더 이상 가능한 시간이 아니면 사용할 수 없다고 안내하며, 예약 생성 중 Cal.com이 거절하면 실패 결과를 표시합니다. 새로운 시간을 요청하고 새 제안을 확인하세요. 실패 카드에 새 선택지가 자동으로 붙지는 않습니다.

네트워크 시간 초과는 성공이나 실패의 증거가 아닙니다. 서비스가 다시 확인하는 동안 결과는 불확실한 상태로 표시됩니다. Cal.com의 생성 엔드포인트에는 문서화된 멱등성 키 규약이 없으므로 실행 ID를 metadata.maf_run에 저장하고, 재생성 전에 모든 상태와 페이지에서 해당 예약을 찾습니다. 조회가 끝나지 않으면 새 생성 요청을 허용하지 않습니다. 중복 위험을 줄이지만 제공자가 보장하는 정확히 한 번 실행은 아닙니다. 재시도 소진 후 새 예약을 만들기 전에 Cal.com을 확인하세요.

Cal.com 호스트 승인은 사용자 정의 변경 작업의 소유자 승인과 별개입니다. 이 연동은 대기 중인 Cal.com 예약 상태를 자동 갱신하지 않으므로 최종 상태는 Cal.com에서 확인하세요. 웹 위젯은 저장된 실행 결과를 조회하고, 지원되는 개인 채널은 대화 가능 시간 내에서 지연 결과를 받습니다. 결과 전달을 참고하세요.

API 버전과 출시 전 확인#

어댑터는 Bearer 인증과 엔드포인트별 cal-api-version을 사용합니다. 다음 값은 2026-10-13 공식 문서와 대조했습니다.

고객에게 제공하기 전에 통제 가능한 예약을 만들고 Cal.com에서 UID를 확인하세요. 이미 예약된 시간도 시험하고 사용할 각 채널의 결과 전달을 확인하세요. 연결 테스트 성공은 시간 조회만 증명하며 실제 예약이나 운영 준비 완료를 증명하지 않습니다.