tencent cloud

メール通知イベント

Download
フォーカスモード
フォントサイズ
最終更新日: 2025-10-15 19:42:06
コールバックアドレスを設定すると、Tencent Cloudは「配信成功、Tencent Cloudによる配信拒否、ESPバウンス、ユーザーのメール開封、リンクのクリック、購読解除」などのイベント発生後にコールバックアドレスに通知します。コールバックアドレス設定の操作は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
受信者のメールサービスプロバイダがメールを受信拒否した場合、受信拒否のタイプと値は、soft_bounce | hard_bounceで、event="bounce"のときのみ有効です
username
string
Tencent Cloudアカウントに対応するappId
from
string
送信アドレス(送信者のエイリアスなし)
fromDomain
string
送信ドメイン名
templateId
int
テンプレートID
useragent
string
ユーザーエージェントは、電子メールにアクセスするために使用されるデバイス、オペレーティングシステム、およびブラウザに関する情報を提供します。これは、イベント="open"またはイベント="click"の場合にのみ有効です
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
メールは受信者のメールサービスプロバイダによりメール配信が遅延し、再試行中です
delivered
配信に成功しました。受信者のメールサービスプロバイダがメッセージを受信しました
dropped
何らかの理由でこのメールは到達せず、破棄されました
open
受信者がこのメールを開封しました
click
受信者がこのメールにあるリンクをクリックしました
bounce
受信者のメールサービスプロバイダがこのメールの受信を拒否しました(通常はEメールアドレスが間違っているため)
spamreport
受信者がこのメールを通報しました
unsubscribe
受信者が業務サイドの「購読解除」ボタンをクリックした場合、業務サイドは購読解除リンクに「unsubscribe」というキーワードを含める必要があります


ヘルプとサポート

この記事はお役に立ちましたか?

フィードバック