> ## 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.

# Outlook メール

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

Gmail 連携と同じ仕組みで動作するため、社内で Google Workspace と Microsoft 365 が混在している場合も、ユーザーごとに使っているメールを選んで連携できます。

## 始める前に

* Outlook メール連携は **ユーザーごと** に設定します。各ユーザーが自身の Microsoft アカウントを 1 つ接続できます。
* 内部ドメイン設定のみ **組織単位** で共有されます。組織全体の内部ドメイン設定を変更するには、**管理者** ロールが必要です。
* Microsoft 365 の組織ポリシーによっては、Stockwork の利用に管理者の承認が必要な場合があります。認証画面で承認エラーが表示された場合は、組織の Microsoft 365 管理者に許可を依頼してください（[管理者の方へ](#for-admins) を参照）。
* ブラウザのポップアップブロックで、Stockwork のドメインからのポップアップを許可しておきます。
* 個人用の Microsoft アカウント（outlook.com など）も連携できます。

<h2 id="for-admins">
  管理者の方へ
</h2>

社内申請や情報システム部門への説明が必要な場合は、次の内容をそのまま提出できます。

### Stockwork が要求する権限

| スコープ                                    | 用途                                   | 書き込み権限 |
| --------------------------------------- | ------------------------------------ | ------ |
| `openid`                                | サインインしたユーザーの識別                       | なし     |
| `email`                                 | 連携したアカウントのメールアドレスの取得                 | なし     |
| `offline_access`                        | ユーザーが再ログインしなくても定期同期を継続するための更新トークンの取得 | なし     |
| `https://graph.microsoft.com/Mail.Read` | メールボックス内のメールの読み取り                    | なし     |

<Tip>
  **すべて読み取り専用です**

  Stockwork はメールの **送信・返信・削除・変更・フォルダー移動を一切行いません**。要求するのは上記 4 つのみで、メールの書き込み権限（`Mail.ReadWrite`、`Mail.Send` など）や、連絡先・ファイル・Teams などへのアクセス権限は要求しません。

  すでにご利用中の [カレンダー連携](/guide/integrations/calendar) が要求する `Calendars.Read` と同じ「読み取り専用」カテゴリの権限です。
</Tip>

### 承認について

* Microsoft 365 テナントでユーザーによる同意が無効化されている場合、各ユーザーの連携時に管理者の承認画面が表示されます。管理者が承認すると、以降はテナント内のユーザーが個別に承認を求められることはなくなります。
* カレンダー連携を既に承認済みのテナントでも、メール連携で追加される `Mail.Read` については別途承認が必要になる場合があります。
* 取り込んだメールは、連携したユーザーの組織にのみ保存されます。連携を解除すると、Stockwork に取り込まれたメールは削除されます。

## Outlook メールと接続する

1. Stockwork の **設定 > 組織設定 > 外部連携 > Outlook メール** を開きます。
2. **Outlook と連携** をクリックすると Microsoft の認証画面がポップアップで開きます。
3. 連携するアカウントを選び、メールの読み取り権限を **同意** します。
4. ポップアップが閉じ、接続済みのメールアドレスと **接続中** のステータスが表示されれば完了です。**連携日時** と **最終同期** もこの画面で確認できます。
5. 組織で共通の **内部ドメイン設定** を必要に応じて登録します（例: `example.co.jp`）。1 行に 1 ドメインを、`@` や空白を含めない形式で入力します。

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

## 同期の仕組み

### 取り込み対象

Stockwork に取り込まれるのは、**Stockwork に登録済みのコンタクトのメールアドレスが送信者・宛先・CC に含まれるメール** のみです。あわせて、次の条件で対象が絞り込まれます。

| 項目         | 対象                       |
| ---------- | ------------------------ |
| 同期するフォルダー  | 受信トレイ / 送信済みアイテム / アーカイブ |
| 同期しないフォルダー | 下書き / 迷惑メール / 削除済みアイテム   |
| 対象期間       | **連携した日時以降** に送受信されたメール  |

参加者（From / To / CC）**全員** が内部ドメインに属するメールも除外されます（内部ドメインが 1 件以上登録されている場合のみ判定されます）。外部ドメインの参加者が 1 人でも含まれるメールは通常どおり保存されます。

<Warning>
  **過去のメールは取り込まれません**

  Outlook メール連携では、**連携した時点より前のメールは取り込まれません**。連携後に送受信したメールから順次蓄積されていきます。過去のやり取りを Stockwork 側で参照したい場合は、早めに連携しておくことをおすすめします。
</Warning>

### 同期のタイミング

* 連携後は 1 日 1 回、早朝に自動で同期されます。
* すぐに最新化したい場合は、Outlook メール設定画面の **今すぐ同期** をクリックしてください。同期中はステータスが **同期中** になり、完了すると通知が表示されます。
* 送信済みアイテムから取り込まれたメールは **送信**、それ以外のフォルダーから取り込まれたメールは **受信** として記録されます。
* Outlook 側でメールを別のフォルダーへ移動しても、同じメールが二重に取り込まれることはありません。
* Outlook 側でメールを削除しても、すでに Stockwork に取り込まれたメールは残ります。

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

## 連携を解除する

Outlook メール設定画面のゴミ箱アイコンから連携を解除できます。

<Danger>
  連携を解除すると、同期が停止し、**これまで取り込んだメールはすべて削除されます**。この操作は取り消せません。再連携した場合、メールは解除前まで遡って復元されず、再連携した日時以降のメールから取り込みが再開されます。
</Danger>

## Gmail と併用する場合

* 同じユーザーが Gmail 連携と Outlook メール連携の両方を接続できます。それぞれの受信箱から独立してメールが取り込まれます。
* **内部ドメイン設定は Gmail と Outlook で共通** です。どちらの画面から編集しても同じ設定が更新されます。

## うまくいかないとき

| 症状                                    | 主な原因と対処                                                                                 |
| ------------------------------------- | --------------------------------------------------------------------------------------- |
| 認証画面が開かない                             | ブラウザのポップアップブロックで Stockwork のドメインを許可してください                                               |
| Microsoft の認証画面で承認エラーが出る              | Microsoft 365 管理者に Stockwork の利用許可を依頼してください。[管理者の方へ](#for-admins) の内容を共有すると申請が通りやすくなります |
| メールが表示されない                            | 送信者または宛先に Stockwork へ登録済みのコンタクトメールアドレスが含まれているか、連携が **接続中** かを確認します                      |
| 古いメールが取り込まれない                         | 仕様です。連携日時より前のメールは同期対象外です                                                                |
| 社内メールが混ざる                             | 内部ドメイン設定を確認します。参加者全員が内部ドメインの場合のみ除外される仕様のため、外部ドメインが 1 人でも含まれると保存されます                     |
| 「Outlook の認証情報が無効です。再連携してください。」と表示される | Microsoft アカウント側でパスワード変更やアクセス許可の取り消しが行われた可能性があります。**連携を解除** してから再度連携してください              |
| 同期がエラーになる                             | 設定画面にエラーメッセージが表示されます。時間をおいて **今すぐ同期** を試し、解消しない場合は連携解除 → 再連携を行います                       |

## 関連ページ

* [Gmail](/guide/integrations/gmail)
* [カレンダー](/guide/integrations/calendar)
* [コンタクト](/guide/crm/contacts)
* [会社](/guide/crm/accounts)
* [取引](/guide/crm/deals)