如何为事务性电子邮件启用Webhooks

webhook是一种接收特定事件通知的机制。你可以设置关于的通知电子邮件的送达订阅者活动。

如何创建Webhook

要连接SMTP webhook，请转到“API”选项卡中的“帐户设置”部分，然后单击“创建webhook”。

激活SMTP电子邮件跟踪，如果您已禁用它。

指定发送事件的处理程序的URL，并标记要发送的事件。

SMTP服务中与发送电子邮件相关的webhook触发的事件列表:

• 交付;
• 不交付;
• 开放;
• 点击链接;
• 报告为垃圾邮件;
• 没订阅
• 软弹
• 硬

发送数据格式

Webhook每30秒触发一次，或者SendPulse收集了500个事件来发送。半岛客户端下载官网

当webhook被触发时，SendPulse发送一个JSON数半岛客户端下载官网据类型的POST请求到指定的URL。

数据以以下格式发送:

[{"event": "event_name"， "timestamp": 1490954061， "message_id": 1149317311， " receiver ": "john.doe@s半岛客户端下载官网endpulse.com"， "sender": "doe.john@m.ekobsc.com"， "subject": "hello world"}]

如果有多个事件，那么它们将被分组到一个或多个请求中:

[{"event": "event_name"， "timestamp": 1490954061， "message_id": 1149317311， " receiver ": "john.doe@s半岛客户端下载官网endpulse.com"， "sender": "doe.john@m.ekobsc.com"， "subject": "hello world"}， {"event": "event_name"， "timestamp": 1490954062， "message_id": 1149317311， " receiver ": "john.doe@m.ekobsc.com"， "sender": "doe.john@m.ekobsc.com"， "subject": "hello world"}， {"event": "event_name"， "timestamp": 1490954063， "message_id": 1149317311， " receiver ": "john.doe@m.ekobsc.com"， "sender":"doe.john@半岛客户端下载官网m.ekobsc.com"， "subject": "utf8_hello_world"}，]

请求格式，取决于事件

交付:

[{"smtp_server_response_code": "250"， "smtp_server_response_subcode": "" "， "sender": "john.doe@半岛客户端下载官网m.ekobsc.com"， "smtp_server_response": "custom_text_response_from_recipients_server"， "timestamp": 1490953933， "message_id": 1149317311， " receiver ": "doe.john@m.ekobsc.com"， "event": "delivered"， "subject": "utf8_hello_world"}]

没有交付:

[{"smtp_server_response_code": "554"， "smtp_server_response_subcode": "5.7.1"， "sender": "john.doe@se半岛客户端下载官网ndpulse.com"， "smtp_server_response": "custom_text_response_from_recipients_server"， "timestamp": 1490956117， "message_id": 1149317311， " receiver ": "doe.john@m.ekobsc.com"， "event": "undelivered"， "subject": "utf8_hello_world"}]

开放:

[{"event": "opened"， "timestamp": 1490962764， "message_id": 1149317311， " receiver ": "doe.john@s半岛客户端下载官网endpulse.com"， "sender": "john.doe@m.ekobsc.com"， "subject": "utf8_hello_world"}]

下面是一个链接:

[{"event": "clicked"， "timestamp": 1490964928， "message_id": 1149317311， " receiver ": "doe.john@s半岛客户端下载官网endpulse.com"， "sender": "john.doe@m.ekobsc.com"， "subject": "utf8_hello_world"}]

没订阅:

[{"event": "unsubscribe "， " receiver ": "john.doe@s半岛客户端下载官网endpulse.com"， "sender": "doe.john@m.ekobsc.com"， "subject": "hello world"}]

报告为垃圾邮件:

[{"event": "spam_by_user"， "timestamp": 1490964607， "message_id": 1145317311， " receiver ": "doe.john@s半岛客户端下载官网endpulse.com"， "sender": "john.doe@m.ekobsc.com"， "subject": "utf8_hello_world"}]

接收软弹:

[{"smtp_server_response_code": 550， "smtp_server_response_subcode": "5.1.0"， "task_id": 17076325， "smtp_server_response": " vch15@i.ua MX: mx23.i. i "。ua RESP:邮箱超过配额。参见http://mail.i.ua/err/4/"， "timestamp": 1658998170， "event": "soft_bounces"， "email": "example@example.com"}]

接收硬反弹:

[{"smtp_server_response_code": 550， "smtp_server_response_subcode": "5.1.1"， "task_id": 17076325， "smtp_server_response": "example@example.com MX: MX .dereck.cn.ua RESP: 5.1.1 : receiver address rejected: User unknown in local receiver table"， "timestamp": 1658998170， "event": "hard_bounces"， "email": "example@example.com"}]

一个在PHP中接受请求的脚本示例:

<？PHP $json_string = file_get_contents(' PHP://input');$data_array = json_decode($json_string, true);? >

最后更新:22.03.2023