Your AI Connector Docs

Nhập danh bạ từ tệp

Nếu bạn có danh sách liên hệ trong bảng tính, bạn có thể tải lên tất cả cùng một lúc thay vì thêm từng người một. Ứng dụng sử dụng trình hướng dẫn gồm 3 bước — Tải lên → Ánh xạ cột → Xem lại — hoạt động với tệp CSV bạn đã có mà không cần phải tải xuống mẫu trước.

Cách nhập danh bạ

  1. Nhấp vào Contacts ở thanh bên trái, sau đó nhấp vào Import ở đầu trang.
  2. Tải lên. Kéo tệp CSV của bạn vào vùng thả, hoặc nhấp vào đó để duyệt tìm tệp. Không cần tải xuống mẫu trước — hãy sử dụng tệp bạn đã có.
  1. Ánh xạ cột. Trình hướng dẫn sẽ đọc hàng tiêu đề trong tệp của bạn và cố gắng tự động khớp từng cột với một trường mục tiêu: Tên, Họ, Số điện thoại, Email, Thẻ, Ghi chú hoặc Không nhập. Hãy kiểm tra dự đoán của từng cột và sửa lại nếu sai bằng cách sử dụng bộ chọn bên cạnh. Một bảng xem trước sẽ hiển thị vài hàng đầu tiên chính xác như cách chúng sẽ được nhập.
    • Cột số điện thoại là bắt buộc — bạn không thể tiếp tục nếu không ánh xạ cột này.
    • Một cột được ánh xạ tới Thẻ sẽ trở thành các thẻ thực trên mỗi liên hệ. Bạn có thể để nhiều thẻ trong một ô — hãy phân tách chúng bằng dấu phẩy hoặc dấu chấm phẩy (vip; newsletter; hotmart). Các thẻ chưa tồn tại sẽ được tạo cho bạn; các thẻ đã tồn tại sẽ được sử dụng lại, không phân biệt chữ hoa chữ thường.
  1. Xem lại. Chọn:
    • Kênh mặc định — WhatsApp Business, WhatsApp Web hoặc SMS. Tùy chọn này áp dụng cho bất kỳ liên hệ nào được nhập mà chưa chỉ định kênh.
    • Danh sách — chọn một danh sách hiện có từ menu thả xuống hoặc nhập tên để tạo danh sách mới ngay tại chỗ. Bạn chỉ có thể chọn một trong hai, không thể chọn cả hai.
    • Cập nhật liên hệ hiện có — mặc định là tắt. Nếu tắt, các hàng khớp với liên hệ bạn đã có (cùng số điện thoại) sẽ bị bỏ qua như bản sao: không có gì trên liên hệ đó thay đổi và nó không được thêm vào danh sách. Nếu bật, các hàng đó sẽ cập nhật liên hệ thay vì tạo mới: tên, email và ghi chú trong tệp của bạn sẽ ghi đè lên thông tin hiện có (các ô trống sẽ giữ nguyên giá trị hiện tại), mọi thẻ trong hàng sẽ được thêm vào và liên hệ sẽ được thêm vào danh sách bạn đã chọn. Đây là cách bạn nhập lại tệp để sửa hoặc làm phong phú thêm các liên hệ bạn đã có.
  1. Nhấp vào Nhập [count]. Bạn sẽ được chuyển đến màn hình kết quả hiển thị số lượng liên hệ đã được tạo, số lượng liên hệ hiện có đã được cập nhật (khi tùy chọn đó được bật) và nếu có bất kỳ hàng nào bị bỏ qua, một bảng phân tích lý do (số điện thoại không hợp lệ, thiếu số điện thoại, trùng lặp, đạt giới hạn liên hệ, v.v.).

Chi tiết ánh xạ cột

  • Số điện thoại là cột bắt buộc duy nhất. Các hàng không có số điện thoại sẽ bị loại bỏ trước khi nhập và được đếm riêng trong màn hình kết quả.
  • Tên / Họ / Email ánh xạ trực tiếp vào các trường cơ bản của liên hệ.
  • Ghi chú ánh xạ vào trường Ghi chú / Hồ sơ khách hàng tiềm năng của liên hệ.
  • Thẻ tạo (hoặc sử dụng lại) các thẻ thực và áp dụng chúng cho liên hệ — cùng các thẻ mà bạn dùng để lọc, nhắm mục tiêu phát sóng và kích hoạt webhook. Đặt nhiều thẻ trong một ô được phân tách bằng dấu phẩy hoặc dấu chấm phẩy. Trước ngày 19 tháng 8 năm 2026, cột này được lưu dưới dạng trường tùy chỉnh có tên tags; nếu bạn đã nhập trước thời điểm đó, hãy nhập lại cùng tệp đó với tùy chọn Cập nhật liên hệ hiện có được bật và các thẻ sẽ được áp dụng đúng cách (trường tùy chỉnh tags còn sót lại không gây hại gì; hãy liên hệ bộ phận hỗ trợ nếu bạn muốn xóa nó khỏi mọi liên hệ).
  • Hiện tại không có ánh xạ cột cho các trường tùy chỉnh tùy ý (như các cột custom_<fieldname> của phiên bản cũ) — hãy xem Tải hàng loạt trường tùy chỉnh để biết giải pháp thay thế hiện tại.

