Gửi thư bằng máy chủ Postal của riêng bạn

Hướng dẫn thao tác

Dành cho:: Quản trị viên không gian làm việc, Người vận hành máy chủ
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

Nếu bạn tự vận hành máy chủ mail Postal, ReputeCast có thể gửi newsletter qua HTTP API của Postal và đọc các webhook có ký của nó, nên khi gửi newsletter bằng máy chủ Postal, bạn có cùng cách xử lý thư trả lại, tự động tạm dừng và báo cáo như với mọi nhà cung cấp gửi thư khác. Bạn tự thêm webhook trong Postal, công bố các bản ghi DNS của Postal, và khởi động IP của máy chủ trước khi để nó gửi thư của luồng Gửi hàng loạt.

Loại	Tự lưu trữ
Gửi marketing hàng loạt	Theo chính sách của bạn
Webhook sự kiện	Thêm thủ công trong Postal; chữ ký RSA được kiểm tra bằng JWKS của máy chủ
Thiết lập tên miền	DNS thủ công
Đồng bộ danh sách chặn gửi	Chỉ cục bộ
Kích thước lô	1
Ghi chú	Máy chủ thư Postal của riêng bạn. Bạn tự thêm webhook trong Postal. IP mới cần được khởi động. Máy chủ trong mạng riêng cần bật providers.allow_private_networks.

Trước khi bắt đầu

Một Postal mail server và một API credential cho nó (Postal › mail server của bạn › Credentials, loại API; SMTP credential không dùng được) (Postal: Using the API, kiểm tra tháng 10/2026).
Truy cập mạng theo cả hai chiều. ReputeCast gọi API của Postal và đọc public signing key của nó từ <Server URL>/.well-known/jwks.json; Postal gửi webhook tới <public URL>/hooks/postal/<token>.
Với máy chủ Postal trong mạng nội bộ của bạn, quản trị viên hệ thống bật providers.allow_private_networks (REPUTECAST_PROVIDERS__ALLOW_PRIVATE_NETWORKS=true) và khởi động lại ReputeCast. Nếu không bật, ReputeCast từ chối địa chỉ loopback và địa chỉ riêng. Địa chỉ cloud metadata và link-local luôn bị từ chối. Xem tham chiếu cấu hình.
Quyền. Kết nối cần providers:manage; thêm tên miền gửi mới cần domains:manage.

Kết nối Postal

