Bỏ qua để đến nội dung

Sự kiện gửi thư và đồng bộ danh sách chặn gửi

Giải thích
Dành cho:
Quản trị viên không gian làm việc
Cần quyền:
providers:view
Trong ứng dụng:
Nhà cung cấp gửi thư, rồi Sự kiện và đồng bộ

Mỗi nhà cung cấp gửi thư báo lại chuyện gì đã xảy ra với thư của bạn theo định dạng riêng: Amazon SES qua thông báo SNS, Postmark và Mailgun qua webhook, máy chủ SMTP qua thư trả lại trong một hộp thư. ReputeCast chuyển các sự kiện webhook bounce email, gửi thành công và khiếu nại này thành một mô hình sự kiện chuẩn hóa duy nhất, giữ mã gốc của nhà cung cấp bên cạnh, và chia sẻ mọi thư trả lại và khiếu nại qua một danh sách chặn gửi dùng chung.

  1. Nhà cung cấp gọi ReputeCast. Mỗi nhà cung cấp đã kết nối có địa chỉ webhook riêng, https://<public URL>/hooks/<adapter>/<token>. Trình hướng dẫn kết nối đăng ký địa chỉ này ở nhà cung cấp giúp bạn, hoặc hiển thị nó để bạn tự dán vào. Hãy đọc Kết nối nhà cung cấp gửi thư.
  2. ReputeCast kiểm tra chữ ký. Mỗi adapter xác minh yêu cầu theo đúng cách nhà cung cấp của nó ký (chữ ký SNS với Amazon SES, HMAC với Mailgun, chữ ký ECDSA với SendGrid, khóa bí mật dùng chung với các nhà cung cấp không ký). Yêu cầu không hợp lệ nhận phản hồi 401 và không bao giờ được xử lý; 2 KB đầu tiên của nó được giữ lại để chẩn đoán.
  3. ReputeCast lưu payload gốc và trả lời ngay. Payload đã xác minh được lưu nguyên trạng và nhà cung cấp nhận 200 ngay lập tức, nên việc xử lý chậm không bao giờ khiến nhà cung cấp gửi lại hay bỏ cuộc. Nếu không lưu được, ReputeCast trả lời 429 kèm Retry-After: 30 thay vì 5xx, vì một số nhà cung cấp bỏ sự kiện sau khi gặp lỗi máy chủ.
  4. Một tác vụ nền chuẩn hóa payload. Payload trở thành một hoặc nhiều sự kiện chuẩn hóa, được ghép với thư mà ReputeCast đã gửi. Sự kiện bị gửi lại được nhận ra và chỉ tính một lần.
  5. Sự kiện có hiệu lực. Nó cập nhật trạng thái của thư, các bộ đếm của chiến dịch theo nhà cung cấp hộp thư và nhà cung cấp gửi thư, và số liệu hằng ngày của nhà cung cấp. Trả thư vĩnh viễn, khiếu nại và hủy đăng ký do nhà cung cấp báo về sẽ đưa địa chỉ vào danh sách chặn gửi dùng chung, và liên hệ được đánh dấu là bị trả thư hoặc đã khiếu nại.

Các nhà cung cấp không có webhook đi cùng con đường đó từ bước 4: ReputeCast đọc thư trả lại từ hộp thư nhận thư trả lại của máy chủ SMTP mỗi phút, và hỏi định kỳ API sự kiện của Mailgun hoặc SparkPost mỗi phút khi bạn chọn hỏi định kỳ trong trình hướng dẫn kết nối.

Sự kiện Ý nghĩa Chặn gửi địa chỉ
delivered Máy chủ thư nhận đã chấp nhận thư. Không
deferred Việc chuyển phát bị hoãn do lỗi tạm thời; nhà cung cấp sẽ thử lại. Không
hard_bounce Chuyển phát thất bại vĩnh viễn, ví dụ vì hộp thư không tồn tại. Có
soft_bounce Chuyển phát thất bại vì một lý do có thể chỉ là tạm thời, như hộp thư bị đầy. Không
complaint Người nhận đánh dấu thư là spam (một báo cáo từ vòng phản hồi). Có
rejected Nhà cung cấp từ chối gửi thư ngay từ đầu. Không
open Một lượt mở do nhà cung cấp theo dõi. Không
click Một lượt nhấp do nhà cung cấp theo dõi. Không
unsubscribe Một lượt hủy đăng ký mà nhà cung cấp nhận được. Có

Mỗi sự kiện giữ loại sự kiện gốc của nhà cung cấp (như Bounce · Permanent · General hay HardFail), mã gốc (như 550 5.1.1) và nội dung chẩn đoán. Thư trả lại còn được gán một loại thư trả lại: mailbox_unknown, mailbox_full, domain_invalid, policy_block, spam_block, reputation, temporary hoặc other. Nhóm này cho bạn biết vì sao thư thất bại, bất kể từng nhà cung cấp diễn đạt thế nào; hãy đọc Thư trả lại, khiếu nại và giới hạn của nhà cung cấp và Mã lỗi SMTP.

ReputeCast tự theo dõi lượt mở và lượt nhấp. Sự kiện open và click của nhà cung cấp chỉ được tính khi bạn chọn giữ theo dõi của nhà cung cấp đó (xem Kiểm tra theo dõi phía nhà cung cấp).

