Google Calendar

제공 상태와 기능 제한#

Google Calendar는 아직 일반 제공되지 않습니다. 활성화되기 전에는 에이전트 → 작업 → Google Calendar에 “출시 예정”이 표시되고 연결할 수 없으며, 에이전트 설정으로 켤 수 없습니다. Cal.com은 별도 옵션입니다.

캘린더 연결하기#

활성화된 경우 Google Calendar 패널에서 연결을 선택합니다. Google에 로그인하여 이벤트와 한가함·바쁨 정보 권한을 검토하세요. Make Agent Fast 로그인과 별도의 연결입니다. 갱신 토큰은 서버에서 암호화하며 대시보드와 에이전트에 전달하지 않습니다.

요청 범위는 calendar.events, calendar.freebusy, 비민감 범위인 openid와 email입니다. 콜백은 확인된 이메일을 요구하며, 이를 암호화해 저장하여 primary와 이메일로 지정한 동일 캘린더 ID를 일치시킵니다. 프로필 범위는 요청하지 않습니다. 확인된 이메일이 없는 기존 연결은 예약 전에 연결을 해제하고 다시 연결해야 합니다.

에이전트는 한 번에 하나의 캘린더 제공업체를 사용합니다. 변경 전 기존 연결을 해제하세요. 캘린더 ID(연결 계정의 기본 캘린더는 primary)와 Asia/Seoul 같은 IANA 시간대를 지정합니다. 공유 캘린더는 연결 계정에 접근 권한이 있어야 합니다. 연결 해제는 Google 권한과 연결을 제거하지만 기존 이벤트를 취소하지 않습니다.

업무 시간 설정하기#

새 연결에는 업무 시간이 없으므로 추가하기 전에는 예약 시간을 제시하지 않습니다. 각 요일의 시작·종료 시간을 추가하세요. 비어 있는 요일은 휴무이며, 겹치지 않는 여러 구간으로 점심시간을 제외할 수 있습니다. 선택한 시간대가 적용되며 설정은 자동 저장됩니다.

업무 시간에서 선택한 캘린더의 바쁜 시간, 여유 시간, 사전 예약 조건 및 예약 기간을 반영해 가용 시간을 계산합니다. 의도한 시간대와 필요 시 일광절약시간 전환을 확인하세요. 가용 시간이 없다는 것은 연결 오류가 아니라 휴무나 기존 일정 때문일 수 있습니다.

가용 시간에서 예약까지#

Cal.com과 같은 find_slots·book_slot 흐름으로 최대 8개의 시간을 제시하고 이름·이메일·선택 메모를 받은 뒤 가용 시간을 재확인하고 확인 카드를 표시합니다. 제시된 시간과 제안은 15분 뒤 만료되며 시간을 미리 확보하지 않습니다. 고객의 버튼 선택만 예약을 승인합니다. 실시간 통화에서 말로 “네”라고 해도 예약되지 않습니다.

확인 후 작업 실행 ID에 연결된 고정 이벤트 ID로 Google에 생성 요청을 보내고 참석자 초대를 전송합니다. 검증된 확정 이벤트만 완료로 표시하며 임시 이벤트는 대기 상태입니다. 시간이 먼저 예약되면 새 시간을 조회하고 다시 확인하세요. 통신 결과가 불명확하면 같은 이벤트 ID로 조회합니다. 시간 초과를 성공으로 간주하거나 확인 없이 중복 예약하지 마세요. 설정 변경은 기존 제시 시간·제안을 무효로 만듭니다.

시간이 났을 때 알림을 받으려면 동의한 감시를 사용하세요. 고객 제공 전 실제 Google 예약·초대, 이미 예약된 시간, 연결 해제·재연결과 사용할 메시징 채널을 검증하세요.