Gửi thư bằng Brevo
Khi bạn gửi newsletter bằng Brevo API, ReputeCast dùng transactional email API của Brevo, mỗi thư một lệnh gọi. Bạn kết nối một khóa API v3; ReputeCast đăng ký một transactional webhook, xác thực tên miền gửi và kéo các liên hệ bị chặn (blocked contacts) của Brevo vào danh sách chặn gửi dùng chung. Có hai hành vi của Brevo cần lưu ý trước khi gửi: Brevo tự thêm header hủy đăng ký riêng, và Brevo theo dõi lượt mở, lượt nhấp theo cách ReputeCast không tắt được.
| Loại | API |
|---|---|
| Gửi marketing hàng loạt | Được phép |
| Webhook sự kiện | Do ReputeCast đăng ký; bearer token (Brevo không ký) |
| Thiết lập tên miền | API |
| Đồng bộ danh sách chặn gửi | Chỉ kéo về |
| Kích thước lô | 1 |
| Ghi chú | Brevo theo dõi lượt mở và lượt nhấp trong thư giao dịch, và ReputeCast không tắt được việc này qua API của Brevo. Danh sách chặn gửi được kéo về từ Brevo nhưng không được đẩy lên Brevo. |
Trước khi bắt đầu
Phần tiêu đề “Trước khi bắt đầu”- Một Brevo API key lấy từ Brevo › SMTP & API › API keys. Khóa bắt đầu bằng
xkeysib-. Brevo cũng cấp SMTP key cho SMTP relay của họ; các khóa đó không dùng được ở đây (Brevo: Create and manage your API keys, kiểm tra tháng 10/2026). - Một tài khoản gửi được thư. Khi Brevo đang xét duyệt một tài khoản mới, hoặc khi tài khoản đã hết credits, bước kiểm tra khóa sẽ thất bại.
- 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/brevo/<token>.
Ba hành vi của Brevo cần lưu ý trước khi bạn định tuyến thư tới đó:
- Header hủy đăng ký của Brevo. Brevo tự thêm header
List-Unsubscribevà không có API để thay đổi, nên ReputeCast bỏ header của chính mình khỏi thư gửi qua Brevo. Lượt hủy đăng ký một lần nhấp từ nhà cung cấp hộp thư sẽ đến Brevo, Brevo báo lại qua webhook, và địa chỉ đó được thêm vào danh sách chặn gửi dùng chung. Liên kết hủy đăng ký ở chân thư vẫn dẫn về ReputeCast. - Theo dõi lượt mở và lượt nhấp của Brevo. Brevo mặc định theo dõi lượt mở và lượt nhấp trong email giao dịch và không có API hay công tắc theo từng thư để tắt; trong thiết lập của Brevo, bạn chỉ có thể ẩn danh hóa việc theo dõi đó (Brevo: Can I anonymize the tracking of opens and clicks for my emails?, kiểm tra tháng 10/2026). Brevo thêm pixel mở thư riêng và viết lại liên kết chồng lên phần theo dõi của ReputeCast; số liệu của Brevo không bao giờ đi vào báo cáo của ReputeCast. Kiểm tra theo dõi phía nhà cung cấp không đọc được thiết lập của Brevo và Độ sẵn sàng gửi không cảnh báo về điều này, nên hãy tự xem lại thiết lập theo dõi của Brevo.
- Danh sách chặn gửi chỉ kéo về. ReputeCast nhập các liên hệ bị chặn của Brevo (trả thư vĩnh viễn, khiếu nại spam và hủy đăng ký) mỗi 15 phút nhưng không đẩy danh sách của mình lên Brevo, vì API của Brevo chỉ chặn được từng liên hệ một cho mỗi người gửi. ReputeCast kiểm tra danh sách dùng chung trước khi chuyển bất kỳ thư nào cho Brevo, nên các địa chỉ bị chặn gửi không bao giờ đến được Brevo.
Kết nối Brevo
Phần tiêu đề “Kết nối Brevo”-
Mở Nhà cung cấp gửi thư, chọn Thêm nhà cung cấp rồi chọn Brevo 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. Nếu gói của bạn tính theo hạn mức hằng tháng, hãy nhập Gói · số email mỗi tháng trong phần thiết lập thêm của Brevo cho thanh hạn mức.
-
Chọn Kết nối. ReputeCast dùng khóa để đọc tài khoản và lưu khóa ở dạng mã hóa. Thẻ hiển thị tên công ty, gói và số email hoặc credits còn lại.
-
Trong 2. Webhook, ReputeCast kiểm tra URL công khai của chính nó, rồi tạo (hoặc cập nhật) một transactional webhook tên “ReputeCast” cho các sự kiện delivered, hard bounce và soft bounce, deferred, blocked, invalid, spam và unsubscribed. Brevo không ký webhook, nên ReputeCast cấp cho Brevo một bearer token để gửi kèm mỗi yêu cầu. Webhook cho các chiến dịch marketing trên Brevo không bị động đến.
-
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 tên miền vào Brevo, yêu cầu Brevo xác thực nó, và liệt kê các bản ghi của Brevo: bản ghi TXT xác minh
brevo-code, DKIM, SPF khi Brevo cung cấp, và DMARC. -
Trong Gửi thử, gửi thư thử và xem sự kiện delivered trả về.
-
Trong Luồng và Liên hệ, chọn các luồng và giữ tùy chọn kéo các liên hệ bị chặn hiện có của Brevo về.
Kiểm tra kết quả
Phần tiêu đề “Kiểm tra kết quả”- Thẻ Brevo trên Nhà cung cấp gửi thư, rồi Nhà cung cấp hiển thị Ổn định và phần còn lại của gói.
- Trong Brevo, danh sách transactional webhook có webhook “ReputeCast” trỏ tới
/hooks/brevo/…. - 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ộ.
Khắc phục sự cố
Phần tiêu đề “Khắc phục sự cố”- “Brevo đã từ chối khóa này.” Hãy dùng khóa API v3 (bắt đầu bằng
xkeysib-), không phải SMTP key. - “Brevo không trả lời lệnh kiểm tra” với một khóa bạn chắc chắn là đúng. Brevo từ chối khi tài khoản đang được xét duyệt hoặc đã hết credits. Hãy hoàn tất việc xét duyệt tài khoản của Brevo hoặc nạp thêm, rồi thử lại.
- Bước tên miền thất bại với “Brevo không thêm được …”. Brevo đã từ chối tên miền; lý do của Brevo nằm sau thông báo. Hãy khắc phục trong Brevo, rồi chạy lại bước này.
- Số lượt hủy đăng ký trong ReputeCast có vẻ thấp. Lượt hủy đăng ký một lần nhấp từ Gmail hoặc Yahoo đến Brevo trước rồi mới về qua webhook. Hãy kiểm tra webhook vẫn còn được đăng ký trong Brevo.
- Danh mục hiển thị huy hiệu “Chế độ sandbox”. ReputeCast không bao giờ gửi qua sandbox của Brevo: mọi thư nó chuyển đi đều được gửi thật.
- Bạn đã ngắt kết nối Brevo. ReputeCast xóa các transactional webhook trỏ tới URL của nó. Tên miền vẫn còn trong Brevo.