> ## Documentation Index
> Fetch the complete documentation index at: https://chatbotx.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Export Contacts
> Hướng dẫn xuất danh sách khách hàng (contacts) trong ChatbotX thành file CSV chứa Bot Fields, Custom Fields, Tags hoặc xuất tự động qua Google Sheets.
**Export Contacts** giúp bạn xuất danh sách khách hàng từ ChatbotX ra ngoài hệ thống dưới dạng file CSV hoặc ghi tự động sang Google Sheets. Tính năng này hỗ trợ bạn lưu trữ thông tin khách hàng (bao gồm Bot Fields, Custom Fields và các Tags) hoặc phục vụ cho các chiến dịch quảng cáo.
## Khi nào nên dùng Export Contacts
Bạn nên sử dụng tính năng **Export Contacts** trong các trường hợp sau:
* Cần sao lưu dữ liệu khách hàng để lưu trữ nội bộ.
* Cần tải về danh sách khách hàng kèm các thông tin tùy chỉnh như Custom Fields và thẻ phân loại (Tags) để phân tích dữ liệu.
* Cần chuyển đổi hoặc đồng bộ danh sách khách hàng sang các hệ thống CRM hoặc công cụ marketing khác.
## Cách xuất Contacts trực tiếp qua Actions
Tính năng **Export** trong bảng danh sách Contacts cho phép bạn tải về file CSV chứa đầy đủ thông tin khách hàng một cách nhanh chóng.
Vào mục **Contacts** từ menu bên trái.
Tích chọn các khách hàng cụ thể hoặc tích vào ô vuông trên cùng của danh sách để chọn toàn bộ khách hàng trên trang. Bạn có thể kết hợp với các bộ lọc để chọn đúng nhóm đối tượng mong muốn.
Nhấp vào nút **Actions** ở góc trên bên phải bảng danh sách, sau đó chọn **Export**.
Cửa sổ **Export Contacts** xuất hiện khi file xuất dữ liệu đã sẵn sàng. Bạn có thể nhấn \*\*Download \*\*để tải trực tiếp file CSV chứa dữ liệu khách hàng bao gồm Bot Fields, Custom Fields và các thẻ phân loại (Tags), hoặc nhấn **Copy link** để sao chép đường dẫn tải file.
## Cách xuất toàn bộ dữ liệu qua Google Sheets
Nếu bạn muốn tự động ghi nhận và đồng bộ thông tin khách hàng sang bảng tính trực tuyến theo thời gian thực, hãy sử dụng tích hợp Google Sheets kết hợp với Sequence.
Vào **Settings > Integrations** và kết nối tài khoản Google của bạn với ChatbotX.
Tạo một bảng tính mới trên Google Drive của bạn. Thiết lập các dòng tiêu đề tương ứng với dữ liệu muốn xuất (Ví dụ: First Name, Last Name, Phone, Email, Custom Field...). Sau đó vào phần Google Sheet Manage trên ChatbotX để thêm trang tính mới tạo vào.
Vào mục **Sequences** từ menu bên trái, tạo một Sequence mới. Thêm tin nhắn hoặc hành động xuất dữ liệu: chọn khối **Action** (Hành động), chọn **Google Sheets** và cấu hình hành động **Insert Row** (Chèn dòng). Tiếp tục chọn bảng tính đã chuẩn bị và map các trường dữ liệu tương ứng từ ChatbotX sang Google Sheets.
Quay lại mục **Contacts**, lọc và tích chọn danh sách khách hàng cần xuất. Nhấn **Actions > Add Sequence** và chọn Sequence xuất dữ liệu vừa tạo để hệ thống tự động ghi thông tin khách hàng lên Google Sheets.
File CSV xuất trực tiếp chứa các thông tin cá nhân và trường dữ liệu tùy chỉnh. Vui lòng bảo mật file này và tránh chia sẻ công khai để bảo vệ thông tin khách hàng.
Khi chạy hành động **Add Sequence** để xuất dữ liệu lên Google Sheets cho danh sách lớn, hệ thống sẽ xử lý tuần tự. Hãy đảm bảo kịch bản Sequence của bạn đã được kích hoạt (Active) trước khi chạy hành động hàng loạt.