メールを読み、返信する AI を Gmail に接続する

4 つの画面と、見逃すとすべてを壊すチェックボックス 1 つ。個人の @gmail.com でも Google Workspace のアドレスでも動きます。

更新日

この一式の中で最速の道です。管理者も不要、許可を求めることもなく、確実に うまくいかない可能性があるのは Google 自身の画面上のチェックボックス 1 つだけです。

これが正しいガイドなのは、“ご自身が所有する単一ユーザーの受信トレイであれば何でも 構いません。個人の @gmail.com または you@your-company.com のような Google Workspace のメールです。” の場合です。複数人でそのアドレスに返信するなら、 共有受信トレイか Google グループのガイドを読んで ください。

画面の流れ

チャネル → チャネルを追加 → メール → /channels/email/new。

画面表示されるもの
メールボックスを接続「Omni Octo が Gmail または Outlook のメールボックスに接続し、メールの読み取りと返信を行います。」
Gmail メールボックスを接続「Google の同意画面から Omni Octo を認可します。」
Google の同意画面Google 自身のもの — 下記参照
メールボックス設定を検証「テストメッセージを往復させ、受信と送信の配信を確認します。」
メールボックスの設定を完了「エージェント、既定の返信モード、署名を選択します。」

最後の画面があるのは Gmail の流れだけです。Microsoft の流れにはありません — 同じ項目をもっと早い段階で収集するためです。以前 Outlook のメールボックスを 接続したことがあるなら、こちらには余分なステップが 1 つありますが、それは 想定内です。

メール設定ウィザードに並ぶ Gmail の 4 つの接続方法。先頭は「個人の Gmail メールボックス」です。
「個人の Gmail メールボックス」が最初のカードです。その下の 3 つは、共有アドレスと送信用エイリアスのためのものです。

すべてを壊すチェックボックス

Google は権限をまとめて許可しません。個別にオンオフできるチェックボックスとして 表示し、既定ではすべてオフです。ウィザードはその画面に到達する前に警告します:

Google から、どの権限を許可するか尋ねられます。Omni Octo が受信メールを読み、 あなたに代わって返信するには Gmail の両方の権限が必要です。続行をクリックする 前に**「すべて選択」をクリック**してください(または両方のチェックボックスを個別に オンにしてください)。

そして、そうしなかった場合どうなるかも言います:

どちらかのチェックボックスをオフのままにすると、送受信は機能せず、このフローを やり直すことになります。

Gmail の道で最も多い単一の失敗原因がこれで、無音 で失敗します — 接続は成功した ように見え、その後何も届かなかったり、何も送れなかったりします。両方オンにして ください。

2 つの権限の中身

スコープ扱う範囲
gmail.modifyメールの読み取り、下書きの作成、ラベルの変更、送信
gmail.settings.basic署名とメールボックスの基本設定の読み取り

細かい権限の長いリストではなく、広い 2 つのスコープです — Google の API はそういう 形をしています。gmail.modify には送信が含まれるため、送信の権限は接続した瞬間から 存在します。何かが自動で送られるかどうかを決めるのは返信モードで、下書き モードは承認まですべてを保留します。

検証の往復

検証ステップは、メールボックスからそのメールボックス自身へメッセージを送ります。 読み取り と 送信を一度に証明するのが目的です — チェックボックスが 1 つ欠けた承認 画面は、サインインは通過しますが、ここで失敗します。

戻ってこない場合、ウィザードは肩をすくめるのではなく、いつもの原因を名指しします:

これは通常、Pub/Sub のプッシュサブスクリプションが正しく設定されていないことを 意味します。ランブックをご確認いただくか、サポートにお問い合わせください。

これは当社側のインフラの故障であり、あなたの押し間違いではありません。

しないこと

既存のメールをインポートしません。 監視は接続の時点で始まります。

監視するのは受信トレイだけです。 Gmail の監視は明示的に INBOX ラベルに張り付いています。受信トレイを経由しないメール — ラベルに直接振り分けられた もの、受信と同時にアーカイブされるもの — は見えません。積極的なフィルタを動かして いるなら、AI に処理してほしいメールが本当に受信トレイに届いているか確認してください。

自分が Gmail から送った返信は「返信済み」として数えられません。 プラットフォームが認めるのは、それ自体を通じて送られた返信です。スマホの Gmail から スレッドに返信しても、こちらでは待ち状態のまま表示されることがあります。