# Facebook Lead Forms Bạn đang chạy quảng cáo Facebook để thu thập khách hàng tiềm năng? Tích hợp này sẽ tự động gửi những khách hàng đó vào Your AI Connector để bạn có thể theo dõi họ qua WhatsApp, SMS hoặc bất kỳ kênh kết nối nào khác — mà không cần phải động tay vào. Nó hoạt động bằng cách kết nối Facebook Lead Ads với Your AI Connector thông qua một nền tảng tự động hóa (như Pabbly, Zapier hoặc Make). Các nền tảng này đóng vai trò là cầu nối giữa Facebook và Your AI Connector, chuyển thông tin khách hàng tiềm năng từ bên này sang bên kia bằng cách sử dụng API (một phương thức để các phần mềm khác nhau trao đổi dữ liệu tự động). --- ## Điều kiện tiên quyết Trước khi bắt đầu, hãy đảm bảo bạn có: - **Quyền truy cập Facebook Ads Manager** với quyền tạo Lead Ads. - **Một tài khoản** với khóa API đang hoạt động (tạo khóa tại **Cài đặt → Tích hợp → Khóa API** — xem [Truy cập API](api-access.md) để biết các bước chính xác). - **Một tài khoản nền tảng tự động hóa** — Pabbly Connect, Zapier hoặc Make (Integromat). Hướng dẫn này sử dụng Pabbly làm ví dụ, nhưng các bước thực hiện tương tự trên bất kỳ nền tảng nào. - **Một danh sách liên hệ** trong Your AI Connector nơi các khách hàng tiềm năng mới sẽ được thêm vào — xem [Tổ chức Danh sách & Liên hệ](../get-started/list-and-contact-management.md). --- ## Tổng quan Tích hợp này hoạt động theo ba giai đoạn: 1. Khách hàng tiềm năng điền vào Biểu mẫu Khách hàng tiềm năng Facebook của bạn. 2. Nền tảng tự động hóa của bạn phát hiện khách hàng tiềm năng mới và gửi thông tin đến Your AI Connector một cách tự động (sử dụng hai lệnh gọi API). 3. Your AI Connector tạo liên hệ và thêm họ vào danh sách bạn đã chỉ định. Từ đó, một chương trình phát sóng, một chiến dịch hoặc một Tác nhân AI mà bạn đã chỉ định sẽ xử lý phần còn lại — cho dù đó là tin nhắn chào mừng được hỗ trợ bởi AI, chuỗi tin nhắn tự động (drip sequence) hay theo dõi thủ công. --- ## Bước 1: Tạo Facebook Lead Form của bạn 1. Mở **Facebook Ads Manager**. 2. Tạo chiến dịch mới với mục tiêu **Khách hàng tiềm năng (Leads)**. 3. Ở cấp độ quảng cáo, chọn **Instant Form** làm phương thức thu thập khách hàng tiềm năng. 4. Xây dựng biểu mẫu của bạn với các trường thông tin cần thiết. Tối thiểu, hãy bao gồm: - **Tên** - **Số điện thoại** (có mã quốc gia) - Tùy chọn: Họ, email 5. Xuất bản quảng cáo hoặc lưu biểu mẫu dưới dạng bản nháp để kiểm tra. --- ## Bước 2: Kiểm tra Lead Form Trước khi kết nối tự động hóa, hãy gửi một khách hàng tiềm năng thử nghiệm: 1. Trong Ads Manager, đi tới Lead Form của bạn. 2. Nhấp vào **Xem trước (Preview)** và điền vào biểu mẫu bằng dữ liệu thử nghiệm. 3. Xác nhận khách hàng tiềm năng thử nghiệm xuất hiện trong **Facebook Lead Center** của bạn (trong phần Công cụ đăng bài trên Trang Facebook của bạn hoặc trong Ads Manager mục "Khách hàng tiềm năng"). Mục nhập thử nghiệm này sẽ được sử dụng để thiết lập ánh xạ trường trong nền tảng tự động hóa của bạn. --- ## Bước 3: Thiết lập tự động hóa ### Kết nối Facebook Lead Ads làm Trình kích hoạt (Trigger) 1. Đăng nhập vào nền tảng tự động hóa của bạn (Pabbly, Zapier hoặc Make). 2. Tạo một quy trình làm việc / kịch bản / zap mới. 3. Đặt **trình kích hoạt** thành "Facebook Lead Ads - New Lead." 4. Kết nối tài khoản Facebook của bạn và chọn Trang cũng như Biểu mẫu khách hàng tiềm năng. 5. Lấy dữ liệu khách hàng tiềm năng thử nghiệm để xác nhận kết nối hoạt động và ánh xạ các trường. ### Cấu hình Lệnh gọi API 1: Tạo Liên hệ Thêm một bước hành động với Yêu cầu HTTP / Webhook / API: - **Phương thức:** `POST` - **URL:** `https://api.youraiconnector.com/v1/contacts?apiKey=YOUR_API_KEY` - **Tiêu đề (Headers):** ``` Content-Type: application/json ``` - **Nội dung (JSON):** ```json { "firstName": "{{first_name}}", "lastName": "{{last_name}}", "phone": "{{phone_number}}", "email": "{{email}}" } ``` Thay thế `{{placeholders}}` bằng các ánh xạ trường thực tế từ bước kích hoạt của bạn. ::: warning **Quan trọng:** Số điện thoại phải bao gồm mã quốc gia (ví dụ: `+1` cho Hoa Kỳ hoặc `+31` cho Hà Lan). Nếu biểu mẫu khách hàng tiềm năng của bạn thu thập số điện thoại mà không có mã quốc gia, hãy thêm một bước định dạng vào quy trình tự động hóa của bạn để thêm mã này vào phía trước. ::: Phản hồi API trả về ID của liên hệ mới tại `data.contactId`. Hãy lưu giá trị đó — bạn sẽ cần nó cho bước tiếp theo. > **Bạn có thể bỏ qua lệnh gọi thứ hai.** `POST /v1/contacts` cũng chấp nhận `listId` (một danh sách) hoặc `listIds` (nhiều danh sách) trong phần thân yêu cầu tạo, giúp thêm liên hệ mới vào các danh sách đó trong cùng một yêu cầu. Chỉ sử dụng phiên bản hai bước bên dưới nếu nền tảng tự động hóa của bạn yêu cầu liên hệ phải tồn tại trước khi quyết định sử dụng danh sách nào. ### Cấu hình Lệnh gọi API 2: Thêm Liên hệ vào Danh sách Thêm bước hành động thứ hai: - **Phương thức:** `POST` - **URL:** `https://api.youraiconnector.com/v1/contacts/lists?apiKey=YOUR_API_KEY` - **Tiêu đề (Headers):** ``` Content-Type: application/json ``` - **Nội dung (JSON):** ```json { "contactId": "{{contact_id_from_previous_step}}", "listId": "YOUR_LIST_ID" } ``` Thay thế `YOUR_LIST_ID` bằng ID thực tế của danh sách liên hệ của bạn (xem [Tìm ID Danh sách của bạn](#finding-your-list-id) bên dưới), và ánh xạ `contactId` tới `data.contactId` được trả về bởi lệnh gọi API đầu tiên. --- ## Tìm ID Danh sách của bạn 1. Trong Your AI Connector, nhấp vào **Liên hệ**, sau đó chọn tab **Danh sách**. 2. Mở menu hàng ("⋯") bên cạnh danh sách bạn muốn và nhấp vào **Sao chép ID danh sách**. Xem [Tổ chức Danh sách & Liên hệ](../get-started/list-and-contact-management.md) để biết hướng dẫn đầy đủ về trang Danh sách. --- ## Bước 4: Kiểm tra Quy trình làm việc đầy đủ 1. Gửi một khách hàng tiềm năng thử nghiệm khác thông qua biểu mẫu Facebook của bạn (hoặc phát lại khách hàng tiềm năng thử nghiệm hiện có trong nền tảng tự động hóa của bạn). 2. Kiểm tra Your AI Connector để xác nhận: - **Liên hệ** đã được tạo với đúng tên, số điện thoại và email. - Liên hệ đã được **thêm vào đúng danh sách**. 3. Nếu bạn có chương trình phát sóng, chiến dịch hoặc AI Agent được thiết lập để nhắn tin cho danh sách đó một cách tự động, hãy xác nhận rằng nó kích hoạt như mong đợi. --- ## Tham chiếu dữ liệu Dưới đây là các ví dụ về dữ liệu được gửi và nhận trong quá trình tích hợp. ### Tạo liên hệ - Yêu cầu ```json POST https://api.youraiconnector.com/v1/contacts?apiKey=YOUR_API_KEY { "firstName": "Jane", "lastName": "Smith", "phone": "+15551234567", "email": "jane@example.com" } ``` ### Tạo liên hệ - Phản hồi ```json { "success": true, "data": { "message": "Successfully created new contact", "contactId": "abc123xyz", "listsAdded": [] } } ``` ### Thêm liên hệ vào danh sách - Yêu cầu ```json POST https://api.youraiconnector.com/v1/contacts/lists?apiKey=YOUR_API_KEY { "contactId": "abc123xyz", "listId": "LIST_ID" } ``` --- ## Mẹo - **Xử lý trùng lặp:** nếu một liên hệ có cùng số điện thoại đã tồn tại, lệnh gọi tạo sẽ trả về `{"success": false, "error_code": 409}` và không trả về liên hệ hiện có. Hãy phân nhánh dựa trên `error_code` (trạng thái HTTP là 200) và tìm kiếm liên hệ bằng `GET /v1/contacts?phoneNumber=...` trước khi thực hiện lệnh gọi thêm vào danh sách. - **Nhiều biểu mẫu:** tạo các quy trình tự động hóa riêng biệt cho các biểu mẫu khách hàng tiềm năng khác nhau, mỗi quy trình nhắm mục tiêu đến một danh sách khác nhau và một chương trình phát sóng, chiến dịch hoặc AI Agent khác nhau. - **Thông báo lỗi:** định cấu hình nền tảng tự động hóa của bạn để thông báo cho bạn nếu lệnh gọi API thất bại, để bạn không bị mất khách hàng tiềm năng. --- ## Các bước tiếp theo - [Chuyển từ Chiến dịch sang Phát sóng & Tác nhân](../moving-from-campaigns.md) — thiết lập tính năng tự động nhắn tin cho khách hàng tiềm năng mới. - [Truy cập API](api-access.md) — tài liệu API đầy đủ cho các tích hợp nâng cao. - [Webhook](webhooks.md) — nhận thông báo khi liên hệ được tạo hoặc gắn thẻ.