> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 앱 연결(Google, Slack, HubSpot 등)

> 몇 번의 클릭만으로 코드 없이 에이전트에 실제 기능을 부여하세요. 캘린더 확인, CRM 업데이트, Slack 게시가 가능합니다.

앱 연결을 사용하면 음성 에이전트가 대화 중에 팀에서 이미 사용하는 도구 내에서 작업할 수 있습니다. 예를 들어 캘린더에서 일정을 확인하고, CRM에서 발신자를 조회하고, 스프레드시트에 리드를 추가하고, Slack에 요약을 게시할 수 있습니다. **연결 → 앱**
(`/dashboard/app-connections`)에서 계정을 한 번 연결하고, 에이전트가 수행할 수 있는 작업을 선택한 다음, 빌더에서 원하는 에이전트에 연결을 추가합니다.

현재 다음 6개의 애플리케이션을 사용할 수 있습니다.

| 애플리케이션              | 에이전트가 수행할 수 있는 작업                 |
| ------------------- | --------------------------------- |
| **Google Calendar** | 일정 가능 여부를 확인하고 캘린더 이벤트를 관리합니다.    |
| **Google Sheets**   | 시트에 리드 세부 정보와 통화 결과를 추가합니다.       |
| **Slack**           | 채널을 찾고, 메시지를 검색하고, 권한에 따라 게시합니다.  |
| **HubSpot**         | 연락처를 찾고, 레코드를 업데이트하고, 메모를 추가합니다.  |
| **Salesforce**      | 레코드를 검색하고, 리드를 업데이트하고, 활동을 기록합니다. |
| **Cal.com**         | 일정 가능 여부를 확인하고 예약을 관리합니다.         |

이 목록에 없는 항목은 맞춤
[API 연결](/ko/guides/api-connections)을 구축하거나
[MCP 서버](/ko/guides/mcp-servers)를 추가하세요.

## 계정 연결

<Steps>
  <Step title="연결 → 앱을 열고 애플리케이션 추가를 클릭합니다">
    선택기에 6개의 애플리케이션이 표시됩니다. 동일한 앱의 여러 계정을
    연결할 수 있으며, 계정을 하나 이상 연결하면 각각에 "연결됨" 수가 표시됩니다.
  </Step>

  <Step title="계정을 인증합니다">
    대부분의 앱은 OAuth를 사용합니다. 팝업이 열리면 제공업체에 로그인하여
    액세스를 승인하면 연결이 페이지에 표시됩니다. **Cal.com은
    예외입니다** — 대신 API 키로 연결합니다. 키를 붙여넣고
    **검증 및 연결**을 클릭하세요. 키는 암호화되어 저장되기 전에 Cal.com에서
    확인됩니다.
  </Step>

  <Step title="Google Sheets 전용: 스프레드시트를 선택합니다">
    Sheets 연결은 데이터를 쓸 스프레드시트와 탭을 알아야 합니다.
    연결 직후 구성 패널이 열립니다. 스프레드시트 URL(또는 ID)을 붙여넣고
    **스프레드시트 검사**를 클릭한 다음 탭을 선택하세요. 패널에서 찾은
    열을 확인할 수 있습니다. 이 작업을 완료하기 전까지 연결 타일에는
    **구성 필요**가 표시됩니다.
  </Step>
</Steps>

<Note>
  ThunderPhone의 Google OAuth 검증은 현재 검토 중이므로 Google
  Calendar 및 Google Sheets의 동의 과정에서 Google은 "검증되지 않은 앱"
  경고를 표시합니다. **애플리케이션 추가** 대화 상자에서 계속 진행하기 위한
  두 번의 클릭을 안내합니다(**고급 → ThunderPhone으로 이동**).
</Note>

앱 연결을 연결하고 관리하려면 조직에서 **관리자** 또는 **소유자**
역할이 필요합니다.

## 에이전트가 수행할 수 있는 작업 제어

각 연결에는 작업별 권한 토글이 있습니다. 연결 타일을 열어 관리하세요.
읽기 작업은 기본적으로 활성화되어 있으며, 데이터를 작성하거나 변경하는
작업은 활성화할 때까지 **비활성화됨** 상태입니다.

| 애플리케이션          | 기본 활성화                         | 기본 비활성화                |
| --------------- | ------------------------------ | ---------------------- |
| Google Calendar | 이벤트 및 일정 가능 여부 보기, 이벤트 생성      | 이벤트 업데이트, 이벤트 취소       |
| Google Sheets   | 행 추가                           | —                      |
| Slack           | 채널 및 최근 메시지 보기, 메시지 검색         | 메시지 게시                 |
| HubSpot         | 연락처 및 회사 검색 및 읽기               | 연락처 생성 또는 업데이트 및 메모 추가 |
| Salesforce      | 리드, 연락처 및 영업 기회 검색 및 읽기        | 레코드 생성 또는 업데이트 및 활동 기록 |
| Cal.com         | 이벤트 유형 나열 및 일정 가능 여부 확인, 예약 생성 | 예약 일정 변경 또는 취소         |

비활성화한 작업은 에이전트에서 사용할 수 없습니다. 해당 도구는 통화 중
에이전트에 제공되지 않습니다.

## 에이전트가 사용할 수 있는 도구

연결을 에이전트에 연결하면, 활성화된 작업이 대화 중 호출 가능한 도구로
표시됩니다.

* **Google Calendar** — `calendar_list_events`, `calendar_check_availability`,
  `calendar_create_event`, `calendar_update_event`, `calendar_cancel_event`
* **Google Sheets** — `sheets_append_row` (구성한 스프레드시트와 탭에
  작성)
* **Slack** — `slack_list_channels`, `slack_search_messages`,
  `slack_post_message`
* **HubSpot** — `hubspot_search_contacts`, `hubspot_get_contact`,
  `hubspot_upsert_contact`, `hubspot_add_note`
* **Salesforce** — `salesforce_search_records`, `salesforce_get_record`,
  `salesforce_upsert_lead`, `salesforce_log_activity`
* **Cal.com** — `calcom_list_event_types`, `calcom_check_availability`,
  `calcom_create_booking`, `calcom_cancel_booking`

이러한 도구의 스키마를 작성할 필요는 없습니다. ThunderPhone이 도구를 정의하고
연결된 계정을 통해 호출을 라우팅합니다.

## 에이전트에 연결 연결

에이전트가 사용하기 전까지 연결은 아무 작업도 수행하지 않습니다. 빌더에서
에이전트를 열고([에이전트 만들기](/ko/guides/build-an-agent)), **연결된 앱** 섹션에
연결을 추가합니다. 앱 페이지의 연결 타일에는 활성화된 작업 수와 이를 사용하는
에이전트 수가 표시됩니다.

## 연결 해제

연결 타일을 열고 여기에서 연결을 해제합니다. 해당 연결을 사용하던 에이전트는
다음 통화부터 해당 도구를 사용할 수 없습니다.

## 다음 단계

<CardGroup cols={2}>
  <Card title="모든 API를 에이전트 작업으로 전환" icon="plug" href="/ko/guides/api-connections">
    기본 연결이 없는 서비스를 위한 cURL 붙여넣기 마법사입니다.
  </Card>

  <Card title="MCP 서버 추가" icon="server" href="/ko/guides/mcp-servers">
    Streamable HTTP를 통해 자체 도구 서버를 연결합니다.
  </Card>
</CardGroup>