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 đích: Tên, Họ, Điện thoại, Email, Thẻ, Ghi chú, bất kỳ trường tùy chỉnh nào của bạn 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.
    • Một cột có tiêu đề trùng với tên của một trong các trường tùy chỉnh của bạn sẽ được tự động khớp với trường đó. Chữ hoa và dấu không quan trọng, vì vậy cột CPF sẽ tìm thấy trường có tên cpf. Bạn cũng có thể tự chọn bất kỳ trường tùy chỉnh nào cho bất kỳ cột nào.
    • Một cột chưa phải là trường tùy chỉnh của bạn có thể trở thành một trường mới: hãy chọn Trường tùy chỉnh mới: trong bộ chọn của cột đó và trường sẽ được tạo khi bạn thực hiện nhập.
    • Nếu một trường tùy chỉnh có kiểu dữ liệu (Số, Hộp kiểm, Danh sách thả xuống) và một số giá trị trong cột không khớp với kiểu đó, trình hướng dẫn sẽ cảnh báo cho bạn biết số lượng hàng bị ảnh hưởng trước khi bạn nhập. Những hàng đó sẽ bị bỏ qua hoàn toàn, bao gồm cả tên và email. Hãy nhấp vào Chuyển thành Văn bản trên cảnh báo để thay đổi kiểu của trường chỉ trong một bước, hoặc sửa lại các giá trị, hoặc đặt cột đó thành Không nhập.
    • Bắt buộc phải có cột số điện thoại — bạn không thể tiếp tục nếu không ánh xạ một cột.
    • 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. Nếu bạn mở trình nhập trong khi trang Liên hệ đang hiển thị một trong các danh sách của bạn, danh sách đó đã được chọn sẵn cho bạn; hãy xóa nó nếu bạn không muốn sử dụng.
    • Cập nhật liên hệ hiện có — mặc định là tắt. Khi tắt, các hàng trù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ó thông tin nào trên liên hệ đó bị thay đổi, mặc dù nếu bạn đã chọn một danh sách, liên hệ bạn đã có vẫn sẽ được thêm vào danh sách đó. Khi bật, các hàng đó sẽ cập nhật liên hệ thay vì bỏ qua: 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 đưa đế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), số lượng liên hệ bạn đã có được thêm vào danh sách bạn đã chọn và nếu có hàng nào bị bỏ qua, sẽ có 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.). Nếu Cập nhật liên hệ hiện có đang tắt và một số hàng khớp với các liên hệ bạn đã có, màn hình kết quả sẽ thông báo điều đó và cung cấp tùy chọn Cập nhật các liên hệ này: chỉ cần một cú nhấp chuột để gửi lại các hàng đó với tùy chọn được bật, vì vậy bạn không cần phải nhập lại tệp.

Chi tiết ánh xạ cột

  • Đ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 trên 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ệ — chính là 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 ô, 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 một 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 sẽ không gây hại gì; hãy nhắn tin cho bộ phận hỗ trợ nếu bạn muốn xóa nó khỏi mọi liên hệ).
  • Trường tùy chỉnh — mỗi trường tùy chỉnh của bạn là một đích đến riêng. Tiêu đề khớp với tên trường sẽ được chọn cho bạn; giá trị được lưu trên liên hệ chính xác như trong tệp (trường Số, Ngày, Hộp kiểm hoặc Danh sách thả xuống sẽ chuyển đổi các dạng dễ nhận biết như 19,99, 01/02/1990 hoặc yes). Chọn Trường tùy chỉnh mới để tạo trường từ một cột. Với tùy chọn Cập nhật liên hệ hiện có được bật, các giá trị trường tùy chỉnh trong tệp cũng sẽ cập nhật các liên hệ bạn đã có; các ô trống sẽ giữ nguyên giá trị hiện tại.
  • Một cột chứa các định danh có dấu chấm, dấu gạch ngang hoặc số 0 đứng đầu (như CPF, mã số thuế, mã bưu chính) thuộc về trường Văn bản. Trong trường Số, các giá trị đó không khớp và hàng sẽ bị bỏ qua.

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 có 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 vượt quá giới hạn gói của bạn, 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ó sẽ hiển thị là duplicate trên màn hình kết quả. Việc nhập sẽ không bao giờ tạo bản sao thứ hai của một người. Việc chọn danh sách vẫn hoạt động trên các hàng đó: liên hệ bạn đã có sẽ được thêm vào danh sách và được tính riêng trên màn hình kết quả, vì vậy việc nhập lại cùng một tệp là cách bạn điền vào danh sách với những người đã có trong tài khoản của mình. Để làm mới các trường của họ (sửa tên hoặc email, thêm thẻ), 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

Tệp CSV của tôi có cột custom_company từ bản xuất cũ — liệu nó có ánh xạ chính xác không? Không tự động, vì tiêu đề không hoàn toàn là company. Hãy chọn Trường tùy chỉnh: company trong bộ chọn của cột đó và nó sẽ được nhập vào trường company. Việc đổi tên tiêu đề thành company trước khi tải lên sẽ giúp trình hướng dẫn khớp nó cho bạn.

Một số hàng đã bị bỏ qua với thông báo “Giá trị trường tùy chỉnh không khớp với kiểu của trường đó” — tại sao? Cột đó được ánh xạ tới một trường tùy chỉnh có kiểu dữ liệu (ví dụ: Số) và các hàng đó chứa dữ liệu khác, chẳng hạn như 001.576.401-08 trong trường Số. Hãy nhấp vào Chuyển thành Văn bản trên cảnh báo trong bước Ánh xạ cột (hoặc thay đổi kiểu trong phần Trường tùy chỉnh) và nhập lại tệp với tùy chọn Cập nhật liên hệ hiện có được bật.

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