Chuyển từ Keila 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ừ Keila, bạn kết nối ReputeCast với một dự án Keila bằng khóa API và nhập mọi liên hệ của dự án vào một danh sách ReputeCast, kèm dữ liệu tùy chỉnh và trạng thái của họ. Cách này dùng được với Keila Cloud và với máy chủ Keila bạn tự vận hành. ReputeCast chỉ đọc từ Keila API v1; không có gì thay đổi trong Keila.

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 Keila trong dự án bạn đang chuyển: chọn API Keys ở menu bên trái, nhấp Create new API key, đặt tên và lưu. Keila hiển thị khóa một lần. Nguồn: Keila, API authentication (kiểm tra tháng 10/2026).
Với Keila tự host, ReputeCast phải truy cập được máy chủ 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 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 liên hệ Keila

Mở Nhập liên hệ và chọn Keila.
Kiểm tra Địa chỉ máy chủ. Giá trị ban đầu là https://app.keila.io cho Keila Cloud; hãy thay bằng địa chỉ máy chủ của bạn nếu bạn tự vận hành Keila. Không kèm thông tin đăng nhập, chuỗi truy vấn và fragment; ReputeCast tự thêm /api/v1.
Dán khóa vào Khóa API và chọn Kết nối. Keila không có danh sách, nên trình hướng dẫn hiển thị một danh sách nguồn duy nhất, All contacts, kèm số liên hệ của dự án.
Chọn danh sách ReputeCast sẽ nhận các liên hệ, 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ư, và tiếp tục đến bước ghép trường.
Ghép trường. email là bắt buộc; first_name và last_name khớp với các trường của ReputeCast, và mỗi khóa trong dữ liệu tùy chỉnh của liên hệ trở thành một trường mang tên khóa đó.
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.

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

Mọi liên hệ của dự án được nhập vào một danh sách ReputeCast duy nhất mà bạn đã chọn.
Tên và họ được đưa vào các trường tương ứng.
Dữ liệu tùy chỉnh (data) trở thành trường của liên hệ. Trình hướng dẫn đưa ra các khóa tìm thấy trên 100 liên hệ đầu tiên; một khóa chỉ xuất hiện ở các liên hệ sau đó sẽ không được đưa ra.
Ngày: ngày tạo liên hệ trong Keila trở thành ngày tạo trong ReputeCast. API của Keila không cung cấp ngày hay IP xác nhận đăng ký, nên các liên hệ được nhập dưới dạng xác nhận một bước.

Trạng thái Keila	Trở thành trong ReputeCast
`active`	Đã đăng ký · đã xác nhận (hoặc chờ xác nhận, 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)
`unreachable`	Bị chặn gửi · trả thư vĩnh viễn, mọi luồng (cố định)

Những gì ở lại Keila

Phân khúc của Keila không được nhập, dù bước nguồn có liệt kê tên của chúng: hãy tạo lại chúng thành phân khúc ReputeCast, dựa trên dữ liệu tùy chỉnh bạn đã nhập. Chiến dịch, mẫu, biểu mẫu và người gửi cũng ở lại Keila.

Giới hạn tốc độ

ReputeCast đọc 500 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 Keila 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. 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 liên hệ unsubscribed và unreachable có ở đó.

Khắc phục sự cố

“Keila từ chối khóa API”: khóa đã bị xóa, hoặc thuộc một dự án khác hay một máy chủ Keila khác. Hãy tạo khóa trong đúng dự án.
“Hãy dùng địa chỉ đầy đủ, ví dụ https://lists.example.com.” hoặc “Chỉ dùng địa chỉ của máy chủ …”: hãy nhập địa chỉ bạn dùng để mở Keila, bắt đầu bằng https://, không có gì phía sau tên máy chủ.
“Đị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.
“Keila 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.
Thiếu một khóa dữ liệu tùy chỉnh ở bước ghép trường: không liên hệ nào trong 100 liên hệ đầu tiên có khóa đó. Sau khi nhập, hãy điền trường này bằng một lần nhập CSV khớp liên hệ theo email.