Gửi thư bằng Resend

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

Khi bạn gửi newsletter bằng Resend, ReputeCast dùng email endpoint và batch endpoint của Resend, tối đa 100 thư mỗi lệnh gọi. Bạn kết nối một API key Full access; ReputeCast đăng ký webhook, thêm tên miền gửi ở khu vực bạn chọn, đọc hạn mức hằng tháng 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ý; chữ ký Standard Webhooks (Svix)
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ô	100
Ghi chú	Tối đa 100 thư mỗi lệnh gọi. Tài khoản chưa có tên miền đã xác minh hiển thị là sandbox. Lượng thư hằng tháng được đọc từ Resend.

Trước khi bắt đầu

Một Resend API key có Full access (Resend: API keys, kiểm tra tháng 10/2026). Khóa Sending access vẫn kết nối được nhưng chỉ gửi được thư: các bước webhook, tên miền và danh sách chặn gửi sau đó sẽ thất bại. Thẻ nhà cung cấp khi đó ghi “Khóa Sending access · cần khóa Full access để đọc hạn mức và tên miền”.
Một tên miền đã xác minh trong Resend, hoặc một tên miền ReputeCast thêm giúp bạn. Cho đến khi tài khoản có tên miền đã xác minh, ReputeCast hiển thị Resend là Sandbox · chỉ địa chỉ đã xác minh: Resend chỉ gửi thư thử tới địa chỉ của chính bạn.
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 webhook: <public URL>/hooks/resend/<token>. Sau khi khóa được chấp nhận, ReputeCast có thể hỏi định kỳ Resend mỗi phút một lần trong lúc địa chỉ chưa truy cập được.

Kết nối Resend

Mở Nhà cung cấp gửi thư, chọn Thêm nhà cung cấp rồi chọn Resend 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à chọn Khu vực nơi lưu trữ các tên miền gửi mới (us-east-1, eu-west-1, sa-east-1 hoặc ap-northeast-1). Trong phần thiết lập thêm của Resend, bạn có thể nhập Gói · số email mỗi tháng cho thanh hạn mức. Để trống Khóa bí mật ký webhook: ReputeCast tự đọc khóa bí mật của webhook mà nó đăng ký.
Chọn Kết nối. ReputeCast dùng khóa để liệt kê các tên miền của bạn và lưu khóa ở dạng mã hóa.
Trong 2. Webhook, ReputeCast kiểm tra URL công khai của chính nó, rồi tạo (hoặc bật lại) một webhook cho email.delivered, email.delivery_delayed, email.bounced, email.complained, email.failed và email.suppressed. Lượt mở và lượt nhấp không được đăng ký: ReputeCast tự theo dõi. Nếu chưa truy cập được endpoint, hãy chọn Tạm dùng hỏi định kỳ.
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 Resend (ở khu vực đã chọn tại bước 2) và liệt kê bản ghi TXT DKIM tại resend._domainkey, các bản ghi MX và SPF trên send.<your domain>, cùng bản ghi SPF và DMARC cho chính tên miền đó. Các bản ghi theo dõi và nhận thư của Resend được bỏ qua.
Trong Gửi thử, gửi thư thử. Để thử các kết quả khác nhau mà không động đến hộp thư thật, hãy gửi tới các địa chỉ thử của Resend: [email protected], [email protected], [email protected] hoặc [email protected] (có thể thêm nhãn như [email protected], trừ địa chỉ suppressed). Thư thử được tính vào hạn mức Resend của bạn (Resend: Send test emails, kiểm tra tháng 10/2026).
Trong Luồng và Liên hệ, chọn các luồng và giữ tùy chọn kéo các địa chỉ chặn gửi hiện có từ Resend về.

Kiểm tra kết quả

Thẻ Resend trên Nhà cung cấp gửi thư, rồi Nhà cung cấp hiển thị Ổn định và số tên miền đã xác minh.
Trong Resend › Webhooks, một webhook trỏ tới /hooks/resend/… cho sáu 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ộ.

Webhook được xác minh bằng chữ ký Standard Webhooks (Svix) và khóa bí mật ký whsec_ của webhook; các yêu cầu cũ hơn 5 phút bị từ chối. Một thư đi qua POST /emails; từ hai thư trở lên đi qua batch endpoint, tối đa 100 thư mỗi lệnh gọi, mỗi thư có một idempotency key để lần thử lại không bao giờ gửi hai lần. Nếu Resend từ chối một thư trong lô, ReputeCast gửi lần lượt từng thư còn lại để chỉ thư đó thất bại.

Resend theo dõi lượt mở và lượt nhấp theo từng tên miền khi tên miền bật theo dõi, và không thể tắt theo từng thư. Kiểm tra theo dõi phía nhà cung cấp trên tab Sự kiện và đồng bộ báo điều này và có thể tắt nó cho các tên miền của bạn; trước khi tắt, Độ sẵn sàng gửi cảnh báo về việc đếm trùng.

Khắc phục sự cố

“Resend đã từ chối khóa này.” Khóa đã bị xóa hoặc nhập sai. Hãy tạo khóa Full access trong Resend và dán vào.
Đăng ký webhook thất bại với restricted_api_key. Khóa chỉ có quyền Sending access. Hãy thay bằng khóa Full access trong Cài đặt, rồi Thông tin xác thực, rồi chọn Thử đăng ký lại.
Resend hiển thị là Sandbox · chỉ địa chỉ đã xác minh. Tài khoản chưa có tên miền đã xác minh. Hãy hoàn tất các bản ghi tên miền ở bước 5; trạng thái sẽ hết ở lần kiểm tra tình trạng kế tiếp (mỗi 5 phút). Resend không có yêu cầu quyền gửi chính thức: xác minh tên miền là cách khắc phục.
Thư thử thất bại với validation_error. Tên miền From chưa được xác minh trong Resend. Hãy dùng người gửi thuộc một tên miền đã xác minh.
Chữ ký không còn xác minh được sau khi bạn tạo lại webhook trong Resend. Nếu bạn từng dán khóa bí mật ký webhook, ReputeCast vẫn tiếp tục dùng nó. Hãy thay bằng khóa bí mật của webhook mới, hoặc kết nối lại Resend.
Thư giao dịch có Cc, Bcc hoặc tệp đính kèm bị lỗi. Adapter Resend 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.
Huy hiệu trong danh mục ghi “Tiếp thị hàng loạt qua Broadcasts API”. ReputeCast không dùng Resend Broadcasts; nó tự gửi từng thư qua email endpoint và batch endpoint.
Bạn đã đổi URL công khai hoặc ngắt kết nối Resend. URL công khai mới thêm một webhook thứ hai; hãy xóa webhook cũ trong Resend. Ngắt kết nối sẽ xóa webhook ở URL hiện tại; các tên miền và địa chỉ chặn gửi đã đẩy lên vẫn còn.