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

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

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

​

メール

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

使用場面

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

設定

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に設定すると、トリガー出力に添付ファイルデータが含まれます。

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

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に設定すると、トリガー出力に添付ファイルデータが含まれます。

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

出力変数

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

メモ

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

​

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が生成した会議のメモ。

メモ

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

​

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のセットアップ

1. ツールを公開

   ワークフローを公開してWebhookエンドポイントを有効化し、ライブURLを生成します。

2. TelegramにWebhookを登録

   ライブURLをコピーし、telegram_setWebhookツールまたは以下のcurlコマンドを使用してTelegramボットに登録します：

   curl -X POST "https://api.telegram.org/bot<TOKEN>/setWebhook" \
     -H "Content-Type: application/json" \
     -d '{"url":"<WEBHOOK_URL>","allowed_updates":["message"]}'
   
3. ボットにメッセージを送信

   Telegramボットにメッセージを送信します。TelegramがWebhook URLに更新をPOSTし、ワークフローを開始します。

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

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

/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。

メモ

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