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

# コミュニケーショントリガー

> 受信メール、Odin記録会議の終了、Telegramボットメッセージに応答して発火するトリガーです。

コミュニケーショントリガーは、受信メール、Odin記録会議の終了、またはTelegramボットが受信したメッセージに応答して発火します。

## メール

GmailまたはOffice 365の受信箱をポーリングし、一致するメールが見つかった場合にワークフローを発火します。送信者アドレス、件名キーワード、既読ステータスでフィルターできます。添付ファイルはオプションで含め、ダウンストリームノードに渡すことも可能です。

**使用場面**

* 特定のメールが届いた際にワークフローを自動的に起動したい場合。
* メールからアクションへのパイプラインを構築している場合（例：メールで請求書を受信 → データを抽出 → CRMにレコードを作成）。
* メール添付ファイルをプログラムで処理する必要がある場合。

**設定**

<Tabs>
  <Tab title="Gmail">
    | 設定                            | タイプ     | 説明                                   |
    | ----------------------------- | ------- | ------------------------------------ |
    | `email_provider`              | String  | `gmail`に設定します。                       |
    | `poll_interval`               | Integer | 受信箱の確認頻度（秒単位）。                       |
    | `filters.unread_only`         | Boolean | `true`に設定すると、未読メールのみがワークフローをトリガーします。 |
    | `filters.from_email`          | String  | この送信者アドレスからのメールのみトリガーします。            |
    | `filters.subject_contains`    | String  | 件名にこのキーワードまたはフレーズが含まれる場合のみトリガーします。   |
    | `options.include_attachments` | Boolean | `true`に設定すると、トリガー出力に添付ファイルデータが含まれます。 |

    <Note>
      このトリガーを使用する前に、プロジェクトでGmail OAuth接続を設定する必要があります。
    </Note>
  </Tab>

  <Tab title="Office 365">
    | 設定                            | タイプ     | 説明                                   |
    | ----------------------------- | ------- | ------------------------------------ |
    | `email_provider`              | String  | `office365`に設定します。                   |
    | `poll_interval`               | Integer | 受信箱の確認頻度（秒単位）。                       |
    | `filters.unread_only`         | Boolean | `true`に設定すると、未読メールのみがワークフローをトリガーします。 |
    | `filters.from_email`          | String  | この送信者アドレスからのメールのみトリガーします。            |
    | `filters.subject_contains`    | String  | 件名にこのキーワードまたはフレーズが含まれる場合のみトリガーします。   |
    | `options.include_attachments` | Boolean | `true`に設定すると、トリガー出力に添付ファイルデータが含まれます。 |

    <Note>
      このトリガーを使用する前に、プロジェクトでOffice 365 OAuth接続を設定する必要があります。
    </Note>
  </Tab>
</Tabs>

**出力変数**

| 変数                          | 説明                                                                        |
| --------------------------- | ------------------------------------------------------------------------- |
| `trigger.email.from`        | 送信者のメールアドレス。                                                              |
| `trigger.email.to`          | 宛先のメールアドレス。                                                               |
| `trigger.email.subject`     | メールの件名。                                                                   |
| `trigger.email.body`        | メールのプレーンテキスト本文。                                                           |
| `trigger.email.attachments` | 添付ファイルオブジェクトの配列（ファイル名、MIMEタイプ、コンテンツ）。`include_attachments`が有効な場合のみ設定されます。 |
| `trigger.email.date`        | メールを受信したタイムスタンプ（ISO 8601形式）。                                              |

<AccordionGroup>
  <Accordion title="メモ">
    * フィルターは累積的に適用されます。`from_email`と`subject_contains`の両方が設定されている場合、トリガーが発火するには両方の条件を満たす必要があります。
    * 本番のワークフローでは、既に処理されたメールの再処理を避けるため、`unread_only`を`true`に設定してください。
    * 単一メールからの複数の添付ファイルを処理するには、Loopノードで`trigger.email.attachments`を使用してください。
  </Accordion>
</AccordionGroup>

## Odin会議終了

Odin記録会議が終了し、メモやアクションアイテムが生成された場合に自動的に発火します。会議後の自動化ワークフローの構築に使用します。概要の配信、フォローアップタスクの作成、CRMやプロジェクト管理ツールへの会議インサイトの記録などが可能です。

**使用場面**

* 会議終了時に、会議のメモやアクションアイテムを自動的に処理したい場合。
* 会議後のパイプラインを構築している場合（例：会議終了 → アクションアイテムを抽出 → プロジェクト管理ツールにタスクを作成）。
* 会議の概要をナレッジベースやCRMレコードに自動的に記録する必要がある場合。

**設定**

| 設定                        | タイプ     | 説明                                                  |
| ------------------------- | ------- | --------------------------------------------------- |
| `Tool Description`        | String  | ツールページに表示されるツールの説明。                                 |
| `Require Confirmation`    | Boolean | 有効にすると、ワークフローの実行前にユーザーの確認が必要です。                     |
| `Open Workflow Panel`     | Boolean | 有効にすると、チャットからこのフローが実行される際にワークフローのプレビューパネルを表示します。    |
| `API Key`                 | String  | 認証用のOdinAI APIキー。                                   |
| `API Secret`              | String  | 認証用のOdinAI APIシークレット。                               |
| `Project ID`              | String  | OdinAIプロジェクトID。                                     |
| `Enable for all meetings` | Boolean | 有効にすると、トリガーはあなたが参加するどの会議が終了しても発火します。                |
| `Event Type`              | String  | トリガーを発火させる会議イベントです。デフォルトは`Meeting Done`です。          |
| `Action Type`             | String  | 会議終了時に受け取るデータのタイプです。オプションは`Notes`と`Action Items`です。 |

