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

# Gmail

Gmail と連携すると、コンタクトとのやり取りメールが Stockwork に取り込まれ、会社・取引・コンタクトの各詳細画面のタイムラインで確認できます。取引スコアや取引分析の再評価にも使われます。

## 始める前に

* Gmail 連携は **ユーザーごと** に設定します。各ユーザーが自身の Google アカウントを 1 つ接続できます。
* 内部ドメイン設定のみ **組織単位** で共有されます。組織全体の内部ドメイン設定を変更するには、**管理者** ロールが必要です。
* 連携する Google アカウントで Stockwork に Gmail の読み取り権限を許可できることを確認してください。Stockwork は `gmail.readonly` スコープのみを要求し、メールの送信・削除・変更は行いません。

## Gmail と接続する

1. Stockwork の **設定 > 組織設定 > 外部連携 > Gmail** を開きます。
2. **Gmail と連携** をクリックすると Google の認証画面がポップアップで開きます。
3. 連携するアカウントを選び、Gmail 読み取り権限を **許可** します。
4. ポップアップが閉じ、接続済みのメールアドレスと同期状態が表示されれば完了です。接続直後に過去メールのバックフィル同期が開始されます。
5. 組織で共通の **内部ドメイン設定** を必要に応じて登録します（例: `example.co.jp`）。1 行に 1 ドメインを、`@` や空白を含めない形式で入力します。

<Tip>
  ブラウザのポップアップブロックで認証画面が開かない場合は、Stockwork のドメインからのポップアップを許可してください。
</Tip>

## 同期の仕組み

Stockwork に取り込まれるのは、**Stockwork に登録済みのコンタクトのメールアドレスが送信者・宛先・CC に含まれるメール** のみです。以下は同期対象から除外されます。

* **下書き**（DRAFT ラベル）
* **迷惑メール**（SPAM ラベル）
* **ゴミ箱**（TRASH ラベル）
* 参加者（From / To / CC）**全員** が内部ドメインに属するメール（内部ドメインが 1 件以上登録されている場合のみ判定されます）

外部ドメインの参加者が 1 人でも含まれるメールは通常どおり保存されます。新着メールは自動で取り込まれます。手動で最新化したい場合は Gmail 設定画面の **今すぐ同期** をクリックしてください。

同期されたメールは、コンタクト詳細・取引詳細・会社詳細のタイムラインに時系列で表示され、取引分析と取引スコアの再評価トリガーにもなります。

## うまくいかないとき

| 症状         | 主な原因と対処                                                                                  |
| ---------- | ---------------------------------------------------------------------------------------- |
| 認証画面が開かない  | ブラウザのポップアップブロックで Stockwork のドメインを許可してください                                                |
| メールが表示されない | 送信者または宛先に Stockwork へ登録済みのコンタクトメールアドレスが含まれているか、Gmail 連携が **接続中** かを確認します                 |
| 社内メールが混ざる  | 内部ドメイン設定を確認します。参加者全員が内部ドメインの場合のみ除外される仕様のため、外部ドメインが 1 人でも含まれると保存されます                      |
| 同期がエラーになる  | Gmail 設定画面の同期状態にエラーメッセージが表示されます。Google アカウント側で権限が取り消されていないかを確認し、必要なら **連携解除** → 再連携を行います |

## 関連ページ

* [Outlook メール](/guide/integrations/outlook-mail)
* [コンタクト](/guide/crm/contacts)
* [会社](/guide/crm/accounts)
* [取引](/guide/crm/deals)
