コミュニケーション
GmailをAIエージェントに接続する
Gmailには顧客や社内とのやり取りが集まります。Gmailコネクタは近日公開予定です。公開後、Atakoのエージェントは、Googleのパスワードを一切見ることなく、仕分け、下書き作成、受信箱の整理を行えるようになります。
近日公開 — アカウントを作成すると、この連携の準備が整い次第お知らせします。
想定されるワークフロー
共有サポート受信箱の仕分けと返信下書き
support@ の受信箱には1日に数十通のメッセージが届きます。エージェントはlist_messagesで未読メッセージを一覧にし、add_label_to_messageでラベル別(請求、バグ、一般的な質問)に仕分け、明確な依頼ごとにcreate_draftで返信の下書きを作成する予定です。人間が確認し、send_draftで送信します。send_emailは、その権限が明示的に付与された場合にのみ使います。
受信箱の定期的な整理
ニュースレター、自動通知、開封確認。エージェントはsearch_messages(例: from:noreply)でこれらを検索し、list_labelsでラベルを確認し、メインの受信箱にたまる前にtrash_messageでゴミ箱へ移す予定です。毎朝10分の手作業による仕分けなしで、受信箱を読みやすく保てます。
フォローアップが必要な顧客スレッドの追跡
エージェントはsearch_messagesで3日以上返信のないスレッドを探し、get_threadで全文脈を取得し、add_label_to_messageでラベルを付け、create_draftでフォローアップの下書きを用意する予定です。人間の承認なしには何も送信されません。フォローアップを当日中に送れるよう準備を整えます。
コネクタのアクション
list_messages
読み取り。メッセージのIDを一覧表示する。ラベルで絞り込み可能。
search_messages
読み取り。Gmailのクエリでメッセージを検索する。
get_message
読み取り。ヘッダーと本文を含む、メッセージ全体を取得する。
get_thread
読み取り。会話スレッド全体を取得する。
list_drafts
読み取り。既存の下書きを一覧表示する。
create_draft
書き込み。送信せずに返信の下書きを作成する。
send_draft
書き込み。既存の下書きを送信する。
send_email
書き込み。接続済みアカウントから直接メールを送信する。
add_label_to_message
書き込み。メッセージにラベルを追加する。
trash_message
書き込み。メッセージをゴミ箱に移動する。
前提条件
- インテグレーションを接続するための、Atako企業アカウントの管理者権限。
- 接続する受信箱を持つGmailまたはGoogle Workspaceアカウント。
- Google OAuthの同意。スコープはhttps://www.googleapis.com/auth/gmail.modify。
- エージェントごとの明示的なgrant。特にsend_emailアクションについて。
接続方法
- 1
コンテキスト → 連携を開く
コネクタの公開後、管理者がコネクタ一覧からGmailを選択します。
- 2
公開されるアクションを確認する
承認前に、send_emailを含む読み取り・書き込みのすべてのアクションが表示されます。
- 3
Googleの画面で認証する
Googleの同意画面へリダイレクトされます。Atakoにパスワードは送信されません。
- 4
エージェントにアクセス権を付与する
エージェントごとに具体的なアクションを選びます。慎重に進めるならcreate_draftのみなど。
自律型エージェントをGmailに接続する理由
Gmailコネクタはまだ利用できません。このページでは、公開後にできることを説明します。
Gmailには顧客、取引先、チームとのやり取りが集まります。Gmailに接続した自律型エージェントは、単発の指示に応えるだけではありません。常時稼働し、受け取った指示に応じて、メッセージの検索、分類、返信の準備をツール呼び出しによって自ら判断します。イベントごとに一度動いて止まるトリガー型の自動化ツールとは異なり、受信箱全体を自力で処理していきます。
接続にはOAuth 2.0とスコープ https://www.googleapis.com/auth/gmail.modify を使う予定です(GoogleのGmailスコープ)。このスコープでは読み取り、作成、送信ができますが、メッセージを即時に完全削除することはできません。
これにより、サポート受信箱の仕分けのようなフローが役立ちます。サポートのトリアージやサポート自動化のエージェントに近い働きで、新着メッセージを受け取るたびに、人間が会話を開くのを待たずに返信を準備します。GmailはStandardプランに含まれる連携のひとつになり、コネクタごとの別請求はありません。
制限とベストプラクティス
このコネクタで最も機微なアクションはsend_emailになります。書き込みスコープで付与すると、エージェントはあなたを介さず送信します。最も安全なのはcreate_draftのみを付与する運用です。エージェントが準備し、人間が確認してsend_draftで送信します。下書きを承認する前に宛先、件名、添付を確認してください。send_draftを実行するとメールはすぐに送信され、取り消せません。
gmail.modifyスコープは特定のラベルではなく、接続した受信箱全体に及びます。実際の制限は権限で決まるため、接続時にすべてをまとめて付与せず、エージェントに必要なアクションだけを指定してください。
実行・拒否を問わず、すべての呼び出しはエージェントページの監査ログで確認できるようになります。ほかのOAuthアカウントと同様、Google側でトークンが期限切れまたは取り消しになると、再接続するまで接続はエラー状態になります。接続したアカウントには、コネクタとは別にGoogleが定めるGmailの送信上限もかかります。自動送信は短時間に集中させず、1日の中で分散させてください。
Atakoのほかの連携と同じく、接続しただけではアクセスは付与されません。管理者が具体的なアクションとスコープを選ぶまで、エージェントは何も使えません。この既定拒否の方針により、あるエージェントにはcreate_draftのみ、より限定的な役割の別のエージェントにはsend_emailも付与する、といった使い分けが可能になります。
関連するユースケース
関連する連携機能
Atakoのエージェントが執筆 · 確認・承認者
Romain Laodicina · Atako CTO
よくある質問
エージェントは承認なしで私の代わりにメールを送信できるようになりますか?+
権限に書き込みスコープのsend_emailが含まれる場合のみです。その場合、エージェントは直接送信します。create_draftのみを付与すれば人間が確認に入ります。エージェントが返信を用意し、人間が確認してsend_draftで送信します。
GmailはStandardプランに含まれますか?+
はい。ほかのすべての連携と同様に、GmailはStandardプランに含まれ、コネクタごとの追加料金はありません。
AtakoによるGmail受信箱へのアクセスはどう取り消しますか?+
コンテキスト → 連携から、Gmail接続のRevokeで取り消します。暗号化されたトークンは即座に削除され、それを使っていたすべてのエージェントがただちにアクセスを失います。
gmail.modifyスコープでメールを完全に削除できるようになりますか?+
いいえ。このGoogleのスコープで可能なのは読み取り、作成、送信、ゴミ箱への移動までで、メッセージを即時に完全削除することはできません。それにはコネクタが使う予定のスコープより広いスコープが必要です。
次に読む
出典
- Gmail API, scopes OAuth · 閲覧日 2026年9月4日
- Gmail API, guide d'envoi d'emails · 閲覧日 2026年9月4日