Mẹo

  • Kiểm tra kỹ xem số điện thoại đã bao gồm mã quốc gia chưa. Nếu không có mã này, tin nhắn sẽ không được gửi đi — và các hàng không có số điện thoại hợp lệ sẽ bị bỏ qua hoàn toàn.
  • Bạn không cần xóa dấu cách, dấu gạch ngang hoặc dấu ngoặc đơn khỏi số điện thoại — trình nhập có thể xử lý các định dạng thông thường, nhưng vẫn cần mã quốc gia.
  • Các tệp được phân tích hoàn toàn trong trình duyệt của bạn, vì vậy không có giới hạn kích thước tải lên cố định từ chính trình hướng dẫn — nhưng tổng số lượng liên hệ của bạn vẫn bị giới hạn bởi gói dịch vụ. Nếu việc nhập khiến bạn vượt quá giới hạn gói, các hàng đó sẽ bị từ chối và hiển thị trên màn hình kết quả là contact_limit_reached.
  • Nếu một liên hệ có cùng số điện thoại đã tồn tại, hàng đó sẽ bị bỏ qua theo mặc định — nó hiển thị là duplicate trên màn hình kết quả. Việc nhập không bao giờ tạo ra bản sao thứ hai của một người. Để chỉnh sửa hàng loạt các liên hệ bạn đã có (sửa tên hoặc email, thêm thẻ, đưa họ vào danh sách), hãy bật Cập nhật liên hệ hiện có ở bước Xem lại và nhập lại tệp.

Các câu hỏi thường gặp

CSV của tôi có cột custom_company từ bản xuất cũ — nó có ánh xạ chính xác không? Không tự động. Trình tự động khớp của trình hướng dẫn chỉ nhận dạng các tiêu đề tên/điện thoại/email/thẻ/ghi chú; bất kỳ tiêu đề nào khác sẽ mặc định là Không nhập, vì vậy cột custom_company sẽ không tự điền vào trường tùy chỉnh company. Hãy thêm các giá trị sau đó thông qua Trường tùy chỉnh hoặc thông qua API.

Nút “Tải xuống mẫu” đã đi đâu? Nó đã bị loại bỏ — trình hướng dẫn hoạt động trực tiếp với bất kỳ tệp CSV nào bạn đang có và cho phép bạn sửa bất kỳ cột nào không khớp trong bước Ánh xạ.

Tôi đã nhập danh bạ của mình rồi — làm cách nào để thêm thẻ hoặc sửa trường cho tất cả cùng một lúc? Nhập lại cùng tệp đó (hoặc tệp đã cập nhật) với tùy chọn Cập nhật liên hệ hiện có được bật ở bước Xem lại. Các hàng khớp với số điện thoại hiện có sẽ cập nhật liên hệ đó — tên, email, ghi chú, thẻ và danh sách — thay vì bị bỏ qua. Chỉ số điện thoại được sử dụng để khớp, vì vậy hãy giữ cột đó chính xác như cũ.

Tôi có thể nhập danh bạ Instagram hoặc Messenger từ tệp không? Không. Tính năng nhập chỉ hỗ trợ WhatsApp Business, WhatsApp Web và SMS, vì các kênh đó tiếp cận mọi người bằng số điện thoại. Thay vào đó, Instagram và Messenger xác định mọi người bằng tài khoản mạng xã hội của họ, vì vậy các liên hệ đó được tạo tự động khi có ai đó nhắn tin cho bạn trên kênh đó.

Tôi có thể nhập liên hệ ở trạng thái bot-không hoạt động không? Không có cột cho từng hàng để thực hiện việc này. Hãy nhập hàng loạt trước, sau đó sử dụng hành động Tắt bot hàng loạt trên các liên hệ đã nhập — xem Loại trừ liên hệ khỏi AI Bot.

Các bước tiếp theo