Kết nối nhà cung cấp gửi thư

Để kết nối nhà cung cấp gửi email như Amazon SES, Postmark hay một máy chủ SMTP, ReputeCast đưa bạn qua trình hướng dẫn kết nối gồm sáu bước: nhà cung cấp, kết nối, xác minh tên miền, gửi thử, luồng và liên hệ. Phần lớn mọi người làm xong trong khoảng 10 phút, và trình hướng dẫn nhớ chỗ bạn dừng lại.

Trước khi bắt đầu

• Bạn cần quyền providers:manage. Thành viên có quyền providers:view có thể mở danh mục và theo dõi một lần thiết lập do người khác bắt đầu, nhưng không thay đổi được.
• Chuẩn bị sẵn tài khoản ở nhà cung cấp gửi thư và khóa API của nó (hoặc, với SMTP, thông tin máy chủ). Chọn nhà cung cấp gửi thư so sánh khả năng của từng nhà cung cấp.
• URL công khai của ReputeCast phải truy cập được qua HTTPS từ internet, vì nhà cung cấp gọi đến URL này để báo thư gửi thành công, thư trả lại và khiếu nại. Đặt URL bằng REPUTECAST_PUBLIC_URL trong tệp .env của Docker Compose (thiết lập http.public_url); hãy đọc Reverse proxy và TLS.
• Để xác minh tên miền gửi thư, bạn cần quyền truy cập các bản ghi DNS của tên miền đó.

Kết nối nhà cung cấp

1. Mở Nhà cung cấp gửi thư › , rồi Thêm nhà cung cấp. Ở một không gian làm việc chưa có gì, nút này có tên Kết nối nhà cung cấp.

2. Nhà cung cấp. Chọn nhà cung cấp trong danh mục rồi chọn nút Kết nối của nó. Nếu đã có một lần thiết lập đang dở cho nhà cung cấp này, trình hướng dẫn tiếp tục từ chỗ đã dừng.

3. Kết nối. Nhập thông tin xác thực mà nhà cung cấp yêu cầu. ReputeCast kiểm tra chúng bằng một lệnh gọi chỉ đọc trước khi lưu lại ở dạng mã hóa; chúng không bao giờ được hiển thị lại. Sau đó ReputeCast tự kiểm tra endpoint webhook của mình theo đúng cách nhà cung cấp sẽ gọi, rồi đăng ký webhook ở nhà cung cấp giúp bạn.

   

   Hướng dẫn của từng nhà cung cấp mô tả các trường riêng của nó, ví dụ Amazon SES (CloudFormation stack hoặc khóa IAM, khu vực, SNS topic và configuration set) và bất kỳ máy chủ SMTP nào (máy chủ thư đi và một hộp thư nhận thư trả lại, vì SMTP không có webhook). Với Azure Communication Services và adapter HTTP chung, ReputeCast không tự đăng ký webhook được: nó hiển thị URL webhook và một khóa bí mật để bạn dán vào nhà cung cấp. Khóa bí mật chỉ được hiển thị một lần.

   Chọn Tiếp tục xác minh tên miền.

