7.3. メールを取得してインテグレーションの実行をトリガー
メールの受信時にインテグレーションの実行をトリガーするには、IMAP または POP3 メールサーバーコネクションをシンプルなインテグレーションの最初のコネクションとして追加します。
前提条件
- メールの取得元であるアカウントにアクセスできるように設定された IMAP または POP3 メールサーバーコネクションが作成されている必要があります。
- メッセージを取得するフォルダーの名前を知っている必要があります。
手順
- Fuse Online パネルの左側にある Integrations をクリックします。
- Create Integration をクリックします。
- Choose a connection ページで、インテグレーションを開始するために使用するメールサーバーコネクションをクリックします。
- Choose an action ページで、Receive Email を選択し、コネクションのアクセスが許可されるメールアカウントからメッセージを定期的に取得します。
アクションを設定するには以下を行います。
Folder フィールドを空白のままにして受信トレイからメールを取得します。特定のフォルダーからメッセージを取得する場合は、そのフォルダーの名前を入力します。
コネクションが POP3 メールサーバーにアクセスする場合、Inbox (受信トレイ) や Sent (送信済み) などの標準のフォルダーのみがサポートされます。
- Unseen Only チェックボックスを選択すると、メールサーバーで未読となっているメッセージのみを取得します。
- Delay フィールドで、デフォルトの 5 秒をメッセージのポーリング間隔の経過時間として指定します。別のポーリング間隔を指定する場合は、数値を入力し、時間の単位を選択します。
Maximum Emails フィールドで、1 回のポーリング操作が返すことが可能な最大メッセージ数を入力します。デフォルトは 5 です。受信トレイまたはフォルダーに返信可能な最大数を超えるメッセージが含まれる場合、コネクションは最も古いメッセージを Maximum Emails に設定された数まで返します。
ポーリングごとに以下を取得する場合は、Maximum Emails を
-1
に設定します。- Unseen Only が選択されている場合、指定フォルダーの新しいメッセージすべてを取得。
- Unseen Only が選択されていない場合、指定フォルダーのメッセージすべてを取得。
- Next をクリックします。
結果
インテグレーションフローの最初にコネクションが表示されます。実行中にポーリングがメールを返した場合、コネクションはメッセージをインテグレーションの次のステップに渡します。ポーリングが返すメールがない場合、インテグレーションは実行を継続しますが、Fuse Online は残りのインテグレーションステップをトリガーしません。
例
以下のように設定された Receive Email アクションを例として取り上げます。
- Folder フィールドを空白にして、コネクションが受信トレイをポーリングするようにします。
- Unseen Only を選択します。
- デフォルトの Delay (5 秒) および Maximum Emails (5) を指定します。
遅延中、次のポーリングが行われる前に 10 個のメッセージが受信トレイに受信されたとします。コネクションは最も古い 5 つのメッセージを返します。5 秒後に次のポーリングが行われ、コネクションは残りの 5 つのメッセージを返します。Maximum Emails に設定された数よりも多くのメッセージがある場合、コネクションは古いメッセージから返すため、新しいメッセージが受信されても残りの 5 つのメッセージが返されます。