제품 소개

제품 개요

제품 기능

제품 장점

사용 사례

사양

구매 가이드

요금 안내

시작하기

이메일 설정

이메일 발송

신뢰도 등급

콘솔 가이드

이메일 설정

이메일 전송

데이터 통계

SMTP 문서

SMTP 이메일 전송 가이드

SMTP 서비스 주소

Java 호출 예시

Go 호출 예시

PHP 호출 예시

첨부파일이 있는 이메일 전송

오류 코드

Webhook 문서

이메일 이벤트 알림

전송 제한

첨부파일 유형

FAQ

시작하기

과금

전송 제한

전송 기능

도메인

템플릿

신원 확인 및 설정

전용 IP

전송

API 사용

콜백

스팸함

보안성

주의 사항

기타 질문

고객센터

이메일 이벤트 알림

PDF

포커스 모드

폰트 크기

마지막 업데이트 시간: 2025-10-15 19:42:06

콜백 주소를 설정하면 Tencent Cloud는 ‘전송 성공, 이메일 거부, 이메일 반송, 이메일 오픈, 링크 클릭, 구독 취소’ 및 기타 이벤트 알림을 콜백 주소에 전달합니다. SES 콘솔에서 콜백 주소를 구성할 수 있습니다. 자세한 내용은 콜백 주소를 참고하십시오.
요청 예시
{
    "event":"bounce",
    "email":"example@example.com",
    "bulkId":"qcloudses-30-251200670-date-20220601142439-8jolHvR2XcXC1",
    "timestamp":1654064683,
    "reason":"551 5.1.1 recipient is not exist",
    "bounceType":"hard_bounce",
    "username":"251200670",
    "from":"test@fromexample.com",
    "fromDomain":"fromexample.com",
    "templateId":123456
}
필드
유형
설명
event
string
이벤트 유형. 자세한 내용은 이메일 이벤트 알림 참고
email
string
수신자 주소
link
string
이메일에서 클릭 가능한 URL. 이 필드는 event="click"일 때 적용
bulkId
string
SendEmail 에서 반환된 MessageId
timestamp
int
이벤트 발생 타임스탬프
reason
string
이메일 발송 실패 원인
bounceType
string
수신자의 이메일 서비스 공급자(ESP)가 이메일을 거부한 경우의 거부 유형. 유효 값: soft_bounce | hard_bounce. 이 필드는 event="bounce"인 경우에만 적용
username
string
Tencent Cloud 계정 appId
from
string
발신자 주소(발신자 이름 제외)
fromDomain
string
발신자 도메인
templateId
int
템플릿 Id
useragent
string
유저 에이전트는 이메일에 접근하는 데 사용되는 기기, 운영 체제 및 브라우저에 대한 정보를 제공합니다. 이는 이벤트="열기" 또는 이벤트="클릭"일 때만 유효합니다
subject
String
이메일 제목에 ASCII가 아닌 문자(예: 중국어)가 포함되어 있으면 MIME 인코딩을 사용하여 이스케이프됩니다.
messageId
String
Message-ID는 SMTP 프로토콜 헤더의 필드로, 사용자가 SMTP 또는 API를 통해 이메일을 전송할 때 고유한 사용자 지정 식별자를 입력할 수 있는 필드입니다. 이 식별자는 이메일 메시지를 고유하게 식별하고 RFC5322 표준을 준수해야 합니다.
eventid
Int
1:delivered
2:dropped
3:bounce
4:open
5:click
6:spamreport
7:unsubscribe
8:deferred
taskId
int
 일괄 전송 작업의 taskId
이벤트 유형
Value
Description
deferred
이메일 전달이 수신자의 ESP에 의해 지연되어 재시도 중
delivered
전달 성공. 수신자의 ESP가 이메일을 수신.
dropped
이메일을 전달할 수 없으며 어떤 이유로 인해 삭제됨
open
수신자가 이메일을 오픈함
click
수신자가 이메일의 URL을 클릭함
bounce
수신자의 ESP가 이메일을 거부함(일반적인 원인은 잘못된 이메일 주소)
spamreport
수신자가 이메일을 신고함
unsubscribe
수신자가 ‘구독 취소’ 버튼을 클릭함. 구독 취소 URL에는 "unsubscribe" 키워드가 포함되어야 함.
﻿

도움말 및 지원

문제 해결에 도움이 되었나요?

더 자세한 내용은 문의하기 또는 티겟 제출 을 통해 문의할 수 있습니다.

피드백

tencent cloud

Simple Email Service

이메일 이벤트 알림

요청 예시

이벤트 유형

도움말 및 지원

필드	유형	설명
event	string	이벤트 유형. 자세한 내용은 이메일 이벤트 알림 참고
email	string	수신자 주소
link	string	이메일에서 클릭 가능한 URL. 이 필드는 `event="click"`일 때 적용
bulkId	string	SendEmail 에서 반환된 MessageId
timestamp	int	이벤트 발생 타임스탬프
reason	string	이메일 발송 실패 원인
bounceType	string	수신자의 이메일 서비스 공급자(ESP)가 이메일을 거부한 경우의 거부 유형. 유효 값: soft_bounce \| hard_bounce. 이 필드는 `event="bounce"`인 경우에만 적용
username	string	Tencent Cloud 계정 appId
from	string	발신자 주소(발신자 이름 제외)
fromDomain	string	발신자 도메인
templateId	int	템플릿 Id
useragent	string	유저 에이전트는 이메일에 접근하는 데 사용되는 기기, 운영 체제 및 브라우저에 대한 정보를 제공합니다. 이는 이벤트="열기" 또는 이벤트="클릭"일 때만 유효합니다
subject	String	이메일 제목에 ASCII가 아닌 문자(예: 중국어)가 포함되어 있으면 MIME 인코딩을 사용하여 이스케이프됩니다.
messageId	String	Message-ID는 SMTP 프로토콜 헤더의 필드로, 사용자가 SMTP 또는 API를 통해 이메일을 전송할 때 고유한 사용자 지정 식별자를 입력할 수 있는 필드입니다. 이 식별자는 이메일 메시지를 고유하게 식별하고 RFC5322 표준을 준수해야 합니다.
eventid	Int	1:delivered 2:dropped 3:bounce 4:open 5:click 6:spamreport 7:unsubscribe 8:deferred
taskId	int	일괄 전송 작업의 taskId

Value	Description
deferred	이메일 전달이 수신자의 ESP에 의해 지연되어 재시도 중
delivered	전달 성공. 수신자의 ESP가 이메일을 수신.
dropped	이메일을 전달할 수 없으며 어떤 이유로 인해 삭제됨
open	수신자가 이메일을 오픈함
click	수신자가 이메일의 URL을 클릭함
bounce	수신자의 ESP가 이메일을 거부함(일반적인 원인은 잘못된 이메일 주소)
spamreport	수신자가 이메일을 신고함
unsubscribe	수신자가 ‘구독 취소’ 버튼을 클릭함. 구독 취소 URL에는 "unsubscribe" 키워드가 포함되어야 함.