4. Xác minh tên miền. Nhập tên miền trong địa chỉ người gửi (From) của bạn. ReputeCast hỏi nhà cung cấp xem tên miền đó cần những bản ghi DNS nào, hoặc tự tính ra khi nhà cung cấp không có API tên miền, rồi kiểm tra các bản ghi mỗi 30 giây trong lúc trang đang mở.

   

   1. 1
   2. 2
   3. 3
   4. 4
   5. 5

   1. DKIM, bản ghi đầu tiên trong ba bản ghi cho phép Amazon SES ký thư thay cho tên miền của bạn.
   2. Bản ghi return-path (MAIL FROM), để thư trả lại và SPF căn chỉnh với tên miền của bạn.
   3. SPF cho tên miền gửi thư.
   4. DMARC, bản ghi Gmail và Yahoo yêu cầu với người gửi hàng loạt.
   5. Trạng thái trực tiếp: mọi bản ghi đã được xác minh, và lần kiểm tra gần nhất.

   Công bố các bản ghi ở nhà cung cấp DNS của bạn. Phần lớn nhà cung cấp DNS công bố trong vài phút; một số mất đến 48 giờ. Nếu tên miền dùng Cloudflare, Thêm mọi bản ghi qua API Cloudflare thêm các bản ghi còn thiếu và sửa các bản ghi sai bằng một Cloudflare API token có quyền Zone › DNS › Edit trên zone đó; token chỉ được dùng một lần và không bao giờ được lưu. Với các nhà cung cấp DNS khác, Sao chép dạng tệp zone cho bạn mọi bản ghi cùng lúc. Hãy đọc Cấu hình SPF, DKIM và DMARC để biết từng bản ghi dùng để làm gì.

   Trong phần Không bắt buộc, bạn có thể thêm một tên miền theo dõi liên kết tùy chỉnh và xem BIMI đã được thiết lập hay chưa. Nếu DNS chưa sẵn sàng, chọn Tạm bỏ qua · vẫn gửi thử được từ địa chỉ đã xác minh.

5. Gửi thử. Kiểm tra người gửi (From), người nhận (To) và tiêu đề (Subject), rồi chọn Gửi thử. Dòng thời gian gửi thư được điền dần khi nhà cung cấp nhận thư và sự kiện gửi thành công được báo về, đồng thời cho thấy nhà cung cấp hộp thư nhận đã đánh giá phần xác thực của bạn ra sao. Gửi đến danh sách địa chỉ thử (Gmail, Outlook, Yahoo, iCloud) gửi cùng thư thử đó đến các địa chỉ của chính bạn ở từng nhà cung cấp hộp thư.

   

6. Luồng. Chọn những luồng mà nhà cung cấp này phục vụ: Gửi hàng loạt (chiến dịch), Tự động hóa, Hệ thống (thư xác nhận hai bước, liên kết tùy chọn nhận thư, lời mời vào nhóm) và Giao dịch (thư từ sản phẩm của bạn). Mỗi luồng có tuyến và chính sách chuyển dự phòng riêng, nên một chiến dịch gặp sự cố không bao giờ chặn thư đặt lại mật khẩu.

   

   Khi một nhà cung cấp khác đã phục vụ một luồng, hãy chọn vai trò của nhà cung cấp này: Chính (thay nhà cung cấp hiện tại), Dự phòng (tiếp quản khi nhà cung cấp chính gặp lỗi) hoặc, chỉ với Gửi hàng loạt, Chia theo tỷ trọng kèm tỷ trọng của nó. Nếu điều khoản của nhà cung cấp không cho phép tiếp thị hàng loạt, bạn không bật được Gửi hàng loạt cho nó.

7. Liên hệ. Đưa liên hệ của bạn vào bằng một lần nhập, kéo về các địa chỉ bị chặn mà nhà cung cấp đang giữ (khuyên dùng, để ReputeCast không bao giờ thử gửi đến những địa chỉ đó trên bất kỳ nhà cung cấp nào), hoặc bắt đầu trống. Việc nhập giữ nguyên sự đồng ý: liên hệ đã hủy đăng ký, bị trả thư hoặc đã khiếu nại sẽ vào danh sách chặn gửi và không bao giờ được đăng ký lại. Chọn Hoàn tất thiết lập hoặc Bắt đầu trống và hoàn tất.

Bản tóm tắt liệt kê những gì đã được cấu hình, tất cả đều có thể hoàn tác từ Nhà cung cấp gửi thư, và những việc cần làm trước chiến dịch đầu tiên: thêm một nhà cung cấp khác, kết nối HostRepute và tạo một biểu mẫu đăng ký.

Làm tiếp sau hoặc hủy

• Lưu và làm tiếp sau hoặc Thoát thiết lập giữ lần thiết lập ở trạng thái đang mở. Chọn lại đúng nhà cung cấp đó trong danh mục để tiếp tục ở bước bạn đã rời đi.
• Ứng dụng không có nút hủy. Để hủy một lần thiết lập chưa xong, hãy gọi thao tác API cancel-provider-setup: nhà cung cấp mà lần thiết lập đã kết nối nhưng chưa được tuyến nào dùng sẽ bị ngắt kết nối, và việc hủy được ghi vào nhật ký kiểm tra.

