Thiết Lập Webhook Của Bạn
Trong menu webhook của Mailtarget, bạn có thể dễ dàng đẩy các sự kiện tin nhắn trực tiếp đến các endpoint của mình. Tuy nhiên, bạn cần quản lý endpoint tại đây bằng cách nhấp vào nút Create Webhook.
Hãy làm theo và hoàn thành các bước để thêm webhook của bạn vào Mailtarget. Nhập tên webhook, URL mục tiêu, nguồn hoạt động nhận và bạn có thể chọn những hoạt động nào bạn muốn theo dõi. Tất cả hoạt động hoặc các hoạt động cụ thể tùy thuộc vào nhu cầu của bạn. Mailtarget có thể theo dõi:
Bounce
Delay
Injection
Open
Click
Delivery
Sau đó, bạn có thể cài đặt phương pháp xác thực:
None = URL mục tiêu không yêu cầu bất kỳ hình thức xác thực nào.
Basic auth = Tên người dùng và mật khẩu liên kết với URL mục tiêu sẽ được gửi qua header trong khi thực hiện yêu cầu. Nếu bạn chọn Basic auth, bạn cần nhập tên người dùng và mật khẩu để xác thực.
Sau khi tạo webhook, trạng thái mặc định sẽ là Enable. Tuy nhiên, bạn có thể thay đổi trạng thái thành Disable bằng cách nhấp vào tên webhook, nhấp vào nút Edit Webhook, sau đó thay đổi trạng thái thành Disable.
Kiểm Tra Webhook Của Bạn
Trong chi tiết webhook của bạn, có thông tin về thiết lập gần đây nhất của bạn và có 3 menu bạn có thể truy cập và thử nghiệm, một trong số đó là menu Test.
Tại đây, bạn có thể thử gửi dữ liệu đến webhook của mình bằng cách nhấp vào nút Send Test Batch. Nếu gửi thành công, sẽ có thông báo Success send test notification. Nếu thất bại, sẽ có thông báo Failed send test notification.
Dưới đây là một ví dụ về yêu cầu webhook:
{
"batchId": "645c2177e3b86a0001887bc6",
"retryCount": 0,
"events": [
{
"status": "injection",
"eventId": "92356927693813856",
"messageId": "000443ee14578172be22",
"subject": "Holiday deals are here!",
"sender": "[email protected]",
"sendingIp": "18.236.253.72",
"recipient": "[email protected]",
"recipientMeta": "{\"customKey\":\"customValue\"}",
"mailboxProvider": "Gsuite",
"recipientDomain": "example.com",
"recipientType": "cc",
"timestamp": 1460989507000
},
{
"status": "delivery",
"eventId": "92356927693813856",
"messageId": "000443ee14578172be22",
"subject": "Holiday deals are here!",
"sender": "[email protected]",
"sendingIp": "18.236.253.72",
"recipient": "[email protected]",
"recipientMeta": "{\"customKey\":\"customValue\"}",
"ipAddress": "18.236.253.72",
"mailboxProvider": "Gsuite",
"recipientDomain": "example.com",
"recipientType": "cc",
"timestamp": 1460989507000,
"injectionTime": 1460989507000
},
{
"status": "open",
"eventId": "92356927693813856",
"messageId": "000443ee14578172be22",
"subject": "Holiday deals are here!",
"sender": "[email protected]",
"sendingIp": "18.236.253.72",
"recipient": "[email protected]",
"recipientMeta": "{\"customKey\":\"customValue\"}",
"ipAddress": "18.236.253.72",
"mailboxProvider": "Gsuite",
"recipientDomain": "example.com",
"recipientType": "cc",
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2272.118 Safari/537.36",
"geoIp": "{\"country\":\"US\",\"region\":\"MD\",\"city\":\"Columbia\",\"latitude\":39.1749,\"longitude\":-76.8375,\"zip\":21046,\"postal_code\":\"21046\"}",
"timestamp": 1460989507000,
"injectionTime": 1460989507000
},
{
"status": "click",
"eventId": "92356927693813856",
"messageId": "000443ee14578172be22",
"subject": "Holiday deals are here!",
"sender": "[email protected]",
"sendingIp": "18.236.253.72",
"recipient": "[email protected]",
"recipientMeta": "{\"customKey\":\"customValue\"}",
"ipAddress": "18.236.253.72",
"mailboxProvider": "Gsuite",
"recipientDomain": "example.com",
"recipientType": "cc",
"targetLinkUrl": "http://example.com",
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2272.118 Safari/537.36",
"geoIp": "{\"country\":\"US\",\"region\":\"MD\",\"city\":\"Columbia\",\"latitude\":39.1749,\"longitude\":-76.8375,\"zip\":21046,\"postal_code\":\"21046\"}",
"timestamp": 1460989507000,
"injectionTime": 1460989507000
},
{
"status": "delay",
"eventId": "92356927693813856",
"messageId": "000443ee14578172be22",
"subject": "Holiday deals are here!",
"sender": "[email protected]",
"sendingIp": "18.236.253.72",
"recipient": "[email protected]",
"recipientMeta": "{\"customKey\":\"customValue\"}",
"ipAddrss": "18.236.253.72",
"mailboxProvider": "Gsuite",
"recipientDomain": "example.com",
"recipientType": "cc",
"bounceClass": "1",
"numRetries": "2",
"timestamp": 1460989507000,
"rawReason": "MAIL REFUSED - IP (17.99.99.99) is in black list",
"reason": "MAIL REFUSED - IP (a.b.c.d) is in black list",
"injectionTime": 1460989507000
},
{
"status": "bounce",
"eventId": "92356927693813856",
"messageId": "000443ee14578172be22",
"subject": "Holiday deals are here!",
"sender": "[email protected]",
"sendingIp": "18.236.253.72",
"recipient": "[email protected]",
"recipientMeta": "{\"customKey\":\"customValue\"}",
"ipAddress": "18.236.253.72",
"mailboxProvider": "Gsuite",
"recipientDomain": "example.com",
"recipientType": "cc",
"bounceClass": "1",
"numRetries": "2",
"timestamp": 1460989507000,
"rawReason": "MAIL REFUSED - IP (17.99.99.99) is in black list",
"reason": "MAIL REFUSED - IP (a.b.c.d) is in black list",
"injectionTime": 1460989507000
},
{
"status": "spam_complaint",
"eventId": "92356927693813856",
"messageId": "000443ee14578172be22",
"subject": "Holiday deals are here!",
"sender": "[email protected]",
"sendingIp": "18.236.253.72",
"recipient": "[email protected]",
"recipientMeta": "{\"customKey\":\"customValue\"}",
"ipAddress": "18.236.253.72",
"mailboxProvider": "Gsuite",
"recipientDomain": "example.com",
"recipientType": "cc",
"fbType": "abuse",
"reportBy": "server.email.com",
"reportTo": "abuse.example.com",
"timestamp": 1677553569000,
"injectionTime": 1460989507000
},
{
"status": "link_unsubscribe",
"eventId": "92356927693813856",
"messageId": "000443ee14578172be22",
"subject": "Holiday deals are here!",
"sender": "[email protected]",
"sendingIp": "18.236.253.72",
"recipient": "[email protected]",
"recipientMeta": "{\"customKey\":\"customValue\"}",
"ipAddress": "18.236.253.72",
"mailboxProvider": "Gsuite",
"recipientDomain": "example.com",
"recipientType": "cc",
"timestamp": 1460989507000,
"injectionTime": 1460989507000,
"targetLinkUrl": "http://example.com",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2272.118 Safari/537.36"
},
{
"status": "list_unsubscribe",
"eventId": "92356927693813856",
"messageId": "000443ee14578172be22",
"subject": "Holiday deals are here!",
"sender": "[email protected]",
"sendingIp": "18.236.253.72",
"recipient": "[email protected]",
"recipientMeta": "{\"customKey\":\"customValue\"}",
"ipAddress": "18.236.253.72",
"mailboxProvider": "Gsuite",
"recipientDomain": "example.com",
"recipientType": "cc",
"timestamp": 1460989507000,
"injectionTime": 1460989507000
}
]
}
Trạng Thái Lô Webhook
Menu Batch Status trong Mailtarget hiển thị trạng thái của webhook đã được kết nối với Mailtarget. Menu này cung cấp chi tiết về dữ liệu thời gian giao hàng hoặc thời gian gửi đến webhook, ID lô, trạng thái, số lần thử và phản hồi nhận được từ webhook của bạn.
Lưu ý rằng nếu webhook của bạn thất bại, hệ thống sẽ thử gửi lại tối đa 7 lần. Nếu vẫn thất bại, bạn sẽ nhận được thông báo qua email để khắc phục vấn đề. Nếu không có sửa chữa trong vòng 7 giờ, webhook sẽ bị vô hiệu hóa.