Chuyển từ Brevo sang ReputeCast

Hướng dẫn thao tác

Dành cho:: Nhà xuất bản và marketer, Quản trị viên không gian làm việc
Cần quyền:: subscribers:import
Trong ứng dụng:: Nhập liên hệ

Để chuyển từ Brevo, bạn kết nối ReputeCast với tài khoản Brevo bằng một khóa API và nhập các danh sách Brevo, thuộc tính liên hệ và mọi địa chỉ trong danh sách chặn (blocklist) của Brevo. ReputeCast chỉ đọc từ Brevo API v3; không có gì thay đổi trong Brevo, nên bạn có thể tiếp tục gửi thư qua Brevo trong lúc chuyển.

Trước khi bắt đầu

Bạn cần quyền subscribers:import (Chủ sở hữu, Quản trị viên và Biên tập viên có quyền này).
Tạo một khóa API Brevo. Trong Brevo, mở menu tài khoản, chọn Settings › SMTP & API › API Keys & MCP và nhấp Generate a new API key. Brevo yêu cầu một mã xác minh, một tên và ngày hết hạn, rồi hiển thị khóa một lần. Chỉ chủ tài khoản và người dùng có quyền API keys mới tạo được khóa. Nguồn: Brevo, Create and manage your API keys (kiểm tra tháng 10/2026).
Hãy đọc cách một lần chuyển mang theo sự đồng ý nếu đây là lần nhập đầu tiên của bạn.

Nhập các danh sách Brevo

Mở Nhập liên hệ và chọn Brevo. Trình hướng dẫn có liên kết đến trang khóa API của Brevo nếu bạn chưa có khóa.
Dán khóa và chọn Kết nối. Trình hướng dẫn hiển thị tên công ty của bạn trên Brevo và mọi danh sách, kèm số liên hệ đã đăng ký và đã hủy đăng ký.
Đánh dấu các danh sách cần nhập và chọn danh sách ReputeCast cho từng danh sách. Giữ bật tùy chọn lấy địa chỉ bị chặn gửi từ các nhà cung cấp gửi thư, rồi tiếp tục đến bước ghép trường. ReputeCast đọc danh sách chặn của Brevo trước, rồi đến mọi liên hệ của các danh sách đã chọn.
Ghép trường. EMAIL là bắt buộc; các thuộc tính Brevo như FIRSTNAME và LASTNAME được ghép theo tên, và trường tùy chỉnh mới được tạo cho phần còn lại.
Ở bước đồng ý, kiểm tra mỗi trạng thái trở thành gì (xem phần tiếp theo). API của Brevo không cung cấp ngày hay IP xác nhận đăng ký, nên các liên hệ được nhập dưới dạng xác nhận một bước. Hãy chọn Xin phép lại tất cả trước nếu bạn không thể đảm bảo họ đã đăng ký theo cách nào.
Chạy bước xem trước và bắt đầu nhập.

Những gì được chuyển từ Brevo

Danh sách trở thành các danh sách ReputeCast bạn đã chọn.
Thuộc tính liên hệ thuộc danh mục normal của Brevo trở thành trường của liên hệ. Thuộc tính ở các danh mục khác của Brevo (như transactional hoặc calculated) không được đọc.
Danh sách chặn quyết định ai trở thành địa chỉ bị chặn gửi, với lý do “nằm trong danh sách chặn của Brevo”.
Ngày: ngày tạo trong Brevo trở thành ngày tạo liên hệ.

Trong Brevo	Trở thành trong ReputeCast
Có trong danh sách	Đã đăng ký · đã xác nhận, dạng xác nhận một bước (hoặc chờ xác nhận, hoặc Bỏ qua)
Đã hủy đăng ký khỏi danh sách này	Bị chặn gửi · đã hủy đăng ký: không nhận thư Gửi hàng loạt hay Tự động hóa, vẫn nhận thư Hệ thống (cố định)
Trong danh sách chặn vì trả thư vĩnh viễn	Bị chặn gửi · trả thư vĩnh viễn, mọi luồng (cố định)
Trong danh sách chặn vì báo cáo spam	Bị chặn gửi · khiếu nại, mọi luồng (cố định)
Trong danh sách chặn vì bất kỳ lý do nào khác	Bị chặn gửi · đã hủy đăng ký (cố định)

Việc chặn gửi gắn với địa chỉ: một liên hệ đã hủy đăng ký khỏi một danh sách Brevo sẽ không nhận thư Gửi hàng loạt hay Tự động hóa trên bất kỳ danh sách ReputeCast nào.

Những gì ở lại Brevo

Chiến dịch và số liệu thống kê của chúng, tự động hóa, phân khúc, biểu mẫu, mẫu và thiết lập người gửi không được nhập. Hãy tạo lại chúng trong ReputeCast bằng phân khúc, tự động hóa và trình soạn thảo.