Thay đổi hoặc gỡ nhà cung cấp về sau

Mỗi thẻ nhà cung cấp trên Nhà cung cấp gửi thư › , rồi Nhà cung cấp có nút Cài đặt. Ở đó bạn có thể đặt nhãn cho nhà cung cấp, thay thông tin xác thực (thông tin mới được kiểm tra với nhà cung cấp trước khi thay thông tin cũ), đặt cách bạn trả phí cho nó, và chọn Gỡ nhà cung cấp. Khi gỡ một nhà cung cấp, bạn được yêu cầu chọn nhà cung cấp thay thế cho mọi tuyến có nó; ReputeCast xóa thông tin xác thực của nó và gỡ webhook của nó ở những nơi API của nhà cung cấp cho phép. Các địa chỉ chặn gửi nó đã đóng góp, các sự kiện trước đây và báo cáo của nó vẫn được giữ.

Kiểm tra kết quả

• Nhà cung cấp gửi thư › , rồi Nhà cung cấp hiển thị nhà cung cấp với trạng thái Ổn định, Sandbox hoặc Đang khởi động, dòng webhook (“sự kiện gần nhất …”) và các luồng nó phục vụ.
• Dòng thời gian của lần gửi thử kết thúc bằng một sự kiện gửi thành công.
• Cài đặt › , rồi Người gửi hiển thị các bản ghi của tên miền ở trạng thái đã xác minh. Hãy đọc Thêm tên miền gửi thư và người gửi.

Khắc phục sự cố

• “Không truy cập được endpoint từ internet”: nhà cung cấp không gọi được URL công khai của ReputeCast. Đặt REPUTECAST_PUBLIC_URL thành địa chỉ HTTPS mà reverse proxy của bạn phục vụ rồi khởi động lại, hoặc, khi đang thử trên máy tính cá nhân, dán URL của Cloudflare Tunnel hay ngrok trỏ đến cổng 8080 rồi chọn Kiểm tra lại endpoint. Các nhà cung cấp có API sự kiện (Mailgun, SparkPost) còn có Tạm dùng hỏi định kỳ: ReputeCast hỏi sự kiện mới mỗi phút, nên cơ chế bảo vệ trước thư trả lại trong lúc gửi chậm tối đa một phút.
• “ReputeCast không kết nối đến địa chỉ đó”: máy chủ bạn nhập phân giải ra một địa chỉ loopback hoặc địa chỉ mạng riêng. Người vận hành có thể cho phép các địa chỉ này bằng providers.allow_private_networks; địa chỉ link-local và địa chỉ metadata của đám mây luôn bị từ chối.
• Khóa bị từ chối: bước kết nối ghi rõ loại khóa mà nhà cung cấp cần (ví dụ server token của Postmark chứ không phải account token). Hãy xem hướng dẫn của nhà cung cấp đó.
• Bản ghi mãi ở trạng thái Đang chờ: nhà cung cấp DNS chưa công bố chúng. So sánh giá trị “Đang có” dưới một bản ghi với giá trị ReputeCast mong đợi, và chờ nhà cung cấp DNS tối đa 48 giờ.
• Lần gửi thử không bao giờ có sự kiện gửi thành công: ReputeCast chờ sự kiện này tối đa 30 phút. Nếu không có gì về, webhook không đến được ReputeCast; hãy đọc Tình trạng và sự cố của nhà cung cấp.
• Không bật được Gửi hàng loạt: điều khoản của nhà cung cấp không cho phép tiếp thị hàng loạt trên kết nối này. Với Postmark, hãy tạo một luồng thư Broadcast trước. Hãy đọc Chọn nhà cung cấp gửi thư.

Liên quan

Định tuyến thư qua nhiều nhà cung cấp

Khởi động nhà cung cấp hoặc IP mới

Cấu hình SPF, DKIM và DMARC

Nhập liên hệ từ CSV hoặc XLSX