Gửi thư bằng Mailgun
Để gửi newsletter bằng Mailgun từ ReputeCast, bạn kết nối một Private API key, khu vực chứa tài khoản Mailgun và tên miền Mailgun bạn dùng để gửi. ReputeCast đăng ký webhook trên tên miền đó, thêm và xác minh tên miền gửi, phát hiện tên miền sandbox và giữ danh sách chặn gửi đồng bộ theo cả hai chiều.
| Loại | API |
|---|---|
| Gửi marketing hàng loạt | Được phép |
| Webhook sự kiện | Do ReputeCast đăng ký; HMAC-SHA256 bằng khóa ký webhook của tài khoản, khung 12 giờ |
| Thiết lập tên miền | API |
| Đồng bộ danh sách chặn gửi | Hai chiều |
| Kích thước lô | 1 |
| Ghi chú | Phát hiện tên miền sandbox và đọc giới hạn gửi hằng tháng của tài khoản. Mỗi thư một lệnh gọi. Có thể hỏi định kỳ API sự kiện của Mailgun trong khi webhook chưa đến được ReputeCast. |
Trước khi bắt đầu
Phần tiêu đề “Trước khi bắt đầu”- Một tên miền Mailgun (ví dụ
mg.acme.io) đã có trong tài khoản Mailgun của bạn, ở đúng khu vực bạn kết nối. Kết nối được kiểm tra dựa trên tên miền này, nên hãy tạo nó trong Mailgun trước, hoặc kết nối tên miền sandbox để dùng thử. - Một Private API key lấy từ Mailgun › API Security. Domain Sending key hay HTTP webhook signing key đều không dùng được.
- Quyền. Kết nối cần
providers:manage; thêm tên miền gửi mới cầndomains:manage. - Một địa chỉ HTTPS công khai cho webhook:
<public URL>/hooks/mailgun/<token>. Nếu ReputeCast chưa truy cập được từ internet, nó có thể hỏi định kỳ API sự kiện của Mailgun mỗi phút để thay thế.
Mailgun ký mọi webhook bằng HTTP webhook signing key dùng cho toàn tài khoản, khóa này khác với API key của bạn (Mailgun: Securing webhooks, kiểm tra tháng 10/2026). ReputeCast đọc khóa đó qua API, nên bạn không cần dán nó, trừ khi API key của bạn không đọc được khóa này.
Kết nối Mailgun
Phần tiêu đề “Kết nối Mailgun”-
Mở Nhà cung cấp gửi thư, chọn Thêm nhà cung cấp rồi chọn Mailgun trong danh mục. Kết nối nhà cung cấp gửi thư giải thích các bước chung của mọi nhà cung cấp.
-
Dán Private API key, chọn Khu vực (
US · api.mailgun.nethoặcEU · api.eu.mailgun.net, tùy nơi tên miền được tạo) và nhập Tên miền gửi thư. Phần thiết lập thêm của Mailgun chứa Gói · số email mỗi tháng (dùng cho thanh hạn mức khi tài khoản không có giới hạn gửi tùy chỉnh) và HTTP webhook signing key. -
Chọn Kết nối. ReputeCast dùng khóa của bạn để đọc tên miền, rồi đọc giới hạn gửi hằng tháng của tài khoản, và lưu khóa ở dạng mã hóa. Không có gì được lưu khi bước kiểm tra thất bại.
-
Trong 2. Webhook, ReputeCast kiểm tra URL công khai của chính nó và đăng ký URL đó trên tên miền cho
delivered,permanent_fail,temporary_fail,complainedvàunsubscribed. Lượt mở và lượt nhấp không được đăng ký: ReputeCast tự theo dõi. Nếu không truy cập được endpoint, hãy chọn Tạm dùng hỏi định kỳ và sửa URL công khai sau.
-
Chọn Tiếp tục xác minh tên miền và nhập tên miền gửi. Nếu tên miền chưa có trong Mailgun, ReputeCast thêm nó (automatic sender security, DKIM 2048 bit) và liệt kê các bản ghi SPF, DKIM và MX cần công bố. CNAME theo dõi của Mailgun được bỏ qua vì ReputeCast tự theo dõi lượt mở và lượt nhấp.
-
Trong Gửi thử, gửi thư thử và xem webhook
deliveredtrả về. -
Trong Luồng và Liên hệ, chọn các luồng và giữ tùy chọn kéo các thư trả lại, khiếu nại và lượt hủy đăng ký hiện có từ Mailgun về.
Kiểm tra kết quả
Phần tiêu đề “Kiểm tra kết quả”- Thẻ Mailgun trên Nhà cung cấp gửi thư, rồi Nhà cung cấp hiển thị Ổn định cùng tên miền và trạng thái của nó (ví dụ “Tên miền mg.acme.io · active”). Tên miền sandbox thì hiển thị Sandbox · chỉ địa chỉ đã xác minh.
- Trong Mailgun, phần webhook của tên miền liệt kê URL ReputeCast của bạn cho năm sự kiện.
- Lượt gửi thành công và thư trả lại xuất hiện trong Nhà cung cấp gửi thư, rồi Sự kiện và đồng bộ.
ReputeCast gửi mỗi thư bằng một lệnh gọi API, với tính năng theo dõi lượt mở, lượt nhấp và hủy đăng ký của Mailgun được tắt trên từng thư. Nếu tên miền bật theo dõi hủy đăng ký, Mailgun thêm liên kết hủy đăng ký và chân thư riêng bên cạnh phần của ReputeCast; Độ sẵn sàng gửi sẽ cảnh báo điều này, và Kiểm tra theo dõi phía nhà cung cấp trên tab Sự kiện và đồng bộ có thể tắt nó. Danh sách chặn gửi dùng chung được đẩy lên bảng unsubscribes của Mailgun (cho mọi tag), nên mọi địa chỉ ReputeCast chặn gửi, kể cả các địa chỉ bị trả thư, đều xuất hiện ở đó.
Tên miền sandbox của Mailgun chỉ gửi tới người nhận đã được ủy quyền, tối đa 5 người (Mailgun: Sandbox domain, kiểm tra tháng 10/2026). Khi Mailgun được kết nối với tên miền sandbox, Độ sẵn sàng gửi chặn thư Gửi hàng loạt đi qua nó.
Khắc phục sự cố
Phần tiêu đề “Khắc phục sự cố”- “Mailgun đã từ chối khóa này” kèm
401 Unauthorized. Hãy dùng Private API key của cùng tài khoản, không phải Sending key hay webhook signing key. - “Mailgun đã từ chối khóa này” kèm
404 Not Found · domain_not_found. Khóa đúng, nhưng Mailgun không có tên miền gửi đó ở khu vực đã chọn. Hãy kiểm tra chính tả tên miền và khu vực, hoặc tạo tên miền trong Mailgun trước. - “Mailgun cho phép ba URL cho mỗi sự kiện” khi đăng ký webhook. Một trong các sự kiện đã gửi tới ba địa chỉ. Hãy xóa một URL cũ trong Mailgun, rồi chọn Thử đăng ký lại.
- Bước tự kiểm tra webhook thất bại (
ECONNREFUSED, “localhost chỉ hoạt động trên máy này”). Hãy đặtREPUTECAST_PUBLIC_URLthành địa chỉ HTTPS mà reverse proxy của bạn công khai, dùng tunnel khi thử nghiệm, hoặc tạm dùng hỏi định kỳ. Xem Reverse proxy và TLS. - Webhook đến nơi nhưng xác minh thất bại, và nhà cung cấp chuyển sang “Webhook im lặng”. API key của bạn không đọc được webhook signing key của tài khoản. Hãy sao chép khóa từ Settings › API Security › HTTP webhook signing key trong Mailgun vào Cài đặt, rồi Thông tin xác thực trên thẻ nhà cung cấp.
- Người nhận thử bị từ chối với
unauthorized_recipient. Tên miền là sandbox của Mailgun: hãy thêm địa chỉ đó làm authorized recipient trong Mailgun, hoặc kết nối một tên miền đã xác minh. - Thư giao dịch có Cc, Bcc hoặc tệp đính kèm bị lỗi. Adapter Mailgun không gửi được bản sao hay tệp đính kèm; hãy định tuyến các mẫu đó qua nhà cung cấp khác.
- Bạn đã ngắt kết nối Mailgun. ReputeCast gỡ URL của nó khỏi từng sự kiện webhook. Tên miền và các lượt hủy đăng ký đã đẩy lên vẫn còn trong Mailgun.