> For the complete documentation index, see [llms.txt](https://docs.immedio.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.immedio.io/company-settings/integrations/garoon.md).

# Garoon連携

immedioとGaroon（サイボウズ）を連携し、カレンダー予定の同期や面談予約時の予定作成を行う機能です。

## Garoon連携とは

Garoon連携とは、immedioとサイボウズGaroonを接続し、カレンダー予定の同期や面談予約時の自動予定作成を行う機能です。OAuth2認証によりGaroonと接続します。

## Garoon連携でできること

| 機能            | 説明                                                |
| ------------- | ------------------------------------------------- |
| OAuthクライアント設定 | GaroonのOAuth認証情報（サブドメイン、クライアントID、クライアントシークレット）を設定 |
| 設定変更          | 設定済みのOAuthクライアント情報を変更                             |

## 設定方法

### 事前準備

Garoon連携を利用するには、事前にサイボウズ開発者ポータルでOAuthクライアントを作成し、以下の情報を取得する必要があります。

* クライアントID
* クライアントシークレット
* サイボウズのサブドメイン（例：`example.cybozu.com` の場合は `example`）

### immedio側の設定

1. 「企業設定」メニューから「外部ツール連携」>「Garoon連携」を選択
2. 以下の認証情報を入力：
   * **サブドメイン**：サイボウズ環境のサブドメイン（例：`example.cybozu.com` の場合は `example`）（必須）
   * **クライアントID**：OAuthクライアントのクライアントID（必須）
   * **クライアントシークレット**：OAuthクライアントのクライアントシークレット（必須）
3. 「保存する」ボタンをクリック

### 設定項目

| 項目           | 説明                             | 必須 |
| ------------ | ------------------------------ | -- |
| サブドメイン       | サイボウズ環境のサブドメイン（英数字とハイフンのみ使用可能） | ○  |
| クライアントID     | OAuthクライアントのクライアントID           | ○  |
| クライアントシークレット | OAuthクライアントのクライアントシークレット       | ○  |

### 設定の変更

設定済みの場合、現在のサブドメインとクライアントIDが表示されます。「設定を変更する」ボタンをクリックすることで、設定を編集できます。

## カレンダー予定の空き時間判定 <a href="#garoon-allday-availability" id="garoon-allday-availability"></a>

Garoon連携では、以下のルールに基づいてカレンダー予定の空き時間判定を行います。

| 予定の種類        | 判定        |
| ------------ | --------- |
| 通常の時間指定予定    | 予定ありとして扱う |
| 繰り返し予定（時間指定） | 予定ありとして扱う |
| 単日の終日予定      | 空き時間として扱う |
| 期間予定（終日の帯予定） | 空き時間として扱う |
| 繰り返し予定（終日）   | 空き時間として扱う |

特定の日を面談予約不可にしたい場合は、時間指定の予定を登録するか、[ブロックキーワード](/meeting-settings/reservation-settings/meeting-conditions.md#block-keywords)を利用してください。

## ユーザーごとのGaroon連携 <a href="#user-garoon-link" id="user-garoon-link"></a>

OAuthクライアント設定完了後、各ユーザーがGaroonアカウントとの連携を行う必要があります。連携後、必ず各ユーザーのGaroonログイン名を登録してください。詳細は[ユーザー詳細のカレンダー連携設定](/user-group-management/users/detail.md#garoon-calendar-link)を参照してください。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.immedio.io/company-settings/integrations/garoon.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.