tencent cloud

Feedback

Email Event Notification

Last updated: 2022-06-10 15:35:48

    Tencent Cloud will notify the callback address of delivery success, delivery failure, email bounce, email open, click on link, unsubscription, and other events. The protocol format of event pushes is as below:

    Sample Request

    {
       "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
    }
    
    Field Type Description
    event string Event type. For more information, see Email Event Notification.
    email string Recipient address
    link string Clickable URL in the email. This field takes effect only when the value of event is click.
    bulkId string MessageId returned by SendEmail
    timestamp int Event occurrence timestamp
    reason string Cause of email delivery failure
    bounceType string Rejection type when the email is rejected by the recipient's email service provider (ESP). Valid values: soft_bounce | hard_bounce. This field takes effect only when the value of event is bounce.
    username string Tencent Cloud account appId
    from string Sender address (without sender name)
    fromDomain string Sender domain
    templateId int Template ID

    Event Types

    Value Description
    deferred The delivery of the email has been delayed by the recipient's ESP and is being retried.
    delivered Delivery is successful. The recipient's ESP receives the email.
    dropped The email cannot be delivered and is dropped for some reasons.
    open The recipient opens the email.
    click The recipient clicks the URL in the email.
    bounce The recipient’s ESP rejects the email (usually because the email address is incorrect).
    spamreport The recipient reports the email.
    unsubscribe The recipient clicks the unsubscribe button. The unsubscribe URL should contain the "unsubscribe" keyword.
    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support