목차

캘린더 셋업 가이드

캘린더 연결하기

AiTalk의 AI가 예약을 잡거나 일정을 확인하려면, 여러분이 쓰시는 Google 캘린더 또는 Outlook(Microsoft) 캘린더와 한 번 연결해 두면 됩니다. 아래 순서를 그대로 따라 하시면 5~10분 안에 끝납니다.

왜 직접 연결하나요?

캘린더 일정은 여러분의 Google / Microsoft 계정 안에 그대로 있습니다. AiTalk은 일정을 따로 복사해 보관하지 않고, 예약을 만들거나 확인할 때만 여러분의 캘린더를 사용합니다.

그래서 처음 한 번, 여러분 계정에서 "AiTalk이 내 캘린더를 사용해도 좋다" 고 허용해 주는 설정이 필요합니다. 이 설정에서 만들어지는 값 두 개를 AiTalk 화면에 붙여넣으면 연결이 끝납니다.

무엇을 준비하나요?

연결에는 두 가지 값이 필요합니다 — AiTalk 화면에 있는 칸 이름 그대로입니다.

  • Client ID — 연결용 아이디
  • Client Secret — 연결용 비밀 값

그리고 Redirect URI라는 주소가 하나 필요한데, 이건 AiTalk 화면에 이미 표시되어 있으니 옆의 복사 버튼으로 복사만 하면 됩니다.

위 값들은 아래 안내대로 Google 또는 Microsoft 관리 화면에서 만듭니다. 어렵지 않으니 순서대로 따라오시면 됩니다.

Google 캘린더 연결하기

Google 캘린더는 Google Cloud라는 관리 화면에서 값을 만듭니다.

1. 프로젝트 만들기

2. 캘린더 기능 켜기

  • 상단 검색창에 Google Calendar API 를 검색해 들어간 뒤 사용(Enable) 버튼을 누릅니다.

3. 앱 정보와 권한 설정 (Google Auth Platform)

  • 왼쪽 메뉴에서 Google Auth Platform(옛 이름: OAuth consent screen)으로 이동해 시작(Get started)
  • Branding(브랜딩) 에 앱 이름, 지원 이메일 등 기본 정보를 입력해 저장
  • Audience(대상) 에서 사용자 유형을 고릅니다 — 대부분 External(외부), 회사에서 Google Workspace를 쓰시면 Internal(내부) 이 더 간단합니다
  • Data Access(데이터 액세스) → Add or Remove Scopes(범위 추가/삭제) 를 눌러 아래 캘린더 권한 두 가지를 붙여넣어 추가합니다 (전체 주소 그대로 입력하세요):
    • https://www.googleapis.com/auth/calendar.events.owned
    • https://www.googleapis.com/auth/calendar.readonly

4. 사용할 계정 등록 (External을 선택한 경우)

  • Audience(대상) 화면의 Test users(테스트 사용자) 에 본인과 직원들의 Gmail 주소를 추가합니다.
  • 여기에 등록된 계정만 연결할 수 있습니다. (안심하세요 — 계정을 등록해도 서로의 캘린더가 보이지는 않습니다. 각자 자기 것만 연결됩니다.)
  • Internal(회사 Workspace)로 만든 경우에는 이 단계가 없습니다.

5. 연결 값 만들기 (OAuth client ID)

  • 왼쪽 메뉴 Credentials(사용자 인증 정보) → Create Credentials → OAuth client ID
  • 종류(Application type)는 Web application(웹 애플리케이션) 선택
  • 이름은 아무거나 (예: "AiTalk")
  • Authorized redirect URIs 칸에 → AiTalk 화면의 Redirect URI를 복사 버튼으로 복사해 붙여넣기
  • 만들기(Create)를 누르면 Client ID와 Client Secret이 화면에 표시됩니다 → 복사해 둡니다.

6. AiTalk에 입력하고 연결

  • AiTalk의 Google Calendar 화면에 Client ID와 Client Secret을 붙여넣고 Save credentials(저장)
  • Connect Google Calendar 버튼을 누르면 Google 로그인 창이 뜹니다 → 위에서 등록한 계정으로 로그인 → 허용(Continue)
  • 완료! 이제 AI가 이 캘린더로 예약을 잡고 확인할 수 있습니다.

Outlook (Microsoft) 캘린더 연결하기

Outlook 캘린더는 Azure라는 Microsoft 관리 화면에서 값을 만듭니다.

1. 앱 등록하기

  • https://portal.azure.com 접속
  • 검색창에 App registrations 를 검색해 들어간 뒤 New registration(새 등록)
  • 이름은 아무거나 (예: "AiTalk 캘린더")
  • 계정 유형은 "Accounts in any organizational directory ... and personal Microsoft accounts" 를 선택합니다. (회사 계정과 개인 Microsoft 계정을 모두 허용하는 옵션)
  • Redirect URI: 종류를 Web으로 두고, AiTalk 화면의 Redirect URI를 복사해 붙여넣기
  • Register(등록) 클릭

2. 비밀 값 만들기 (Client secret)

  • 등록된 앱 화면에서 Certificates & secrets → New client secret
  • 설명은 아무거나, 만료(Expires)는 24개월을 권장합니다 → Add
  • 만들어진 Value(값) 를 바로 복사하세요.
  • ⚠️ 이 화면을 벗어나면 값을 다시 볼 수 없습니다. 꼭 지금 복사해 두세요.

3. 캘린더 권한 주기 (API permissions)

  • API permissions → Add a permission → Microsoft Graph → Delegated permissions
  • 아래 세 가지를 체크한 뒤 추가합니다: Calendars.ReadWrite, offline_access, User.Read
  • 회사(조직) 계정이라면 관리자가 Grant admin consent 를 한 번 눌러줘야 할 수 있습니다. (개인 outlook.com 계정은 필요 없습니다.)

4. AiTalk에 입력하고 연결

  • 필요한 값 두 가지:
    • Application (client) ID — 앱의 Overview(개요) 화면에 있습니다
    • Client Secret — 2단계에서 복사해 둔 Value
  • AiTalk의 Microsoft Calendar 화면에 두 값을 붙여넣고 Save credentials(저장) → Connect Microsoft Calendar → Microsoft 로그인 후 허용 → 완료!

잘 안 될 때

이런 메시지가 나오면이유이렇게 하세요
redirect_uri_mismatch붙여넣은 주소(Redirect URI)가 맞지 않음AiTalk 화면의 Redirect URI를 복사 버튼으로 다시 복사해 정확히 붙여넣기
invalid_client비밀 값(Client Secret)이 틀렸거나 만료됨Microsoft는 비밀 값을 새로 만들어 입력. Google은 만든 OAuth client를 열어 Client Secret을 다시 확인해 입력하고, 그래도 안 되면 새 OAuth client를 만드세요
"확인되지 않은 앱(App isn't verified)" 경고 (Google)연결하려는 계정이 등록되지 않음Google의 Google Auth Platform → Audience → Test users 에 그 계정을 추가
"관리자 승인이 필요합니다" 안내 (Microsoft)회사 계정이라 관리자 동의가 필요회사 IT 관리자에게 Grant admin consent 를 요청
시간이 지나 연결이 끊김오래 사용하지 않음AiTalk이 보통 자동으로 다시 연결합니다. 그래도 안 되면 Reconnect 버튼으로 재연결

연결 중 막히는 부분이 있으면 AiTalk 지원팀(support@aitalk.ch)에 문의해 주세요.

← 이전: 캘린더다음: MCP →