Scribe가 Google Workspace로 서명을 전송할 때 대상에 Failed 상태와 함께 “User not found on Google Workspace” 메시지가 표시되는 경우, 대부분 Gmail에서 제대로 설정되지 않은 이메일 별칭 때문이에요.
이 문서에서는 이 오류가 발생하는 이유와 해당 별칭을 사용자의 Gmail 계정에 Send mail as 주소로 추가해 해결하는 방법을 설명해요.
이 오류가 발생하는 이유
Google Workspace는 기본 주소와 별칭을 다르게 처리해요. 별칭은 별도 설정 없이 메일을 받을 수 있지만, 해당 별칭으로 메일을 보내거나 별칭에 연결된 서명을 적용하려면 Gmail이 그 주소를 Send mail as 주소로 명시적으로 인식하고 있어야 해요.
별칭이 Google Workspace 관리자 수준에만 존재하고 사용자의 Gmail 설정에 추가된 적이 없으면, Scribe가 서명을 할당하려고 할 때 Google API가 “User not found” 응답을 반환해요. 별칭이 Gmail에 등록되기 전까지는 서명을 배포할 수 없어요.
해결 방법
사용자(또는 사용자를 대신하는 관리자)가 본인의 Gmail 계정에서 해당 별칭을 Send mail as 주소로 추가해야 해요. 이 단계를 마치면 다음 동기화 시 Scribe가 서명을 전송할 수 있어요.
Gmail 설정 열기
별칭을 소유한 Google 계정으로 로그인한 다음 Gmail을 엽니다. 오른쪽 상단의 톱니바퀴 아이콘을 클릭하고 모든 설정 보기를 선택해요.
계정 탭으로 이동
설정 패널에서 계정 및 가져오기 탭을 열어요. 일부 Google Workspace 계정에서는 계정으로만 표시되기도 해요.
별칭을 다른 주소에서 메일 보내기로 추가
다른 주소에서 메일 보내기 섹션에서 다른 이메일 주소 추가를 클릭해요. 표시 이름과 별칭 이메일 주소를 입력한 다음 안내에 따르세요. Google이 주소 소유권 확인을 위해 인증 메시지를 보낼 수 있어요.
별칭이 목록에 표시되는지 확인
추가가 완료되면 다른 주소에서 메일 보내기 목록에 별칭이 나타나요. 이제 메일을 작성할 때 이 주소를 선택할 수 있어요.
Scribe에서 다시 동기화
Scribe로 돌아가 해당 팀원에 대해 서명을 다시 푸시해요. 서명이 정상적으로 적용되고 대상 상태가 Failed에서 Sent로 바뀌어요.
Google Workspace에서 별칭을 최근에 추가했다면, Scribe에서 푸시를 다시 시도하기 전에 변경 사항이 반영될 때까지 몇 분 정도 기다려 주세요.
여전히 오류가 표시되나요?
별칭을 다른 주소에서 메일 보내기로 추가한 뒤에도 오류가 계속된다면 다음 항목을 확인해 보세요. Gmail에서 별칭이 대기 상태가 아니라 완전히 인증되었는지 확인하세요. 팀원의 Google Workspace 계정이 정지되었거나 다른 조직 단위로 이동되지 않았는지 확인하세요. Scribe와 Google Workspace의 연동이 올바른 관리자 권한으로 여전히 연결되어 있는지 확인하세요. 이 내용은 설정에서 연동으로 이동해 검토할 수 있어요.
모든 정보가 올바른데도 오류가 계속되면 Scribe 안에서 지원팀에 문의해 주세요. 전체 API 응답을 확인해 드릴 수 있어요.