웹사이트의 메일 보내기 기능은 매우 중요한 핵심기능 중의 하나입니다. 만약, 메일 보내기 기능이 제대로 동작하지 않는다면, 회원 가입 알림이 안 가거나, 연락 폼 이메일이 스팸으로 분류되거나, 심지어 아예 이메일이 전송되지 않는 경우가 많아요. 이러한 문제를 해결하기 위한 가장 효과적인 방법 중 하나가 Gmail 또는 Google Workspace(구 G Suite)의 SMTP 서버를 사용하는 것입니다. 오늘은 무료 플러그인인 FluentSMTP를 활용해 이 설정을 간단하게 진행하는 방법을 자세히 안내해 드릴게요.
이 가이드는 유튜브 채널 WPManageNinja의 영상 “How to configure Gmail SMTP/Google Workspace SMTP on WordPress”를 기반으로 작성되었습니다. 영상은 7분 정도의 짧은 길이지만, 단계별로 명확하게 설명되어 있어 초보자도 쉽게 따라할 수 있어요.
지메일(Gmail)로 이메일 전송기능을 구현하기 위해 필요한 것
- 지메일 또는 구글 워크스페이스 계정 (도메인 이메일 가능)
- Google Cloud Console 접근권한 (무료로 가입 가능)
- 애플리케이션 클라이언트 ID (Application Client ID)
- 애플리케이션 클라이언트 시크릿 (Application Client Secret)
우선 지메일 계정이 있다면 기존 지메일 계정을 사용해도 되지만 없다면 새로 지메일 계정을 생성해야 합니다.
왜 Gmail SMTP를 WordPress에 설정해야 할까?
WordPress의 기본 이메일 시스템은 PHP mail() 함수를 사용하지만, 이는 호스팅 서버의 설정에 따라 불안정하고 스팸 필터에 걸리기 쉽습니다. Gmail SMTP를 사용하면:
- 이메일 전달률이 크게 향상됩니다.
- 스팸 폴더로 가는 문제를 최소화할 수 있어요.
- 무료 Gmail 계정이나 유료 Google Workspace 도메인 이메일을 활용할 수 있습니다.
- FluentSMTP 플러그인은 Gmail 외에도 Amazon SES, MailGun, SendGrid 등 다양한 SMTP 서비스를 지원해 유연합니다.
FluentSMTP는 WordPress 플러그인 저장소에서 무료로 다운로드할 수 있으며, 설치 후 5분 만에 설정이 완료됩니다. 이제 단계별로 따라가 보세요!
준비물
- WordPress 사이트 관리자 권한.
- Gmail 또는 Google Workspace 계정 (도메인 이메일 가능).
- Google Cloud Console 접근 (무료로 가입 가능).
단계 1: FluentSMTP 플러그인 설정에서 SMTP 제공자로 구글/구글워크스페이스 선택
플러그인 설정 페이지로 이동하면, 다양한 SMTP 제공자 옵션이 보일 거예요. 여기서 “Gmail/Google Workspace”를 선택하세요. 이 플러그인은 간단한 인터페이스로 여러 SMTP 연결을 관리할 수 있어 편리합니다.
단계 2: Google Cloud Console에서 프로젝트 생성 및 API 활성화
Google의 보안 정책 때문에 OAuth 인증이 필요합니다. 이는 앱이 이메일을 안전하게 보낼 수 있도록 해줍니다.
- Google Cloud Console로 이동하세요. (Google 계정으로 로그인).
- 상단에서 새 프로젝트를 클릭하고, 프로젝트 이름을 “Fluent SMTP Connector”처럼 입력한 후 생성합니다.
- 프로젝트가 생성되면, 왼쪽 메뉴에서 API 및 서비스 > 라이브러리로 가세요.
- 검색 창에 “Gmail API”를 입력하고, 해당 API를 선택한 후 활성화 버튼을 클릭합니다.
이 단계는 약 1-2분 정도 소요됩니다. API가 활성화되면 OAuth 설정으로 넘어갈 준비가 됩니다.
단계 3: OAuth Consent Screen 설정
OAuth는 사용자가 앱에 권한을 부여하는 과정입니다. 여기서 “External” 옵션을 선택해 테스트 목적으로 사용하세요.
- API 및 서비스 > OAuth 동의 화면으로 이동합니다.
- 앱 유형을 “External”로 선택하고 진행하세요.
- 앱 정보를 입력합니다:
- 앱 이름: “Fluent SMTP” (또는 원하는 이름).
- 사용자 지원 이메일: Gmail 계정 이메일 주소.
- 앱 로고: 생략 가능.
- 앱 도메인: 홈페이지 URL (WordPress 사이트 URL), 애플리케이션 홈페이지, 개인정보처리방침, 이용약관 (모두 WordPress 사이트 URL로 입력).
- 승인된 도메인: “google.com”과 WordPress 사이트 도메인을 추가.
- 범위(scope) 섹션에서 기본 설정을 유지하고, 다음으로 넘어갑니다.
- 테스트 사용자 추가: 사용할 Gmail 또는 Google Workspace 이메일 주소를 추가하세요. (예: your.email@gmail.com)
- 설정을 저장합니다.
이 화면은 앱이 Google에 등록되는 과정으로, 보안 목적입니다. 테스트 모드에서는 100명까지의 사용자만 지원되지만, 개인 사이트에는 충분합니다.
단계 4: OAuth 클라이언트 ID 및 Secret 생성
- API 및 서비스 > 사용자 인증 정보로 이동하세요.
- 사용자 인증 정보 만들기 > OAuth 클라이언트 ID를 클릭합니다.
- 애플리케이션 유형을 “Desktop app”으로 선택하고, 이름을 입력한 후 생성하세요. (주의: 일부 사용자는 “Web App”을 사용해야 할 수 있으며, 리디렉션 URI가 필요할 수 있습니다. 영상은 Desktop app을 추천하지만, 오류 발생 시 Web App으로 시도하세요.)
- 생성된 클라이언트 ID와 클라이언트 Secret을 복사합니다.
단계 5: FluentSMTP에서 Google 연결 설정
- WordPress의 FluentSMTP 설정 페이지로 돌아가세요.
- “Gmail/Google Workspace” 연결에서 클라이언트 ID와 Secret을 붙여넣습니다.
- “Sender Email”에 사용할 이메일 주소를 입력하세요 (OAuth Consent Screen에 추가한 이메일).
- “Authenticate with Google to Get Access Token” 버튼을 클릭합니다.
- Google 인증 페이지로 리디렉션되면, 해당 이메일 계정을 선택하고 “허용”을 클릭하세요.
- 인증 코드가 표시되면 복사해서 FluentSMTP에 붙여넣습니다.
- 연결 설정을 저장하세요.
단계 6: 테스트 이메일 보내기 및 확인
- FluentSMTP 설정 페이지 하단에서 “Test Email” 섹션으로 이동하세요.
- 받는 사람 이메일 주소를 입력하고, “Send Test Email”을 클릭합니다.
- 이메일이 성공적으로 전송되면 받은 편지함을 확인하세요. (스팸 폴더도 체크!)
테스트가 성공하면 WordPress의 모든 이메일 (회원 가입, 비밀번호 재설정, 연락 폼 등)이 Gmail SMTP를 통해 안정적으로 전송됩니다.
흔한 문제 해결 팁
- 인증 오류: 테스트 사용자 목록에 이메일을 추가했는지 확인하세요.
- 이메일 지연: Google의 보안으로 인해 처음에는 지연될 수 있습니다.
- 출판 모드 전환: 테스트 후 OAuth Consent Screen을 “Publishing” 모드로 변경하면 더 많은 사용자를 지원할 수 있습니다.
- 대안: FluentSMTP 외에 WP Mail SMTP나 다른 플러그인을 고려할 수 있지만, FluentSMTP는 무료이고 다기능입니다.
