Chuyển từ listmonk 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ừ listmonk, bạn cung cấp cho ReputeCast địa chỉ máy chủ listmonk và một người dùng API, rồi nhập từng danh sách listmonk vào một danh sách ReputeCast, kèm thuộc tính và trạng thái của người đăng ký. ReputeCast chỉ đọc từ listmonk API; không có gì thay đổi trên máy chủ listmonk của bạ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 người dùng API trong listmonk 4.0 trở lên tại Admin › Users. Người dùng API được cấp một token tự sinh thay cho mật khẩu. Hãy gán cho người dùng này một vai trò có thể đọc mọi danh sách và mọi người đăng ký (lists:get_all và subscribers:get_all). Nguồn: listmonk, User roles and permissions và listmonk API introduction (kiểm tra tháng 10/2026).
ReputeCast phải truy cập được máy chủ listmonk qua HTTP hoặc HTTPS. Máy chủ thuộc mạng riêng hoặc mạng nội bộ (ví dụ 10.0.0.5 hoặc một tên .internal phân giải ra địa chỉ như vậy) bị từ chối, trừ khi hệ thống bật providers.allow_private_networks (xem tham chiếu cấu hình).
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 listmonk

Mở Nhập liên hệ và chọn listmonk.
Trong Địa chỉ máy chủ, nhập địa chỉ bạn dùng để mở listmonk, như https://lists.example.com, không kèm thông tin đăng nhập, chuỗi truy vấn hay fragment; ReputeCast tự thêm /api. Nhập tên người dùng API vào Người dùng API và token của người dùng đó vào Token API, rồi chọn Kết nối.

Trình hướng dẫn liệt kê mọi danh sách listmonk, kèm số người đăng ký đã đăng ký, đã hủy đăng ký và chờ xác nhận.
Đá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.
Ghép trường. email là bắt buộc; name được đưa vào trường tên và họ, và mỗi thuộc tính trở thành một trường mang tên khóa của nó.
Ở bước đồng ý, kiểm tra mỗi trạng thái trở thành gì (xem phần tiếp theo).
Chạy bước xem trước và bắt đầu nhập.

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

Danh sách trở thành các danh sách ReputeCast bạn đã chọn.
Tên được tách thành tên và họ.
Thuộc tính (attribs) trở thành trường của liên hệ. Trình hướng dẫn đưa ra các khóa thuộc tính tìm thấy trên 100 người đăng ký đầu tiên của mỗi danh sách đã chọn; một khóa chỉ xuất hiện ở những người đăng ký sau đó sẽ không được đưa ra.
Ngày: ngày tạo người đăng ký trở thành ngày tạo liên hệ. listmonk không có IP xác nhận đăng ký, nên không có IP nào được lưu.

Trạng thái listmonk	Trở thành trong ReputeCast
`confirmed` trên danh sách	Đã đăng ký · đã xác nhận (hoặc chờ xác nhận, hoặc Bỏ qua)
`unconfirmed` trên danh sách xác nhận một bước	Đã đăng ký · đã xác nhận (hoặc chờ xác nhận, hoặc Bỏ qua)
`unconfirmed` trên danh sách xác nhận hai bước	Đã đăng ký · chờ xác nhận, kèm email xin phép lại (hoặc Bỏ qua)
`unsubscribed` khỏi danh sách	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)
Người đăng ký bị `blocklisted` trong listmonk	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 người đăng ký đã hủy đăng ký khỏi một danh sách listmonk 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.

listmonk không có trạng thái riêng cho địa chỉ bị trả thư, nên một địa chỉ mà listmonk đưa vào blocklist sau các lần trả thư sẽ được nhập như một lượt hủy đăng ký, vốn vẫn cho phép thư Hệ thống. Để chặn các địa chỉ như vậy trên mọi luồng, hãy thêm chúng bằng Thêm địa chỉ trên danh sách chặn gửi sau khi nhập: địa chỉ được thêm ở đó không nhận thư trên bất kỳ luồng nào.

Những gì ở lại listmonk

Chiến dịch và số liệu thống kê của chúng, mẫu, bản ghi thư trả lại, tệp media và thiết lập không được nhập. Hãy tạo lại mẫu trong trình soạn thảo.

Giới hạn tốc độ

listmonk chạy trên máy chủ của chính bạn, nên tốc độ phản hồi phụ thuộc vào máy chủ đó. ReputeCast đọc 1.000 người đăng ký mỗi yêu cầu, lần lượt từng yêu cầu một, và lùi lại khi máy chủ trả lời 429 hoặc lỗi 5xx:

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

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ệ. 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 đó.
Mở Người đăng ký, rồi Danh sách chặn gửi và kiểm tra rằng các địa chỉ đã hủy đăng ký và bị blocklist có ở đó.

Khắc phục sự cố

“Hãy dùng địa chỉ đầy đủ, ví dụ https://lists.example.com.”: địa chỉ thiếu http:// hoặc https://.
“Chỉ dùng địa chỉ của máy chủ … không kèm thông tin xác thực, chuỗi truy vấn hay phần sau dấu #.”: hãy bỏ user:password@, ?… hoặc #… khỏi địa chỉ.
“Địa chỉ đó thuộc một mạng riêng hoặc mạng nội bộ.”: máy chủ phân giải ra một địa chỉ riêng, loopback, link-local hoặc địa chỉ metadata. Hãy dùng địa chỉ công khai của máy chủ, hoặc nhờ người vận hành bật providers.allow_private_networks. Việc kiểm tra chạy lại ở mỗi lần kết nối, nên một tên công khai về sau phân giải ra địa chỉ riêng cũng bị từ chối.
“listmonk chuyển hướng sang một địa chỉ khác (301). Hãy nhập địa chỉ mà máy chủ thực sự phản hồi.”: ReputeCast không đi theo chuyển hướng. Hãy nhập địa chỉ cuối cùng, thường là địa chỉ https://.
“listmonk từ chối khóa API”: người dùng API hoặc token sai, hoặc vai trò của người dùng không thể đọc danh sách và người đăng ký.
“Không kết nối được listmonk: …”: ReputeCast không mở được kết nối đến máy chủ. Hãy kiểm tra DNS, tường lửa và chứng chỉ TLS.