Bỏ qua để đến nội dung
ReputeCastReputeCast Docs

Gửi thư bằng SparkPost

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 SparkPost từ ReputeCast, bạn kết nối một API key và khu vực của tài khoản SparkPost (US hoặc EU). ReputeCast đăng ký một webhook được bảo vệ bằng basic auth, thiết lập DKIM cho tên miền gửi, tắt tính năng theo dõi của SparkPost trên từng thư và giữ hai danh sách chặn gửi luôn đồng bộ.

LoạiAPI
Gửi marketing hàng loạtĐược phép
Webhook sự kiệnDo ReputeCast đăng ký; basic auth (SparkPost không ký)
Thiết lập tên miềnAPI
Đồng bộ danh sách chặn gửiHai chiều
Kích thước lô1
Ghi chúDành cho tài khoản SparkPost hiện có ở khu vực US hoặc EU. Đọc giới hạn gửi của tài khoản. Mỗi thư một lệnh gọi.

Trước khi bắt đầu

Phần tiêu đề “Trước khi bắt đầu”
  • Một tài khoản SparkPost tại app.sparkpost.com (US) hoặc app.eu.sparkpost.com (EU). Adapter dùng API của SparkPost; tài khoản Bird Email dùng một API khác và không kết nối được bằng adapter này.
  • Một API key có các quyền Transmissions, Webhooks, Sending Domains, Suppression Lists, Account, Metrics và Message Events, tạo trong Configuration › API Keys của SparkPost (SparkPost: Create API keys, kiểm tra tháng 10/2026). Tài khoản EU tạo khóa trong ứng dụng EU.
  • 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/sparkpost/<token>. SparkPost gửi một lô thử tới địa chỉ này trước khi lưu webhook, nên địa chỉ phải truy cập được. Trong lúc chưa truy cập được, ReputeCast có thể hỏi định kỳ API sự kiện của SparkPost mỗi phút.

Kết nối SparkPost

Phần tiêu đề “Kết nối SparkPost”

  1. Mở Nhà cung cấp gửi thư, chọn Thêm nhà cung cấp rồi chọn SparkPost 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.

  2. Dán Khóa API và chọn Khu vực: us cho api.sparkpost.com, eu cho api.eu.sparkpost.com. Trong phần thiết lập thêm của SparkPost, bạn có thể đặt tên một Nhóm IP gồm các IP riêng để gửi qua.

  3. Chọn Kết nối. ReputeCast dùng khóa để đọc tài khoản và mức sử dụng, rồi lưu khóa ở dạng mã hóa. Thẻ hiển thị ID tài khoản, trạng thái và gói của bạn.

  4. 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 webhook tên “ReputeCast” với basic auth (user reputecast, một khóa bí mật do ReputeCast tạo) cho các sự kiện gửi thành công, thư trả lại, thư trả lại ngoài băng (out-of-band), trì hoãn, khiếu nại spam, từ chối do chính sách, lỗi tạo thư và hủy đăng ký. Sự kiện mở và nhấp không được đăng ký. Nếu chưa truy cập được endpoint, hãy chọn Tạm dùng hỏi định kỳ.

  5. 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 nó làm sending domain của SparkPost với khóa DKIM 2048 bit và liệt kê bản ghi TXT DKIM. Với tên miền con như news.acme.io, ReputeCast cũng liệt kê CNAME bounce (trỏ tới sparkpostmail.com, hoặc eu.sparkpostmail.com ở EU); tên miền gốc như acme.io không thể chứa CNAME, nên chỉ có DKIM. ReputeCast đề xuất DMARC nếu tên miền chưa có.

  6. Trong Gửi thử, gửi thư thử và xem sự kiện gửi thành công trả về.

  7. 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ừ SparkPost về.

Kiểm tra kết quả

Phần tiêu đề “Kiểm tra kết quả”
  • Thẻ SparkPost trên Nhà cung cấp gửi thư, rồi Nhà cung cấp hiển thị Ổn định cùng giới hạn gửi hằng tháng hoặc hằng ngày và mức đã dùng.
  • Trong SparkPost, danh sách webhook có webhook “ReputeCast” trỏ tới /hooks/sparkpost/… với basic auth.
  • 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ộ.

SparkPost không ký webhook, nên ReputeCast dựa vào thông tin basic auth và URL khó đoán. ReputeCast gửi mỗi thư bằng một transmission, kèm idempotency key để lệnh gọi được thử lại không bao giờ gửi hai lần, và tắt theo dõi lượt mở, lượt nhấp. Theo cách phân loại của SparkPost, mọi thư đều được gửi dưới dạng transactional, vì SparkPost tự thêm header List-Unsubscribe riêng vào các loại thư khác, trong khi ReputeCast đã thêm một header với hủy đăng ký một lần nhấp. Cũng vì lý do đó, ReputeCast đẩy từng địa chỉ bị chặn gửi lên cả hai danh sách chặn gửi của SparkPost, và kéo các mục thư trả lại, khiếu nại spam và hủy đăng ký của SparkPost về.

Khắc phục sự cố

Phần tiêu đề “Khắc phục sự cố”
  • “SparkPost đã từ chối khóa này” kèm 401 Unauthorized. Khóa sai, thiếu quyền hoặc thuộc khu vực còn lại. Hãy kiểm tra quyền của khóa và khu vực có khớp với ứng dụng bạn đã dùng để tạo khóa hay không.
  • Đăng ký webhook thất bại. SparkPost kiểm tra URL trước khi lưu webhook, nên việc đăng ký thất bại khi SparkPost không truy cập được ReputeCast. Hãy sửa URL công khai (xem Reverse proxy và TLS), rồi chọn Thử đăng ký lại.
  • Bước tên miền chỉ liệt kê một bản ghi DKIM. Bạn đã nhập tên miền gốc. Hãy gửi từ một tên miền con nếu muốn bounce domain của SparkPost căn chỉnh với tên miền của bạn.
  • Tốc độ gửi chậm lại kèm lỗi HTTP 420. SparkPost trả 420 khi giới hạn gửi hằng ngày hoặc hằng tháng đã dùng hết. ReputeCast coi đó là giới hạn tốc độ và thử lại sau; hãy nâng giới hạn trong SparkPost hoặc định tuyến một phần lưu lượng sang nhà cung cấp khác.
  • Danh mục hiển thị huy hiệu “Tên miền sandbox”. ReputeCast không có chế độ sandbox cho SparkPost: hãy kết nối một tên miền gửi thật.
  • Theo dõi cấp tài khoản đang bật. Mục kiểm tra theo dõi trên tab Sự kiện và đồng bộ báo điều đó, dù ReputeCast tắt theo dõi trên mọi thư nó gửi. Để thay đổi mặc định của tài khoản qua API, khóa cần quyền ghi với Account.
  • Bạn đã ngắt kết nối SparkPost. ReputeCast xóa các webhook trỏ tới URL của nó. Tên miền gửi và các địa chỉ chặn gửi đã đẩy lên vẫn còn trong SparkPost.

Liên quan

Phần tiêu đề “Liên quan”
Báo lỗi trang nàyTrang chủ ReputeCastHostReputeNội dung theo giấy phép CC BY 4.0