워드프레스 Contact Form 7 '전송에 실패했습니다' 오류가 발생하는 경우

워드프레스 Contact Form 7 플러그인으로 만든 문의폼에서 문의를 제출할 때 '전송에 실패했습니다. 잠시 후 다시 시도해주세요' 오류가 발생하면서 문의 제출에 실패하는 경우가 있습니다.

하지만 자세한 정보 없이 에러 메시지만으로는 문제의 원인을 파악할 수 없습니다. 메일이 발송되지 않는 경우 WP Mail SMTP 플러그인을 설치하여 세팅하면 해결할 수 있습니다.

워드프레스 Contact Form 7 '전송에 실패했습니다' 오류가 발생하는 경우

워드프레스 문의폼에서 정보를 기입한 후에 제출 버튼을 누르면 '전송에 실패했습니다' 오류 메시지가 표시됨녀서 양식이 제출되지 않는 문제가 발생할 수 있습니다.

이 문제의 정확한 원인을 파악하려면 오류 로그를 확인해야 합니다. 워드프레스 포럼 게시글 "How to resolve "Failed to send your message" problem for Contact Form 7? [closed]"에서 답변자 중 한 명은 아마도 sendmail()을 통해 메일을 발송하는 것을 서버에서 허용하지 않아서 발생할 수 있다면서 WP Mail SMTP 플러그인 사용을 추천하고 있네요.

문제의 사이트의 경우 WP Mail SMTP를 설치하고 활성화했지만 세팅을 하지 않아서 발생하는 문제였습니다.

'사이트에서 전송을 시도한 마지막 이메일이 실패했습니다' 경고와 함께 자세한 오류 로그가 WP Mail SMTP 설정 페이지 상단에 표시되고 있었습니다.

주의! 사이트에서 전송을 시도한 마지막 이메일이 실패했습니다.

이메일 소스: WP Mail SMTP
Mailer: 구글/Gmail

{
	"error": {
		"code": 401,
		"message": "Request is missing required authentication credential. Expected OAuth 2 access token, login cookie or other valid authentication credential. See https://developers.google.com/identity/sign-in/web/devconsole-project.",
		"errors": [
			{
				"message": "Login Required.",
				"domain": "global",
				"reason": "required",
				"location": "Authorization",
				"locationType": "header"
			}
		],
		"status": "UNAUTHENTICATED",
		"details": [
			{
				"@type": "type.googleapis.com/google.rpc.ErrorInfo",
				"reason": "CREDENTIALS_MISSING",
				"domain": "googleapis.com",
				"metadata": {
					"service": "gmail.googleapis.com",
					"method": "caribou.api.proto.MailboxService.SendMessage"
				}
			}
		]
	}
}

자세한 내용은 이메일 테스트를 실행하거나 최신 오류 이벤트를 읽어보십시오.

이 에러의 90% 이상 원인은 다음 중 하나일 수 있습니다.

• Gmail OAuth 재연결 작업 필요
• Google Cloud Console 리디렉션 URI 불일치
• OAuth 동의 화면이 테스트 모드로 설정되어 있음
• Gmail API가 활성화되지 않음
• 도메인/서버 변경 후 재인증을 하지 않음

WP Mail SMTP에서 클라이언트 ID와 클라이언트 시크릿 코드를 입력하고 연동을 해야 작동합니다.

WP Mail SMTP 매뉴얼을 참고하여 Google Cloud Console(구글 클라우드 콘솔)에 접속하여 매뉴얼 대로 설정을 하니 문제가 해결되었습니다.

매뉴얼의 내용이 복잡하여 초보자에게는 어렵게 느껴질 수 있을 것입니다.

클라우드웨이즈를 이용한다면 WP Mail SMTP를 설치할 수도 있지만, Elastic Email 애드온을 구독하여 활성화하고 몇 가지 DNS 레코드 설정을 하면 서번 내의 모든 애플리케이션에서 이메일 전송이 가능해지며 멀티사이트에서도 작동합니다. (WP Mail SMTP의 경우 멀티사이트에서는 유료로 업그레이드해야 합니다.) 

https://avada.tistory.com/2970

클라우드웨이즈: SMTP 이메일 전송 활성화(feat. Elastic Email 애드온)

Elastic Email 애드온은 유료이며 월 0.1달러에 1000통까지 메일 발송이 가능하며, 최대 100만 통까지 전송할 수 있습니다.

WP Mail SMTP 플러그인을 사용하여 무료로 지메일 서버를 통해 메일을 발송하려는 경우 WP Mail SMTP에서 제공하는 매뉴얼을 참고하여 설정할 수 있습니다. 하지만 구글에서 제시하는 방법이 복잡하여 따라 하는 데 어려움을 겪는 분들도 계십니다.

참고로 중요한 사이트인 경우 사용자나 고객이 양식을 제출하면 이메일로 전송되면서 동시에 SMS 문자로 전송되도록 연동하는 것도 고려할 수 있습니다. Contact Form 7, WPForms, Quform 등 다양한 문의 폼 플러그인에서 문자 연동 작업이 가능합니다.

https://avada.tistory.com/3735

워드프레스 Contact Form 7 문의 시 SMS 문자로도 발송되도록 연동하기

https://avada.tistory.com/3787

WPForms 문의 폼 제출 시 SMS 문자 알림 전송 작업

👉 WP Mail SMTP 설정 시 어려움을 겪거나 컨택트 폼 플러그인에서 문자 연동 작업이 필요한 경우 여기에서 서비스(유료)를 의뢰하실 수 있습니다.

마치며

이상에서 Contact Form 7에서 문의 폼 제출 시 '전송에 실패했습니다' 에러가 발생하는 경우 대응 방법에 대하여 살펴보았습니다. Contact Form 7은 심플한 문의 양식을 만들 때 유용하며 보다 수월하게 문의 폼을 만들고 싶은 경우 WPForms를 사용하면 드래그 앤 드롭 방식으로 보다 수월하게 문의 폼을 제작할 수 있습니다.

워드프레스 사이트에서 이메일 전송 오류는 보통 웹호스팅 업체와 관련되어 있습니다. 이메일이 전송되지 않을 경우 먼저 웹호스팅 업체에 문의하여 해결을 시도해보고, 그래도 안 되는 경우 WP Mail SMTP 플러그인을 세팅하면 무료로 지메일 서버를 통해 메일 전송이 가능합니다.

참고

https://avada.tistory.com/3766

워드프레스 Quform 문의폼 플러그인 다음 우편번호 검색 기능 추가하기

https://avada.tistory.com/3612

워드프레스 WPForms 플러그인: 보안 문제로 인해 양식을 제출할 수 없습니다 오류

https://avada.tistory.com/3046

해외웹호스팅: 클라우드웨이즈 vs. 블루호스트 vs. 카페24 비교 (Cloudways vs. Bluehost vs. Cafe24)