Nhà cung cấp gửi thư, rồi Sự kiện và đồng bộ bắt đầu bằng Nhật ký sự kiện: mọi sự kiện gốc từ nhà cung cấp đặt cạnh dạng chuẩn hóa của nó, mã gốc và nội dung chẩn đoán, người nhận (đã được che bớt) và chiến dịch, quy trình tự động hay thư hệ thống mà sự kiện thuộc về. Lọc theo nhà cung cấp gửi thư hoặc loại sự kiện, hoặc tìm theo người nhận hay mã thư.

Nhật ký sự kiện: các sự kiện gốc từ Postmark, Amazon SES và Postal đặt cạnh loại đã chuẩn hóa (gửi thành công, trả thư vĩnh viễn, hoãn nhận, khiếu nại, trả thư tạm thời, bị từ chối), mỗi sự kiện kèm mã SMTP gốc và nội dung chẩn đoán.

Xuất CSV tải xuống các sự kiện đã lọc. Người nhận vẫn được che bớt trừ khi bạn có quyền subscribers:export, và mọi lần xuất đều được ghi vào nhật ký kiểm tra.

Một thư trả lại hay khiếu nại ở một nhà cung cấp sẽ dừng việc gửi đến địa chỉ đó trên mọi nhà cung cấp. Thẻ Đồng bộ danh sách chặn gửi dùng chung cho biết từng nhà cung cấp tham gia như thế nào:

  • Hai chiều: ReputeCast kéo các địa chỉ bị chặn của chính nhà cung cấp về danh sách dùng chung và đẩy các địa chỉ chặn gửi mới của danh sách dùng chung ra danh sách chặn của nhà cung cấp.
  • Chỉ kéo về: nhà cung cấp liệt kê được các địa chỉ bị chặn nhưng API của nó không nhận địa chỉ mới (Brevo). ReputeCast kéo các địa chỉ đó về.
  • Chỉ cục bộ (hiển thị là Áp dụng cục bộ): nhà cung cấp không có API danh sách chặn (Postal, SMTP, Azure Communication Services, adapter HTTP chung). ReputeCast kiểm tra danh sách dùng chung trước mỗi lần gửi.

Việc đồng bộ chạy mỗi 15 phút cho mọi nhà cung cấp, và chạy sớm ngay sau khi một sự kiện thêm địa chỉ chặn gửi mới. Để chạy ngay, chọn Đồng bộ tất cả ngay (cần quyền providers:manage). Thẻ cho biết mỗi nhà cung cấp đã kéo về và đẩy đi những gì, lần đồng bộ gần nhất và lỗi nếu có. Hãy đọc Danh sách chặn gửi để thêm, tải lên hoặc gỡ địa chỉ thủ công.

Một số nhà cung cấp tự thêm pixel theo dõi lượt mở hoặc viết lại liên kết để theo dõi lượt nhấp. Khi có thêm tính năng theo dõi của ReputeCast, lượt mở bị đếm hai lần và liên kết bị viết lại hai lần. Mỗi ngày một lần, ReputeCast đọc cài đặt theo dõi của từng nhà cung cấp, và thẻ Kiểm tra theo dõi phía nhà cung cấp liệt kê những gì nó tìm thấy. Với một nhà cung cấp có theo dõi, bạn có thể:

  • tắt tính năng theo dõi của nhà cung cấp qua API của nó (ở những nơi API cho phép),
  • giữ theo dõi của nhà cung cấp và bỏ qua theo dõi của ReputeCast, hoặc
  • quay lại dùng theo dõi của ReputeCast.

Brevo tự thêm theo dõi riêng theo mặc định; hãy đọc Gửi bằng Brevo.

Thiết lậpMặc địnhCách thay đổi
Giới hạn tốc độ theo nhà cung cấp hộp thưGmail no limit; Outlook 5/s; Yahoo 4/s; iCloud 3/sCài đặt › Nhà cung cấp, 0–10,000 thư mỗi giây (0 = không giới hạn)
Đồng bộ danh sách chặn gửi với nhà cung cấpEvery 15 minutes, and right after a bounce adds addresses—
Kiểm tra tình trạng nhà cung cấpEvery 5 minutes; every minute while a provider is down or degradedCố định
Nhà cung cấp bị đánh dấu gián đoạn2 failed health checks in a row, or 50% of calls failing over 3 minutes (at least 5 calls)Cố định; thông tin xác thực bị từ chối sẽ đánh dấu gián đoạn ngay
Thời gian ổn định cần có trước khi lưu lượng chuyển về sau sự cố gián đoạn10 minutesCố định
Trạng thái "Webhook im lặng" sau6 hours without an event while mail is being acceptedCố định; nhà cung cấp SMTP được miễn (vì dùng hộp thư nhận thư trả lại)
Thời gian giữ sự kiện webhook gốc của nhà cung cấp90 daysCố định
Payload webhook lớn nhất từ nhà cung cấp5 MiBCố định
Khóa bí mật webhook của nhà cung cấp sau khi xoay vòngThe new secret replaces the old one at onceCài đặt › Nhà cung cấp › Khóa bí mật ký webhook
Hỏi định kỳ hộp thư nhận thư trả lại (nhà cung cấp SMTP)Every minute, up to 200 messages each timeCố định
Hỏi định kỳ sự kiện khi chưa thiết lập webhookEvery minuteKết nối nhà cung cấp › Tạm dùng hỏi định kỳ
Thời gian chờ sự kiện gửi thành công của thư thử khi thiết lập30 minutesCố định
Số thư mỗi lệnh gọi APIAmazon SES 50, Postmark 500, Resend 100, Mailjet 50, SMTP 25 per connection; other built-in adapters 1Cố định