> ## 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 接続](/ja/guides/api-connections) を構築するか、
[MCP サーバー](/ja/guides/mcp-servers) を追加してください。

## アカウントを接続する

<Steps>
  <Step title="接続 → アプリを開き、アプリケーションを追加をクリック">
    6 つのアプリケーションが表示されます。同じアプリの複数アカウントを接続できます。接続済みのアカウントがある場合は、それぞれに「接続済み」の件数が表示されます。
  </Step>

  <Step title="アカウントを認可する">
    ほとんどのアプリは OAuth を使用します。ポップアップが開いたら、プロバイダーにログインしてアクセスを承認します。接続がページに表示されます。**Cal.com は例外です**。OAuth ではなく API キーで接続します。キーを貼り付けて **検証して接続** をクリックしてください。キーは暗号化されて保存される前に Cal.com で確認されます。
  </Step>

  <Step title="Google Sheets のみ: スプレッドシートを選択">
    Sheets 接続では、書き込み先のスプレッドシートとタブを指定する必要があります。接続直後に設定パネルが開きます。スプレッドシートの URL（または ID）を貼り付け、**スプレッドシートを確認** をクリックしてタブを選択してください。パネルには検出された列が表示されます。完了するまで、接続タイルには **設定が必要** と表示されます。
  </Step>
</Steps>

<Note>
  ThunderPhone の Google OAuth 確認は現在審査中です。そのため、Google Calendar と Google Sheets の同意画面では、Google により「未確認のアプリ」の警告が表示されます。**アプリケーションを追加** ダイアログでは、続行するための 2 回のクリック（**詳細設定 → 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がツールを定義し、
接続済みアカウントを介して呼び出しをルーティングします。

## 接続をエージェントに追加する

エージェントが使用するまで、接続は何も行いません。ビルダーでエージェントを開き
（[エージェントを作成](/ja/guides/build-an-agent)）、**接続済みアプリ**セクションで
接続を追加します。Appsページの接続タイルには、有効な操作数と使用中のエージェント数が
表示されます。

## 接続を解除する

接続タイルを開き、そこから接続を解除します。使用していたエージェントは、次回の通話時に
それらのツールを利用できなくなります。

## 次のステップ

<CardGroup cols={2}>
  <Card title="任意のAPIをエージェントアクションに変換" icon="plug" href="/ja/guides/api-connections">
    ネイティブ接続がないサービス向けのcURL貼り付けウィザード。
  </Card>

  <Card title="MCPサーバーを追加" icon="server" href="/ja/guides/mcp-servers">
    Streamable HTTP経由で独自のツールサーバーを利用します。
  </Card>
</CardGroup>