Chuyển từ Notifuse 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ừ Notifuse, bạn kết nối ReputeCast với máy chủ Notifuse của bạn bằng khóa API của một không gian làm việc, rồi nhập các danh sách, trạng thái của từng liên hệ trên mỗi danh sách và, nếu muốn, các mẫu email. ReputeCast chỉ đọc từ Notifuse API; không có gì thay đổi trong Notifuse.

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 khóa API trong không gian làm việc Notifuse bạn đang chuyển. Chỉ chủ sở hữu không gian làm việc mới tạo được khóa, và token chỉ hiển thị một lần. ReputeCast chỉ đọc, nên một khóa có phạm vi Contacts read và Lists read là đủ, thêm Templates read nếu muốn mang theo mẫu. Nguồn: Notifuse, Admins & API Keys (kiểm tra tháng 10/2026).
ReputeCast phải truy cập được máy chủ Notifuse của bạn qua HTTP hoặc HTTPS. Máy chủ thuộc mạng riêng hoặc mạng nội bộ bị từ chối, trừ khi hệ thống ReputeCast 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 không gian làm việc Notifuse

Mở Nhập liên hệ và chọn Notifuse.
Nhập Địa chỉ máy chủ của máy chủ Notifuse, như https://notifuse.example.com, dán khóa vào Khóa API và chọn Kết nối. ReputeCast tìm không gian làm việc mà khóa thuộc về và liệt kê các danh sách của nó kèm số lượng.
Đá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ữ Nhập mẫu bật để mang theo mẫu (xem bên dưới). 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; các trường liên hệ khác của Notifuse và trường tùy chỉnh của bạn được ghép theo tên.
Kiểm tra bước đồng ý (xem phần tiếp theo), chạy bước xem trước và bắt đầu nhập. Các mẫu được nhập sau khi liên hệ đã vào.

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

Danh sách trở thành các danh sách ReputeCast bạn đã chọn. Trạng thái của liên hệ được đọc trên từng danh sách, nhưng việc chặn gửi tính theo địa chỉ: một lượt hủy đăng ký, thư trả lại hoặc khiếu nại trên bất kỳ danh sách Notifuse nào cũng chặn gửi địa chỉ đó cho mọi danh sách ReputeCast.
Trường liên hệ: first_name, last_name, full_name, external_id, phone, country, language, timezone, job_title và các trường địa chỉ.
Trường tùy chỉnh (custom_string_1, custom_number_1 và các trường tương tự) được nhập dưới nhãn bạn đặt cho chúng trong Notifuse, như plan cho một trường có nhãn “Plan”. Trường số và trường ngày được đưa ra với đúng kiểu đó, còn trường JSON được nhập dưới dạng văn bản JSON. Trường có nhãn luôn được đưa ra; trường không có nhãn chỉ được đưa ra khi 100 liên hệ đầu tiên của một danh sách đã chọn có dùng chúng.
Ngày: ngày liên hệ tham gia một danh sách trở thành ngày tạo liên hệ và, với các lượt đăng ký đang hoạt động, là bằng chứng đồng ý.
Số điện thoại có thể được ghép vào số điện thoại của liên hệ. Sự đồng ý nhận SMS chỉ được nhập khi các cột cho sự đồng ý cùng ngày, nguồn và nội dung của nó được ghép, nên số điện thoại từ Notifuse thường được nhập mà không kèm sự đồng ý nhận SMS.

Trạng thái trên một danh sách Notifuse	Trở thành trong ReputeCast
`active`	Đã đăng ký · đã xác nhận, kèm ngày đăng ký làm bằng chứng (hoặc chờ xác nhận, hoặc Bỏ qua)
`pending`	Đã đăng ký · chờ xác nhận, kèm email xin phép lại (hoặc Bỏ qua)
`unsubscribed`	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)
`bounced`	Bị chặn gửi · trả thư vĩnh viễn, mọi luồng (cố định)
`complained`	Bị chặn gửi · khiếu nại, mọi luồng (cố định)

Mẫu

Khi Nhập mẫu bật, ReputeCast đọc các mẫu email của không gian làm việc sau khi đọc liên hệ:

Mẫu giao dịch trở thành bản nháp mẫu giao dịch. Không có gì được xuất bản, nên ứng dụng của bạn tiếp tục gửi bằng các phiên bản đang chạy cho đến khi có người xuất bản một bản nháp. Các trường liên hệ như contact.first_name trở thành biến thông thường (first_name), vì thư giao dịch được gửi đến một địa chỉ, không phải đến một hồ sơ liên hệ.
Mẫu tiếp thị, mẫu chào mừng và các mẫu khác trở thành mẫu đã lưu trong trình soạn thảo, giữ nguyên các trường liên hệ. Tên đã được dùng sẽ được thêm số, như “Welcome (2)”.
Email hệ thống của riêng Notifuse (email xác nhận hai bước, hủy đăng ký, thư trả lại và danh sách chặn) ở lại Notifuse: ReputeCast gửi email của riêng mình.

Mẫu được tạo trong trình soạn thảo trực quan của Notifuse được nhập dưới dạng MJML; mẫu ở chế độ mã mang theo mã nguồn MJML của chúng. Nhật ký và bản tóm tắt của lần nhập cho biết bao nhiêu mẫu đã được nhập và bao nhiêu mẫu cần sửa thủ công, chẳng hạn khi mẫu dùng một bộ lọc Liquid mà ReputeCast không có. Nhập mẫu email giao dịch giải thích từng ghi chú chuyển đổi. Nếu bước nhập mẫu thất bại, liên hệ vẫn được nhập và nhật ký cho biết lý do.

Những gì ở lại Notifuse

Các broadcast và số liệu thống kê của chúng, tự động hóa, phân khúc, lịch sử thư, webhook và thiết lập nhà cung cấp không được nhập. Hãy tạo lại phân khúc và tự động hóa bằng phân khúc và tự động hóa.

Giới hạn tốc độ

ReputeCast đọc 100 liên hệ 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ủ Notifuse 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à bao nhiêu mẫu đã được nhập dưới dạng bản nháp và mẫu đã lưu.
Mở Giao dịch: các mẫu giao dịch đã nhập được liệt kê dưới dạng bản nháp.
Mở Người đăng ký, rồi Danh sách chặn gửi: các liên hệ đã hủy đăng ký, bị trả thư và đã khiếu nại có ở đó.

Khắc phục sự cố

“Notifuse đã từ chối khóa API: khóa không gắn với không gian làm việc nào.”: khóa đã bị xóa, hoặc thuộc một máy chủ Notifuse khác. Hãy tạo khóa mới trong đúng không gian làm việc.
“Hãy dùng địa chỉ đầy đủ, ví dụ https://lists.example.com.”: địa chỉ thiếu http:// hoặc https://.
“Địa chỉ đó thuộc một mạng riêng hoặc mạng nội bộ.”: 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.
“Notifuse đã từ chối khóa API (…)” khi đọc liên hệ hoặc mẫu: Notifuse nêu tên phạm vi mà khóa còn thiếu (Contacts, Lists hoặc Templates read). Hãy mở rộng phạm vi của khóa trên trang Team của Notifuse, rồi kết nối lại.
“Chưa nhập mẫu: …” trong nhật ký: liên hệ đã được nhập. Hãy mở Giao dịch, rồi Nhập mẫu để nhập riêng các mẫu giao dịch (nhập mẫu email giao dịch).