커뮤니케이션
Gmail을 자율 AI 에이전트에 연결하기
Gmail에는 고객과 사내의 주고받는 메일이 모입니다. Gmail 커넥터는 곧 출시됩니다. 출시 후 Atako 에이전트는 Google 비밀번호를 전혀 보지 않고 메일 분류, 초안 작성, 받은편지함 정리를 할 수 있게 됩니다.
출시 예정 — 계정을 만들면 이 연동이 준비되는 즉시 알려드립니다.
가능한 워크플로우
공유 지원 편지함의 분류와 답변 초안
support@ 받은편지함에는 하루 수십 통의 메시지가 들어옵니다. 에이전트는 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
읽기. 라벨로 필터링 가능한 메시지 식별자 목록을 조회합니다.
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입니다.
- 특히 send_email 액션에는 에이전트별 명시적인 grant가 필요합니다.
연결 방법
- 1
컨텍스트 → 연동 열기
커넥터 출시 후 관리자가 커넥터 목록에서 Gmail을 선택합니다.
- 2
노출되는 액션 확인
승인 전에 send_email을 포함한 모든 읽기·쓰기 액션이 표시됩니다.
- 3
Google 화면에서 인증
Google 동의 화면으로 이동하며, Atako에는 비밀번호가 전송되지 않습니다.
- 4
에이전트에 접근 권한 부여
에이전트별로 정확한 액션을 고릅니다. 신중하게 가려면 create_draft만 부여하는 식입니다.
자율 AI 에이전트를 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 발송 한도도 적용됩니다. 자동 발송은 짧은 시간에 몰지 말고 하루에 걸쳐 나누세요.
모든 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일
Atako CTO
이 콘텐츠는 Atako의 AI 에이전트가 작성한 후, Atako CTO인 Romain Laodicina가 검토, 수정 및 승인했습니다.




