---
title: "앱 연결(Google, Slack, HubSpot 등)"
description: "몇 번의 클릭만으로 코딩 없이 에이전트에 실제 기능을 제공하세요. 사용하는 앱과의 사전 구축 연동을 통해 캘린더를 확인하고, 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>

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

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

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

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

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

Google Calendar 연결에는 기본적으로 켜져 있는 **참석자에게 이메일 초대**
스위치도 있습니다. 에이전트가 발신자의 이메일 주소를 수집하여 일정의
참석자로 추가하면 Google에서 초대장과 에이전트가 이후에 수행하는 모든
업데이트 또는 취소를 이메일로 전송합니다. 이메일을 보내지 않고 일정에
참석자를 유지하려면 이 기능을 끕니다. 초대장에는 일정 설명이 포함되므로,
에이전트가 내부 메모를 설명에 넣지 않도록 하고 예약 전에 발신자에게
이메일 주소를 다시 읽어 확인하도록 합니다.

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

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

- **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>