Giữ Brevo làm nhà cung cấp gửi thư trong lúc chuyển

Việc nhập liên hệ và việc gửi thư qua Brevo là hai việc riêng biệt. Để Brevo tiếp tục gửi thư cho đến khi thiết lập mới sẵn sàng, hãy kết nối Brevo làm nhà cung cấp gửi thư, rồi chuyển dần lưu lượng khỏi Brevo bằng cách chia theo tỷ trọng, ví dụ 90% qua Brevo và 10% qua nhà cung cấp mới.

Khi Brevo được kết nối làm nhà cung cấp gửi thư, ReputeCast kéo các liên hệ bị chặn của Brevo về danh sách chặn gửi dùng chung, và các lượt hủy đăng ký qua header hủy đăng ký của chính Brevo đến ReputeCast qua webhook của Brevo. API của Brevo không nhận được địa chỉ bị chặn gửi, nên các địa chỉ bị chặn gửi trong ReputeCast chỉ nằm trong ReputeCast; ReputeCast không bao giờ gửi đến các địa chỉ đó qua bất kỳ nhà cung cấp nào.

Giới hạn tốc độ

Theo giới hạn tốc độ chung của Brevo, các endpoint dưới /v3/contacts cho phép 36.000 yêu cầu mỗi giờ và 10 yêu cầu mỗi giây, còn các endpoint không được liệt kê riêng, như /v3/account, cho phép 100 yêu cầu mỗi giờ. Brevo trả lời 429 khi vượt các mức này. Nguồn: Brevo, Rate limits (kiểm tra tháng 10/2026). ReputeCast đọc 500 liên hệ mỗi yêu cầu, lần lượt từng yêu cầu một, và tự lùi lại khi cần:

Thiết lập	Mặc định	Cách thay đổi
Tệp CSV hoặc XLSX lớn nhất	100 MB and 500,000 rows (XLSX reads the first sheet)	Cố định
Giới hạn tần suất API của nguồn (429)	Up to 5 retries, each after the source's Retry-After (2 s when absent, at most 60 s); then the import pauses and resumes by itself after 1 minute	Tiếp tục ngay, hoặc Giảm xuống 3 yêu cầu/giây trên lần nhập đang tạm dừng
Lỗi máy chủ nguồn hoặc lỗi mạng	Up to 5 retries, after 1, 2, 4, 8 and 16 s	Cố định

Nếu lần nhập tạm dừng với thông báo “Brevo đang giới hạn tốc độ (429)”, hãy chọn Tiếp tục ngay, hoặc Giảm xuống 3 yêu cầu/giây để luôn ở xa dưới mức 10 yêu cầu mỗi giây của Brevo.

Kiểm tra kết quả

Bản tóm tắt cho biết bao nhiêu liên hệ đã được nhập, gộp, chặn gửi, để ở trạng thái chờ xác nhận và bỏ qua, và mỗi danh sách hiện có bao nhiêu liên hệ.

Bản tóm tắt của một lần nhập từ Brevo đã hoàn tất: 39.402 liên hệ đã nhập, 1.033 địa chỉ bị chặn gửi (180 đã hủy đăng ký, 812 bị trả thư, 41 khiếu nại), 6.716 liên hệ chờ xin phép lại và 214 hàng bị bỏ qua, kèm từng lý do bỏ qua.

Sau đó mở Người đăng ký, rồi Danh sách chặn gửi và kiểm tra rằng các địa chỉ trong danh sách chặn của Brevo có ở đó với lý do “nằm trong danh sách chặn của Brevo”.

Khắc phục sự cố

“Brevo từ chối khóa API”: khóa đã bị xóa, bị vô hiệu hóa hoặc đã hết hạn. Brevo cũng vô hiệu hóa các khóa không có lệnh gọi thành công nào trong 90 ngày. Hãy tạo khóa mới và dán vào.
Brevo gửi email cho bạn về một lệnh gọi API từ địa chỉ IP mới: tài khoản của bạn chặn các địa chỉ IP lạ. Hãy cấp phép cho địa chỉ của máy chủ ReputeCast trong Brevo, rồi kết nối lại.
Lỗi 429 ngay sau khi kết nối: việc kết nối đọc /v3/account, endpoint mà Brevo giới hạn ở 100 yêu cầu mỗi giờ. Hãy chờ, rồi thử lại.
Có ít liên hệ hơn so với trong Brevo: liên hệ đã hủy đăng ký và liên hệ trong danh sách chặn trở thành địa chỉ bị chặn gửi, không phải thành viên danh sách. Tải báo cáo đầy đủ · CSV liệt kê mọi hàng kèm điều đã xảy ra với hàng đó.