Gửi thư bằng Mailjet

Hướng dẫn thao tác

Dành cho:: Quản trị viên không gian làm việc
Cần quyền:: providers:managenhạy cảm, domains:managenhạy cảm
Trong ứng dụng:: Nhà cung cấp gửi thư, rồi Nhà cung cấp

Để gửi newsletter bằng Mailjet từ ReputeCast, bạn kết nối một Mailjet API key và secret key của nó. ReputeCast đăng ký một event callback cho mỗi sự kiện cần dùng, thiết lập tên miền gửi, gửi tối đa 50 thư mỗi lệnh gọi với tính năng theo dõi của Mailjet tắt, và giữ danh sách loại trừ chiến dịch (campaign exclusions) của Mailjet khớp với danh sách chặn gửi dùng chung.

Loại	API
Gửi marketing hàng loạt	Được phép
Webhook sự kiện	Do ReputeCast đăng ký; basic auth trong URL callback (Mailjet không ký)
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ô	50
Ghi chú	Mailjet chỉ cho phép một URL callback cho mỗi sự kiện và khóa API, nên hãy dùng một khóa chỉ riêng ReputeCast dùng. Danh sách chặn gửi đồng bộ với danh sách loại trừ chiến dịch (campaign exclusions) của Mailjet.

Trước khi bắt đầu

Một API key và secret key của nó lấy từ Mailjet › Account settings › API key management. Hãy tạo một khóa chỉ ReputeCast dùng: Mailjet chỉ cho phép một callback URL cho mỗi sự kiện và mỗi API key, nên khóa dùng chung với công cụ khác sẽ xung đột với callback của công cụ đó.
Quyền. Kết nối cần providers:manage; thêm tên miền gửi mới cần domains:manage.
Một địa chỉ HTTPS công khai cho các callback: <public URL>/hooks/mailjet/<token>. Event API của Mailjet gửi tới URL bạn cung cấp và khuyến nghị dùng HTTPS với thông tin basic auth trong URL (Mailjet: Event API, kiểm tra tháng 10/2026), đó cũng là cách ReputeCast đăng ký.

Kết nối Mailjet

Mở Nhà cung cấp gửi thư, chọn Thêm nhà cung cấp rồi chọn Mailjet 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 Khóa API và Secret key. Mailjet không có API cho thông tin gói, nên hãy nhập Gói · số email mỗi tháng trong phần thiết lập thêm của Mailjet nếu bạn muốn có thanh hạn mức.
Chọn Kết nối. ReputeCast kiểm tra cặp khóa bằng một lệnh gọi chỉ đọc và lưu cả hai giá trị ở dạng mã hóa. Thẻ cho biết khóa có đang hoạt động hay không.
Trong 2. Webhook, ReputeCast kiểm tra URL công khai của chính nó, rồi đăng ký một callback cho mỗi sự kiện sent, bounce, blocked, spam và unsub. Mỗi callback URL mang thông tin basic auth (https://reputecast:<secret>@<your host>/hooks/mailjet/<token>), vì Mailjet không ký callback. Sự kiện mở và nhấp không được đăng ký: ReputeCast tự theo dõi.
Chọn Tiếp tục xác minh tên miền và nhập tên miền gửi. ReputeCast thêm một domain sender (*@<your domain>) trong Mailjet và liệt kê các bản ghi Mailjet yêu cầu: bản ghi TXT xác minh quyền sở hữu, DKIM và SPF (với include:spf.mailjet.com), kèm DMARC nếu tên miền chưa có.
Trong Gửi thử, gửi thư thử và xem callback sent trả về dưới dạng một lượt gửi thành công.
Trong Luồng và Liên hệ, chọn các luồng và giữ tùy chọn kéo danh sách loại trừ hiện có của Mailjet về.

Kiểm tra kết quả

Thẻ Mailjet trên Nhà cung cấp gửi thư, rồi Nhà cung cấp hiển thị Ổn định và “Khóa API đang hoạt động”.
Trong Mailjet, thiết lập event notification của API key đó trỏ sent, bounce, blocked, spam và unsub tới URL ReputeCast của bạ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 qua Send API v3.1 của Mailjet, tối đa 50 thư mỗi lệnh gọi, với theo dõi lượt mở và lượt nhấp tắt trên từng thư. Số lượng hằng tháng trên thẻ là số thư khóa này đã gửi trong tháng, đọc từ thống kê của Mailjet.

Khắc phục sự cố

“Mailjet đã từ chối khóa này” kèm 401 Unauthorized. API key và secret key đi theo cặp: hãy kiểm tra cả hai, dù lỗi chỉ hiển thị ở ô API key.
“Mailjet cho phép một URL callback cho mỗi sự kiện và mỗi khóa API” khi đăng ký webhook. Một công cụ khác (hoặc một địa chỉ ReputeCast cũ) đã dùng các sự kiện đó trên khóa này. Hãy dùng một API key chỉ ReputeCast dùng, hoặc xóa các callback đó trong Mailjet, rồi chọn Thử đăng ký lại. Các sự kiện chưa bị chiếm vẫn được đăng ký.
Thẻ ghi “Khóa API không hoạt động” hoặc “đang bị cách ly”. Mailjet đã hạn chế khóa này. Hãy xử lý trong Mailjet trước khi định tuyến thư tới nó.
Tên miền hiển thị “chưa được thiết lập trong Mailjet”. Domain sender đã bị xóa trong Mailjet. Hãy tạo lại sender *@<your domain> trong Mailjet.
Danh mục hiển thị huy hiệu “Chế độ sandbox”. ReputeCast không bao giờ gửi qua sandbox mode của Mailjet: mọi thư nó chuyển đi đều được gửi thật.
Bạn đã ngắt kết nối Mailjet. ReputeCast xóa các callback trỏ tới URL của nó. Domain sender và danh sách loại trừ vẫn còn trong Mailjet.