**利用可能な変数**

| 変数                          | 説明            |
| --------------------------- | ------------- |
| `{{trigger.meeting.title}}` | 終了した会議のタイトル。  |
| `{{trigger.meeting.notes}}` | AIが生成した会議のメモ。 |

<AccordionGroup>
  <Accordion title="メモ">
    * 認証にはOdinAI API資格情報（APIキー、APIシークレット、プロジェクトID）が必要です。
    * **全会議で有効にする**がオンの場合、トリガーはあなたが参加する任意の会議で発火します。特定の会議に限定する場合はオフにしてください。
    * **アクションタイプ**は、トリガーがダウンストリームノードに会議メモとアクションアイテムのどちらを提供するかを決定します。
    * 会議データは`{{trigger.meeting.title}}`、`{{trigger.meeting.notes}}`、会議ペイロードの他のフィールドでアクセスできます。
  </Accordion>
</AccordionGroup>

## Telegram：新しいメッセージ

Telegramボットが新しいメッセージを受信した場合に発火します。トリガーはTelegramが更新をPOSTするWebhookを使用し、メッセージが受信されるたびにワークフローを開始します。

**使用場面**

* ユーザーのメッセージに自動ワークフローで応答するTelegramボットを構築したい場合。
* 受信したTelegramメッセージをAIエージェントや処理パイプラインにルーティングしている場合。
* Telegramボットに送信されたメッセージをリアルタイムでキャプチャし、対応する必要がある場合。

**設定**

| 設定                     | タイプ     | 説明                                                         |
| ---------------------- | ------- | ---------------------------------------------------------- |
| `Tool Description`     | String  | ツールページに表示されるツールの説明。                                        |
| `Require Confirmation` | Boolean | 有効にすると、ワークフローの実行前にユーザーの確認が必要です。                            |
| `Open Workflow Panel`  | Boolean | 有効にすると、チャットからこのフローが実行される際にワークフローのプレビューパネルを表示します。           |
| `Allowed HTTP Method`  | String  | Webhookが受け付けるHTTPメソッドです。デフォルトは`POST`です。                    |
| `Authentication`       | String  | 受信Webhookリクエストの認証方法です。デフォルトは`None`です。                      |
| `Response Mode`        | String  | Webhookが受信リクエストにどのように応答するかです。**即座に応答**は`200 OK`応答をすぐに返します。 |

**Webhookのセットアップ**

<Steps>
  <Step title="ツールを公開">
    ワークフローを公開してWebhookエンドポイントを有効化し、ライブURLを生成します。
  </Step>

  <Step title="TelegramにWebhookを登録">
    **ライブURL**をコピーし、`telegram_setWebhook`ツールまたは以下のcurlコマンドを使用してTelegramボットに登録します：

    ```bash theme={null}
    curl -X POST "https://api.telegram.org/bot<TOKEN>/setWebhook" \
      -H "Content-Type: application/json" \
      -d '{"url":"<WEBHOOK_URL>","allowed_updates":["message"]}'
    ```
  </Step>

  <Step title="ボットにメッセージを送信">
    Telegramボットにメッセージを送信します。TelegramがWebhook URLに更新をPOSTし、ワークフローを開始します。
  </Step>
</Steps>

**サンプルデータのキャプチャ（オプション）**

ワークフローを実行せずにテスト実行用の実際のペイロードを保存するには、ボットに以下のコマンドを送信してください：

```
/generate_test_message Hello world
```

**リフレッシュ**をクリックしてキャプチャしたペイロードを読み込んでください。

**利用可能な変数**

| 変数                                 | 説明                           |
| ---------------------------------- | ---------------------------- |
| `{{trigger.body}}`                 | リクエストボディ（JSON解析済み）。          |
| `{{trigger.headers}}`              | リクエストヘッダー。                   |
| `{{trigger.query}}`                | クエリパラメータ。                    |
| `{{trigger.method}}`               | HTTPメソッド。                    |
| `{{trigger.body.message.text}}`    | 受信したTelegramメッセージのテキストコンテンツ。 |
| `{{trigger.body.message.chat.id}}` | メッセージが送信された会話のチャットID。        |

<AccordionGroup>
  <Accordion title="メモ">
    * **テストURL**（ライブURLに`/test`を追加したもの）は、ワークフローを実行せずにサンプルデータを生成します。
    * メッセージデータは`{{trigger.body.message.text}}`、`{{trigger.body.message.chat.id}}`、Telegram更新ペイロードの他のフィールドでアクセスできます。
    * 外部サービスはWebhook URLにHTTPリクエストを送信します。各リクエストは新しいワークフロー実行をトリガーします。
    * Telegramに登録する前に、Webhookエンドポイントを有効化するためにツールを公開してください。
  </Accordion>
</AccordionGroup>
