> ## 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.

# Kết nối Facebook Ads với Kịch bản Chatbot

> Hướng dẫn kết hợp Facebook Ads JSON và Payload ID với ChatbotX để tự động hóa kịch bản phản hồi khi khách hàng nhấp vào quảng cáo Messenger.

Quảng cáo nhấp để nhắn tin trên Facebook (Click to Messenger) là giải pháp hàng đầu giúp doanh nghiệp tiếp cận khách hàng tiềm năng và chuyển đổi trực tiếp trong cuộc hội thoại. Khi khách hàng bấm vào nút **Gửi tin nhắn** trên quảng cáo, trải nghiệm mở đầu đóng vai trò quyết định đến việc họ có tiếp tục tương tác hay không.

ChatbotX hỗ trợ kết nối toàn diện quảng cáo Facebook với hệ thống kịch bản tự động thông qua hai chuẩn dữ liệu chính của Meta: **Facebook Ads JSON** (mẫu tin nhắn có cấu trúc kèm nút bấm) và **Postback Payload ID** (mã kích hoạt phản hồi ngầm).

Khác với các nền tảng chatbot truyền thống đòi hỏi bạn phải tạo công cụ Ads JSON riêng biệt với nhiều thao tác trung gian rườm rà, ChatbotX áp dụng cơ chế tự động hóa hoàn toàn. Bạn chỉ cần thiết kế kịch bản trong mục **Flows** và nhấn nút **Publish**. Hệ thống sẽ tự động đồng bộ nội dung của bước tin nhắn đầu tiên sang Trình quản lý quảng cáo Meta dưới tên ứng dụng đối tác **ChatConnectX**.

## Thiết lập chiến dịch quảng cáo tin nhắn trên Meta

Trước khi tích hợp kịch bản chatbot, bạn cần khởi tạo chiến dịch quảng cáo với mục tiêu nhắn tin trên Meta Ads Manager (Trình quản lý quảng cáo Meta).

**1. Chọn mục tiêu chiến dịch Lượt tương tác**

Trong Trình quản lý quảng cáo Meta, nhấn nút tạo chiến dịch mới. Tại mục chọn cách mua (Buying type), giữ mặc định là **Đấu giá (Auction)**. Tại mục mục tiêu chiến dịch (Campaign objective), chọn **Lượt tương tác (Engagement)** và nhấn **Tiếp tục**.

