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

# メールを受信したときの概要

> 監視対象のメールボックスに新しいメールが届いたときにワークフローを開始します

<Tip>すべてのトリガー設定はAIチャットで行えます。ワークフローで実行したい内容をAIに伝えれば、残りはAIが処理します。</Tip>

このトリガーは、監視対象のメールボックスに新しい未読メールが届いたときに実行されます。

## AIで構築する

テーブル右側のサイドバーでAIチャットを開き、実行したい内容を説明します。

適切なトリガーの選択、関連フィールドのマッピング、すべてのアクションの設定はAIが自動的に行います。

目的を一度説明するだけでワークフローが完成し、手動設定は必要ありません。

**例：** *「サポートメールを受信したら、チケットを作成して分類してください。」*

## 設定

| 設定      | 必須 | 説明                             |
| ------- | -- | ------------------------------ |
| 接続の種類   | はい | IMAP、Gmail、Outlook             |
| ポーリング間隔 | はい | 新着メールを確認する頻度：10～60分（デフォルトは10分） |

## 接続方法の詳細

### IMAP

IMAP は、セルフホストのメールサーバー、企業メール、Yahoo や Zoho など、IMAP プロトコルに対応するあらゆるメールプロバイダーで利用できます。

| 設定      | 必須  | 説明                                                       |
| ------- | --- | -------------------------------------------------------- |
| ホスト     | はい  | IMAP サーバーのアドレス（例：`imap.gmail.com`、`imap.mail.yahoo.com`） |
| ポート     | はい  | 通常は993（SSL/TLS）または143（暗号化なし、非推奨）                         |
| ユーザー名   | はい  | メールアドレスまたはアカウントのユーザー名                                    |
| パスワード   | はい  | アプリパスワード（メールのパスワードではありません）                               |
| メールボックス | いいえ | 監視するフォルダー（デフォルトは `INBOX`）                                |

### Gmail（OAuth）

Google の OAuth フローを介して接続します。パスワードは不要で、Teable に Gmail アカウントへのアクセスを許可します。

| 設定           | 必須  | 説明                                    |
| ------------ | --- | ------------------------------------- |
| Google アカウント | はい  | OAuth で認可します。Teable は読み取り専用アクセスを要求します |
| ラベル          | いいえ | 監視する Gmail ラベルを選択します（デフォルトは受信トレイ）     |

### Outlook（OAuth）

Outlook および Microsoft 365 のメールボックスには、Microsoft の OAuth フローを介して接続します。

| 設定              | 必須  | 説明                                    |
| --------------- | --- | ------------------------------------- |
| Microsoft アカウント | はい  | OAuth で認可します。Teable は読み取り専用アクセスを要求します |
| フォルダー           | いいえ | 監視する Outlook フォルダーを選択します（デフォルトは受信トレイ） |

## 後続ステップで利用できるメールデータ

トリガーが実行されると、メールの次のデータをアクションステップの変数として利用できます。

| データ          | 説明                     |
| ------------ | ---------------------- |
| **送信元**      | 送信者のメールアドレス            |
| **件名**       | メールの件名                 |
| **本文（テキスト）** | メール本文のプレーンテキスト版        |
| **本文（HTML）** | メール本文の HTML 版（利用できる場合） |
| **日付**       | メールが送信された日時            |
| **添付ファイル**   | メールに含まれる添付ファイル         |

アクションフィールドの **+** をクリックすると、これらのデータを参照できます。

## 設定方法（IMAP の例）

1. オートメーションを開き、新しいトリガーを追加します。
2. **メールを受信したとき**を選択します。
3. 接続の種類として **IMAP** を選択します。
4. ホスト、ポート、ユーザー名、パスワードなど、IMAP サーバーの情報を入力します。
5. （任意）INBOX 以外のフォルダーを監視する場合は、**メールボックス**を変更します。
6. 新着メールを確認する頻度である**ポーリング間隔**を設定します。間隔を短くすると応答は速くなりますが、サーバーの確認回数が増えます。
7. **テスト**をクリックして接続を確認します。Teable がメールボックスへの接続を試み、成功または失敗を報告します。
8. オートメーションを保存して有効化します。
9. 送信元、件名、本文などのメールデータを変数として使用し、アクションステップを追加します。

## 使用例

* **受信したサポートメールごとにレコードを作成する。** 件名と本文を解析し、サポートチケットテーブルのフィールドへ自動入力します。
* **AIでメールから請求書データを抽出する。** AI生成アクションでメール本文や添付ファイルを読み取り、金額、日付、取引先名を抽出します。
* **顧客からの問い合わせを適切なチームへ振り分ける。** 件名や本文のキーワードに基づいて「チーム」フィールドを更新するか、特定の担当者へ通知します。
* **重要なメールをレコードとして保管する。** 特定の送信者または件名のメールを Teable のテーブルへ自動記録し、簡単に検索・追跡できるようにします。
* **注文確認を処理する。** 注文確認メールが届いたら、注文番号と詳細を抽出して注文テーブルを更新します。

## トラブルシューティング

* **接続に失敗する（IMAP）：** ホスト、ポート、ユーザー名、パスワードを再確認します。メールプロバイダーが IMAP アクセスを許可していることも確認してください。デフォルトで無効にしているプロバイダーがあります。
* **Gmail：「安全性の低いアプリ」エラー：** Gmail では通常のパスワードによるログインを使用できません。代わりに**アプリパスワード**を使用してください。手順は [Gmail IMAP を設定する](/ja/basic/automation/trigger/email/gmail-imap)を参照してください。
* **メールが取得されない：** ポーリング間隔を確認します。メールが監視対象のフォルダー／ラベルに届いていることも確認してください。誤ったメールボックスを選択していると、サブフォルダーやフィルタリング先ラベルのメールが取得されない場合があります。
* **重複して処理される：** トリガーは処理済みのメールを記録します。ただし、オートメーションを無効化してから再び有効化すると、最近のメールを再処理する場合があります。必要に応じて受信トレイのメールを既読にしてください。
* **OAuth トークンの有効期限切れ：** Gmail または Outlook の OAuth トークンが期限切れになった場合は、接続を再認可します。通常は数か月後、またはアプリの権限を取り消したときに発生します。

## ヒント

* ポーリング間隔を短くするとメールへの応答は速くなりますが、リアルタイムの配信が保証されるわけではありません。メールプロバイダーが対応している場合、完全なリアルタイム処理には Webhook を使用する方法を検討してください。
* メールクライアントのフィルターで関連メールを特定のラベルやフォルダーへ振り分け、Teable ではそのラベルだけを監視すると、不要な処理を減らせます。
* 大量のメールを扱うメールボックスでは、ワークフローの負荷が高くならないよう、ポーリング間隔を長くして一括処理することを検討してください。

## 関連ページ

* [Gmail IMAP を設定する](/ja/basic/automation/trigger/email/gmail-imap) — Gmail への接続手順
* [AI生成アクション](/ja/basic/automation/actions/ai/ai-generate) — メール内容から構造化データを抽出する場合に役立ちます
* [レコード作成アクション](/ja/basic/automation/actions/records/create-record) — メールをレコードとして記録するため、メールトリガーとよく組み合わせます
* [メールを送信](/ja/basic/automation/actions/communication/send-email-overview)