Mở Nhà cung cấp gửi thư, chọn Thêm nhà cung cấp rồi chọn Postal 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.
Nhập URL máy chủ (địa chỉ giao diện web của Postal, ví dụ https://mta.acme.io) và Khóa API. Chọn Kết nối. ReputeCast kiểm tra khóa bằng một lệnh gọi API vô hại và lưu khóa ở dạng mã hóa; sau đó thẻ ghi “Postal · truy cập được”.
Trong 2. Webhook, ReputeCast kiểm tra URL công khai của chính nó, rồi hiển thị URL webhook. Chọn Sao chép URL. Trình hướng dẫn cũng có Tạo khóa bí mật: hãy bỏ qua. Postal ký webhook bằng khóa RSA riêng, và ReputeCast kiểm tra chữ ký đó.
Trong Postal, mở mail server › Webhooks và thêm một webhook với URL đó cho tất cả sự kiện. ReputeCast dùng MessageSent, MessageDelayed, MessageDeliveryFailed, MessageHeld và MessageBounced, cùng MessageLinkClicked và MessageLoaded nếu Postal gửi chúng (Postal: Webhooks, kiểm tra tháng 10/2026).
Chọn Tiếp tục xác minh tên miền và nhập tên miền gửi. ReputeCast không thêm được tên miền vào Postal: hãy thêm tên miền trong Postal và công bố các bản ghi DKIM và return-path mà Postal hiển thị. ReputeCast đề xuất một bản ghi SPF với a:<your Postal host>, gộp với bản ghi SPF hiện có, và DMARC nếu tên miền chưa có.
Trong Gửi thử, gửi thư thử. Dòng thời gian chờ webhook MessageSent của Postal.
Trong Luồng, chọn các luồng. IP mới chưa có uy tín, nên hãy bắt đầu với thư Hệ thống hoặc Tự động hóa, hoặc một tỷ trọng nhỏ của luồng Gửi hàng loạt.
Mở Nhà cung cấp gửi thư, rồi Khởi động, chọn Kế hoạch khởi động mới cho máy chủ Postal và bắt đầu kế hoạch. Kế hoạch tăng dần lượng gửi mỗi ngày, gửi cho các liên hệ tương tác nhiều nhất trước và giảm tốc khi thư trả lại hoặc khiếu nại tăng.

Kiểm tra kết quả

Thẻ Postal trên Nhà cung cấp gửi thư, rồi Nhà cung cấp hiển thị Đang khởi động trong khi kế hoạch chạy.
Sự kiện của Postal xuất hiện trong Nhà cung cấp gửi thư, rồi Sự kiện và đồng bộ bên cạnh sự kiện chuẩn hóa của ReputeCast và phản hồi SMTP gốc.

ReputeCast gửi mỗi lệnh gọi API một thư thô (raw message) và gắn thẻ cho thư để webhook của Postal tìm được đường về. Bản sao và tệp đính kèm đều dùng được. Postal không báo hạn mức hay tốc độ, nên ReputeCast gửi tối đa 20 thư mỗi giây tới Postal, và ít hơn khi giới hạn hằng ngày và tốc độ của kế hoạch khởi động được áp dụng. MessageDeliveryFailed với lỗi vĩnh viễn là trả thư vĩnh viễn và khiến địa chỉ bị chặn gửi; MessageBounced (thư trả lại mà Postal nhận được về sau) được tính là trả thư tạm thời. Postal không có sự kiện khiếu nại hay hủy đăng ký, nên ReputeCast không nhận được khiếu nại qua Postal, và lượt hủy đăng ký chỉ đến từ liên kết của chính ReputeCast.

Khắc phục sự cố

“ReputeCast không kết nối đến địa chỉ đó”. Server URL phân giải tới một địa chỉ riêng hoặc loopback. Hãy bật providers.allow_private_networks, hoặc dùng địa chỉ công khai của Postal.
“Postal (self-hosted) đã từ chối khóa này” kèm InvalidServerAPIKey. Hãy dùng API credential của cùng mail server, không phải SMTP credential.
“Postal (self-hosted) không trả lời lệnh kiểm tra”. ReputeCast không truy cập được server URL, URL chuyển hướng (ReputeCast không đi theo chuyển hướng), hoặc máy chủ đang bị tạm ngưng. Hãy dùng chính xác địa chỉ HTTPS của giao diện web.
Webhook nhận 401. ReputeCast không xác minh được chữ ký của Postal: không đọc được <Server URL>/.well-known/jwks.json, hoặc webhook đến từ một máy chủ Postal khác. Hãy kiểm tra URL JWKS có tải được từ máy chủ ReputeCast hay không.
Kiểm tra endpoint thất bại vì bản thân ReputeCast chỉ có địa chỉ riêng. Postal không gửi tới đó được. Hãy cấp cho ReputeCast một URL công khai truy cập được, hoặc chọn Tạm dùng hỏi định kỳ sau khi kết nối: chế độ hỏi định kỳ chỉ đọc trạng thái gửi mới nhất của từng thư, không có thư trả lại, lượt mở hay lượt nhấp.
Lượt mở hoặc lượt nhấp có vẻ bị nhân đôi. Tính năng theo dõi lượt nhấp và lượt mở riêng của Postal đang bật cho máy chủ. Hãy tắt trong Postal; ReputeCast không đọc được thiết lập đó.
Bạn đã đổi URL công khai hoặc ngắt kết nối Postal. ReputeCast không thay đổi gì trong Postal. Hãy cập nhật hoặc xóa webhook ở đó.