![Facebook Ads Campaign Objective Engagement](https://mintcdn.com/chatbotx/2O8c-D8d1rpQb90S/images/facebook_ads_campaign_objective_engagement.png?fit=max\&auto=format\&n=2O8c-D8d1rpQb90S\&q=85\&s=b1892c0adcf36dbdce41a32a710f8b74)

Mục tiêu này tối ưu hóa việc phân phối quảng cáo đến những người có khả năng gửi tin nhắn và trò chuyện với doanh nghiệp trên Messenger.

**2. Cài đặt nhóm quảng cáo**

Tại cấp độ Nhóm quảng cáo (Ad Set), chọn vị trí chuyển đổi là **Ứng dụng nhắn tin (Messaging apps)**. Trong danh sách ứng dụng, tích chọn **Messenger** và lựa chọn đúng Trang Facebook đang kết nối với tài khoản ChatbotX của bạn.

**3. Chọn nút kêu gọi hành động Gửi tin nhắn**

Chuyển sang cấp độ Quảng cáo (Ad level), tải lên hình ảnh hoặc video quảng cáo và điền nội dung bài viết. Tại mục Lời kêu gọi hành động (Call to action), chọn **Gửi tin nhắn (Send message)**.

![Facebook Ads Ad Cta Send Message](https://mintcdn.com/chatbotx/2O8c-D8d1rpQb90S/images/facebook_ads_ad_cta_send_message.png?fit=max\&auto=format\&n=2O8c-D8d1rpQb90S\&q=85\&s=c5b0ce8821c0e04e9570836817e8942e)

Khung xem trước bên phải sẽ hiển thị nút bấm nhắn tin dẫn trực tiếp vào hộp thư Messenger của Trang.

## Thiết kế kịch bản mở đầu trong ChatbotX

Để quảng cáo tự động kích hoạt kịch bản khi người dùng nhấp vào, bạn cần chuẩn bị một kịch bản trong ChatbotX.

**1. Tạo kịch bản mới**

Từ menu điều hướng chính của ChatbotX, vào mục **Automation** và chọn **Flows**. Nhấn **+ Create Flow** để tạo một kịch bản mới dành riêng cho chiến dịch quảng cáo.

**2. Cấu hình bước tin nhắn đầu tiên**

Thiết kế nội dung cho khối tin nhắn khởi đầu (**Send Message #1**). Đưa ra thông điệp ngắn gọn, trực diện, gợi mở nhu cầu và tận dụng thuộc tính họ tên `{{first_name}}` để cá nhân hóa lời chào.

> [!NOTE]
>
> Khối tin nhắn đầu tiên bắt buộc phải chứa **Nút bấm (Buttons)** hoặc **Trả lời nhanh (Quick Replies)**. Theo chính sách của Meta, cuộc trò chuyện chỉ chính thức ghi nhận người dùng trở thành một Liên hệ (Contact) và mở ra khung giờ nhắn tin tiêu chuẩn 24 giờ sau khi khách hàng chủ động bấm nút hoặc gửi tin nhắn phản hồi.

**3. Kết nối các bước tư vấn tiếp theo**

Từ các nút bấm ở khối đầu tiên, kéo dây nối sang các khối tin nhắn hoặc hành động kế tiếp (**Send Message #2**) để tiếp tục tư vấn sản phẩm, thu thập thông tin hoặc gắn thẻ phân loại khách hàng.

**4. Xuất bản kịch bản**

Nhấn nút **Publish** ở góc trên bên phải thanh công cụ.

![Facebook Ads Flow Publish Button](https://mintcdn.com/chatbotx/2O8c-D8d1rpQb90S/images/facebook_ads_flow_publish_button.png?fit=max\&auto=format\&n=2O8c-D8d1rpQb90S\&q=85\&s=36ae9062339438a37f65ab0c5913ae33)

Ngay khi bạn nhấn Publish, ChatbotX sẽ tự động biên dịch nội dung của khối tin nhắn đầu tiên thành mẫu tin nhắn chuẩn của Meta và đồng bộ trực tiếp sang tài khoản quảng cáo liên kết.

## Ba phương thức kết nối kịch bản vào quảng cáo Meta

Sau khi xuất bản kịch bản trên ChatbotX, bạn có thể lựa chọn 1 trong 3 cách dưới đây để gắn kịch bản vào mẫu tin nhắn của quảng cáo trên Meta.

> [card] Chọn ứng dụng đối tác
>
> Khuyên dùng cho mọi chiến dịch. Nhanh nhất, tự động đồng bộ qua ChatConnectX và không cần xử lý mã kỹ thuật.

> [card] Dán mã JSON
>
> Phù hợp khi cần sao chép mẫu tin nhắn sang tài khoản quảng cáo khác hoặc lưu trữ dưới dạng mã nguồn độc lập.

> [card] Gắn Payload ID
>
> Dành cho trường hợp bạn muốn dùng mẫu bắt chuyện mặc định của Meta nhưng vẫn kích hoạt kịch bản ChatbotX khi khách bấm nút.

### Phương thức 1: Chọn ứng dụng đối tác ChatConnectX

Đây là phương thức tối ưu và thuận tiện nhất được ChatbotX khuyến nghị sử dụng.

**1. Mở danh mục Mẫu đã lưu**

Tại cấp độ Quảng cáo trên Meta Ads Manager, cuộn xuống phần **Mẫu tin nhắn (Conversations)**. Nhấp chọn tab **Saved templates (Mẫu đã lưu)**.

![Facebook Ads Meta Saved Templates Partner App](https://mintcdn.com/chatbotx/2O8c-D8d1rpQb90S/images/facebook_ads_meta_saved_templates_partner_app.png?fit=max\&auto=format\&n=2O8c-D8d1rpQb90S\&q=85\&s=921f234f6814b17b0f210817996d1bb3)

Hệ thống sẽ hiển thị danh sách các nguồn mẫu tin nhắn, bao gồm mục ứng dụng đối tác **ChatConnectX**.

**2. Chọn mẫu kịch bản đã đồng bộ**

Nhấp vào thư mục **ChatConnectX** và chọn đúng tên kịch bản bạn vừa xuất bản trên ChatbotX.

![Facebook Ads Meta Partner Template Selection](https://mintcdn.com/chatbotx/2O8c-D8d1rpQb90S/images/facebook_ads_meta_partner_template_selection.png?fit=max\&auto=format\&n=2O8c-D8d1rpQb90S\&q=85\&s=bda2b94fe78805011a2d24cc0f350c4f)

Khung xem trước bên phải sẽ phản ánh chính xác nội dung tin nhắn, biến họ tên và các nút bấm mà bạn đã thiết kế trên ChatbotX. Nhấn **Lưu và hoàn tất** để áp dụng.

### Phương thức 2: Dán mã JSON trực tiếp

Nếu bạn muốn tùy biến mã JSON thủ công hoặc sử dụng trên một tài khoản quảng cáo chưa kết nối trực tiếp, bạn có thể lấy mã JSON trực tiếp từ kịch bản ChatbotX.

**1. Mở menu tùy chọn kịch bản**

Trong trình dựng kịch bản ChatbotX, nhấp vào biểu tượng dấu ba chấm (`...`) ở góc trên bên phải cạnh nút Publish. Chọn **Get JSON for Messenger Ads**.

![Facebook Ads Flow Menu Get Json](https://mintcdn.com/chatbotx/2O8c-D8d1rpQb90S/images/facebook_ads_flow_menu_get_json.png?fit=max\&auto=format\&n=2O8c-D8d1rpQb90S\&q=85\&s=d8797499cda770c5508639cee156466d)

**2. Sao chép đoạn mã JSON**

Cửa sổ **Get JSON for Messenger Ads** xuất hiện hiển thị toàn bộ mã cấu trúc JSON của khối tin nhắn mở đầu. Nhấn nút **Copy** để sao chép mã vào bộ nhớ tạm.

![Facebook Ads Flow Modal Copy Json](https://mintcdn.com/chatbotx/2O8c-D8d1rpQb90S/images/facebook_ads_flow_modal_copy_json.png?fit=max\&auto=format\&n=2O8c-D8d1rpQb90S\&q=85\&s=5b2ffcf6e5d4c2a155078d82341c943a)

> [!NOTE]
>
> Bạn chỉ cần lấy lại mã JSON mới khi có sự thay đổi nội dung ở khối tin nhắn đầu tiên. Các thay đổi ở những khối phía sau trong kịch bản sẽ không ảnh hưởng đến đoạn mã này.

**3. Tạo mẫu tin nhắn mới trên Meta**

Chuyển sang Meta Ads Manager, tại mục **Conversations**, nhấn nút **+ Create template** để mở trình tạo mẫu.

![Facebook Ads Meta Create Template Button](https://mintcdn.com/chatbotx/2O8c-D8d1rpQb90S/images/facebook_ads_meta_create_template_button.png?fit=max\&auto=format\&n=2O8c-D8d1rpQb90S\&q=85\&s=b18de599677fbc6ba51ded018a1c69f7)

**4. Chọn loại mẫu JSON**

Trong cửa sổ bật lên **Select a template**, cuộn xuống mục **Advanced** và tích chọn **JSON** (*Customize your own template with JSON in our code editor*). Sau đó nhấn nút **Next >** ở góc dưới bên phải.

![Facebook Ads Meta Template Select Json Advanced](https://mintcdn.com/chatbotx/2O8c-D8d1rpQb90S/images/facebook_ads_meta_template_select_json_advanced.png?fit=max\&auto=format\&n=2O8c-D8d1rpQb90S\&q=85\&s=c52f3dede0cb8efa8e6b0ee9a285cea3)

**5. Dán mã JSON và lưu mẫu**

Xóa toàn bộ nội dung mã mặc định trong khung soạn thảo JSON và dán đoạn mã vừa sao chép từ ChatbotX vào. Quan sát khung xem trước trên điện thoại ở bên phải để kiểm tra nội dung hiển thị. Đặt tên nhận diện tại mục **Template name** và nhấn **Save** để hoàn tất.

![Facebook Ads Meta Paste Json Code Preview](https://mintcdn.com/chatbotx/2O8c-D8d1rpQb90S/images/facebook_ads_meta_paste_json_code_preview.png?fit=max\&auto=format\&n=2O8c-D8d1rpQb90S\&q=85\&s=85062e8e75755097338866c9ddee2f2b)

### Phương thức 3: Gắn Postback Payload ID vào mẫu tin nhắn

Phương thức này cho phép bạn tạo giao diện tin nhắn mở đầu dạng **Bắt chuyện (Start conversations)** trực tiếp trên Meta, sau đó gắn mã Payload ID vào nút bấm để khi khách hàng nhấp vào, hệ thống ChatbotX sẽ tự động nhận diện và gửi tiếp kịch bản tương ứng.

**1. Lấy mã Payload ID trong ChatbotX**

Mở kịch bản trong ChatbotX, bấm vào biểu tượng dấu ba chấm (`...`) ở góc trên bên phải và chọn **Get payload for Messenger Ads**.

![Facebook Ads Flow Menu Get Payload](https://mintcdn.com/chatbotx/2O8c-D8d1rpQb90S/images/facebook_ads_flow_menu_get_payload.png?fit=max\&auto=format\&n=2O8c-D8d1rpQb90S\&q=85\&s=b6bd9549393752598222ecb234a6d0c1)

**2. Sao chép Payload ID**

Cửa sổ **Get payload for Messenger Ads** xuất hiện hiển thị chuỗi mã định danh của kịch bản. Nhấn nút **Copy** để lưu mã vào bộ nhớ tạm.

![Facebook Ads Flow Modal Copy Payload](https://mintcdn.com/chatbotx/2O8c-D8d1rpQb90S/images/facebook_ads_flow_modal_copy_payload.png?fit=max\&auto=format\&n=2O8c-D8d1rpQb90S\&q=85\&s=bd29f80aba1319effeeadf571a58b50f)

**3. Mở trình tạo mẫu tin nhắn trên Meta**

Tại mục Conversations trong Trình quản lý quảng cáo Meta, nhấn nút **+ Create template**.

![Facebook Ads Meta Create Template Button](https://mintcdn.com/chatbotx/2O8c-D8d1rpQb90S/images/facebook_ads_meta_create_template_button.png?fit=max\&auto=format\&n=2O8c-D8d1rpQb90S\&q=85\&s=b18de599677fbc6ba51ded018a1c69f7)

**4. Chọn mẫu Bắt chuyện**

Trong cửa sổ **Select a template**, chọn tùy chọn **Start conversations** (*Suggest prompts for people to tap to encourage them to start conversations with your business*) và nhấn **Next >**.

![Facebook Ads Meta Template Select Start Conversations](https://mintcdn.com/chatbotx/2O8c-D8d1rpQb90S/images/facebook_ads_meta_template_select_start_conversations.png?fit=max\&auto=format\&n=2O8c-D8d1rpQb90S\&q=85\&s=0f59237b3521066768562dd119b517f5)

**5. Cấu hình nút bấm gửi yêu cầu đăng lại**

Tại mục **Customer actions (Hành động của khách hàng)**, chuyển định dạng sang **Buttons (Nút bấm)**.

Tại cấu hình nút bấm:

* Nhập tiêu đề hiển thị cho nút bấm.
* Tại mục **Action (Hành động)**, chọn **Send a postback (Gửi yêu cầu đăng lại)**.
* Tại ô **Bot payload**, dán chuỗi mã Payload ID đã sao chép từ ChatbotX vào.

![Facebook Ads Meta Button Send Postback Payload](https://mintcdn.com/chatbotx/2O8c-D8d1rpQb90S/images/facebook_ads_meta_button_send_postback_payload.png?fit=max\&auto=format\&n=2O8c-D8d1rpQb90S\&q=85\&s=911df35c2d026b682937e33de05fd0f1)

Kiểm tra lại giao diện tin nhắn trên khung xem trước và nhấn **Save** để lưu lại mẫu tin nhắn.

## So sánh các phương thức kết nối

Mỗi phương thức đều có ưu điểm riêng tùy thuộc vào mục đích sử dụng và thói quen vận hành của đội ngũ quảng cáo:

| Tiêu chí | Ứng dụng đối tác ChatConnectX | Dán mã JSON trực tiếp | Gắn Postback Payload ID |
| - | - | - | - |
| **Độ phức tạp thao tác** | Cực kỳ đơn giản, chỉ cần chọn mẫu | Trung bình, cần sao chép và dán mã | Trung bình, cần tạo nút và dán mã |
| **Tốc độ triển khai** | Nhanh nhất (tự động đồng bộ khi Publish) | Nhanh | Trung bình |
| **Khả năng sai sót cú pháp** | Không có rủi ro lỗi cú pháp | Cần lưu ý không chỉnh sửa sai cấu trúc | Không có rủi ro lỗi cú pháp |
| **Tùy biến giao diện trên Meta** | Cố định theo thiết kế khối đầu trong Flow | Cố định theo mã JSON xuất ra | Tự do tùy biến lời chào và câu hỏi trên Meta |
| **Chia sẻ giữa các tài khoản** | Giới hạn trong tài khoản kết nối | Linh hoạt, dùng được cho mọi tài khoản quảng cáo | Linh hoạt, dùng được cho mọi tài khoản quảng cáo |

## Kinh nghiệm tối ưu chuyển đổi và chi phí quảng cáo

Để đạt hiệu quả chuyển đổi cao nhất khi triển khai quảng cáo nhấp để nhắn tin, bạn nên áp dụng các lưu ý thực tiễn sau:

### Tối ưu lời kêu gọi hành động trên nút bấm đầu tiên

Khách hàng nhấp vào quảng cáo thường kỳ vọng nhận được phản hồi ngay lập tức. Hãy đặt nhãn nút bấm rõ ràng, kích thích hành động cụ thể như nhận ưu đãi, xem bảng giá hoặc nhận tư vấn miễn phí thay vì các từ ngữ chung chung.

### Tuân thủ quy tắc khung 24 giờ của Meta

Meta áp dụng chính sách khung giờ hội thoại 24 giờ tiêu chuẩn cho tin nhắn dịch vụ khách hàng. Khi người dùng bấm vào nút quảng cáo trên Messenger, sự kiện tương tác đó sẽ chính thức mở ra khung 24 giờ để bot gửi tin nhắn chăm sóc tự động hoàn toàn miễn phí.

### Theo dõi nguồn chuyển đổi với thuộc tính tùy chỉnh

Trong các bước tiếp theo của kịch bản ChatbotX, bạn có thể bổ sung hành động **Add Tag** (Gắn thẻ) hoặc **Set Custom Field** (Gán thuộc tính) để đánh dấu chính xác chiến dịch quảng cáo mà khách hàng vừa tương tác. Điều này giúp bộ phận bán hàng nắm bắt đúng nhu cầu và hỗ trợ đo lường hiệu quả từng nhóm quảng cáo.

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

> [accordion] Sau khi bấm Publish trên ChatbotX thì bao lâu mẫu tin nhắn xuất hiện trên Meta?
>
> Mẫu tin nhắn sẽ xuất hiện gần như ngay lập tức trong mục Saved templates của ứng dụng đối tác ChatConnectX trên Trình quản lý quảng cáo Meta. Nếu chưa thấy, bạn chỉ cần tải lại trang trình duyệt Meta Ads Manager.

> [accordion] Tại sao khách bấm vào quảng cáo nhưng bot chưa chạy các bước tiếp theo?
>
> Đây là cơ chế tiêu chuẩn của Meta nhằm tránh gửi tin nhắn rác. Khi khách hàng bấm vào bài quảng cáo, họ mới chỉ nhìn thấy tin nhắn mở đầu kèm nút bấm. Kịch bản các bước phía sau chỉ được kích hoạt khi khách hàng chủ động bấm vào một nút bấm hoặc gõ tin nhắn phản hồi.

> [accordion] Khi chỉnh sửa các khối tin nhắn phía sau trong kịch bản thì có cần cập nhật lại quảng cáo không?
>
> Không. Bạn chỉ cần cập nhật lại mã JSON hoặc chọn lại mẫu khi có sự thay đổi ở khối tin nhắn mở đầu tiên. Tất cả các khối phía sau sẽ tự động cập nhật theo kịch bản mới nhất trên ChatbotX mỗi khi bạn nhấn Publish.

> [accordion] Có thể dùng một kịch bản Ads JSON cho nhiều bài quảng cáo khác nhau không?
>
> Hoàn toàn được. Bạn có thể chọn cùng một mẫu tin nhắn ChatConnectX hoặc dán cùng một đoạn mã JSON cho nhiều chiến dịch, nhóm quảng cáo hoặc bài viết quảng cáo khác nhau trong cùng một Trang Facebook.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.