メインコンテンツまでスキップ

設定ガイド: IMAP (メールの読み取り)

Agent が Gmail、Yahoo メール、社内メール サーバーなどのメールボックスからメールを読み取る場合は、IMAP アクティビティを使用します。

このガイドでは、アクティビティに必要な情報の集め方と、akaBot Studio のどこに入力するかを説明します。メール サーバーをインストールしたり設定したりする必要はありません。

注記

Microsoft 365 / Outlook.com のメールボックスの場合は、代わりに Office 365 パッケージ を使用してください。Microsoft では、IMAP で通常のパスワードを使用できなくなりました。

Exchange Server を使用していますか？

メールボックスが社内の Exchange Server にある場合は、代わりに Exchange アクティビティを使用してください（akaBot Studio では Mail > Exchange）。Exchange (EWS) の設定 を参照してください。

1. 必要な情報​

akaBot Studio を開く前に、次のチェックリストを埋めてください。

情報入手先例 (Gmail)
サーバーセクション 3 の表、または社内の IT 担当者"imap.gmail.com"
ポートセクション 3 の表、または社内の IT 担当者993
メールAgent が読み取るメールボックスのアドレス"bot.account@gmail.com"
パスワードアプリ パスワード (セクション 2 参照)。プロバイダーが許可している場合はアカウントのパスワード16 文字、スペースなし
メール フォルダーメールボックスに表示されているフォルダー名"Inbox"

2. 情報を入手する​

Gmail​

変更するのは自分の Gmail アカウントの設定だけです。

A. IMAP を有効にする

  1. Gmail を開きます。
  2. 右上の歯車アイコン > すべての設定を表示 をクリックします。
  3. メール転送と POP/IMAP タブを開きます。
  4. IMAP アクセス で IMAP を有効にする を選択します。
  5. 変更を保存 をクリックします。

Gmail の設定 – メール転送と POP/IMAP タブ

Gmail の 設定 > メール転送と POP/IMAP タブ。IMAP アクセス は画面の下部にあります。

B. アプリ パスワードを作成する

Gmail では、akaBot Agent などのアプリから通常のパスワードを使用できません。akaBot 用の専用パスワードを作成します。

  1. Google アカウント > セキュリティ を開きます。

  2. 2 段階認証プロセス が オン になっていることを確認します (オンの場合のみアプリ パスワードが表示されます)。

    Google アカウント – 2 段階認証プロセスがオン

    Google アカウント > セキュリティとログイン。2 段階認証プロセス が オン になっている必要があります。

  3. myaccount.google.com/apppasswords を開きます。

  4. 名前 (例: akaBot) を入力し、作成 をクリックします。

  5. 表示された 16 文字のパスワードを、スペースを取り除いてコピーします。これが akaBot の パスワード に入力する値です。

    生成されたアプリ パスワードのダイアログ

    アプリ パスワードは一度しか表示されません。完了 をクリックする前にコピーしてください。

C. 移動先フォルダー (ラベル) を作成する

ステップ 4.2 ではメールを Processed フォルダーに移動します。このフォルダーはワークフローの実行前に存在している必要があります。Gmail ではフォルダーを ラベル と呼びます。

  1. Gmail の左側のメニューで、ラベル の横にある + をクリックします。
  2. Processed と入力し、作成 をクリックします。

社内メール サーバー​

サーバーは IT 担当者が管理しています。次のように依頼してください。

メールボックス <アドレス> の IMAP 設定を教えてください: サーバー名、ポート、セキュリティの種類 (SSL または STARTTLS)、通常のパスワードとアプリ パスワードのどちらを使うか。

その他のプロバイダー (Yahoo、iCloud など)​

アカウントのセキュリティ設定で IMAP アクセスを有効にし、アプリ パスワードを作成します。詳しい手順は各プロバイダーのヘルプを参照してください。

3. サーバーとポートの一覧​

プロバイダーサーバーポート安全な接続
Gmailimap.gmail.com993SslOnConnect
Yahoo メールimap.mail.yahoo.com993SslOnConnect
iCloudimap.mail.me.com993SslOnConnect
社内サーバーIT 担当者に確認993 (SSL) または 143 (STARTTLS)993 は SslOnConnect、143 は StartTls、または Auto

4. akaBot Studio に入力する​

ステップ 4.1: Get IMAP Mail Messages​

このアクティビティのすべての設定: Get IMAP Mail Messages

  1. アクティビティ パネルで Mail > IMAP を開き、Get IMAP Mail Messages をワークフローにドラッグします。
  2. プロパティ パネルで次のように入力します。
カテゴリプロパティ値
HostServer"imap.gmail.com"
HostPort993
HostMail Folder"Inbox" (既定)
LogonEmail"bot.account@gmail.com"
LogonPassword"abcdefghijklmnop" (アプリ パスワード)
OptionsSecure ConnectionSslOnConnect (または Auto)
OptionsTop30 (既定) – 読み取るメールの数
OptionsOnly Unread Messages既定で選択 – 既読のメールも読む場合は選択を外します
OptionsMark As Read読み取ったメールを既読にする場合に選択します
OptionsDelete Messages選択しないでください。 選択すると、読み取ったメールはサーバーから完全に削除されます
OutputMessagesimapMails – Ctrl+K で作成します (手順 3)

Get IMAP Mail Messages – 設定例

Gmail の場合の プロパティ パネルの設定例。

  1. プロパティ パネルで、Output カテゴリの Messages ボックスをクリックし、Ctrl+K を押します。
  2. imapMails と入力して Enter を押します。
  3. デザイナー下部の 変数 パネルを開き、次を確認します。
    • 変数の型 が List<MailMessage> であること。
    • スコープ が、Get IMAP Mail Messages と For Each ループの両方を含む Sequence であること。より小さいコンテナーが表示されている場合は、その Sequence に変更します。変更しないとループから変数を使用できません。
ヒント

パスワードを保護するために、Password の代わりに SecurePassword (型 SecureString) に入力することもできます。どちらか一方だけを入力します。

ステップ 4.2: Move IMAP Mail Message To Another Folder​

このアクティビティのすべての設定: Move IMAP Mail Message To Another Folder

  1. 取得アクティビティの下 (同じ Sequence 内) に For Each アクティビティをドラッグし、次のように設定します。
    • Foreach: item
    • in: imapMails
    • TypeArgument (プロパティ パネル): System.Net.Mail.MailMessage。一覧にない場合は 型の参照... を選択し、MailMessage を検索します。
  2. ループの Body に Move IMAP Mail Message To Another Folder をドラッグします。
  3. 次のように入力します。
    • Server、Port、Email、Password: ステップ 4.1 と同じ値。
    • Mail Message: ループの現在の項目 (例: item)。
    • Mail Folder (Destination): 移動先のフォルダー (例: "Processed")。フォルダーはメールボックスにあらかじめ存在している必要があります。

Move IMAP Mail Message To Another Folder を含む For Each ループ

imapMails の各メールを Processed フォルダーに移動します。

ステップ 4.3: 結果を確認する​

  1. ワークフローを実行します。
  2. Gmail で Processed ラベルを開きます。Agent が読み取ったメールが表示されます。
  3. 受信トレイ を開きます。それらのメールは受信トレイから消えています。

何も移動されない場合は、Only Unread Messages の設定がテスト用メールに合っているか (既定では未読メールのみ読み取ります)、Processed ラベルが存在するかを確認してください。