Hướng dẫn chuyển tiếp khách hàng từ Form vào Messenger Bot và truyền dữ liệu bằng Attribute trên Smax.AI

1. Tổng quan giải pháp

Sau khi khách hàng hoàn tất biểu mẫu trên Landing Page, thay vì chỉ chuyển họ đến một trang cảm ơn thông thường, chúng ta có thể chuyển khách hàng trực tiếp vào Messenger Bot.

Điểm đặc biệt của giải pháp này là các thông tin khách hàng vừa nhập trong form như:

• Họ và tên
• Số điện thoại
• Email
• Sản phẩm quan tâm

sẽ được đính kèm trong tham số ref của đường dẫn Messenger.

Smax.AI nhận dữ liệu từ tham số ref, lưu vào các Attribute tương ứng và sử dụng ngay bên trong kịch bản chatbot.

Cú pháp mẫu:

text
https://m.me/<page_id>?ref=thank-you-landing|hoten:{{name}}|dienthoai:{{phone}}|mail:{{email}}|sanpham:{{sanpham}}

Giải pháp này có thể áp dụng cho:

• LadiPage
• Webcake
• Form trên WordPress
• Elementor Form
• Contact Form
• Fluent Forms
• WPForms
• Form HTML tự viết
• Website được tạo bằng Vibe Coding
• React, Vue, Next.js hoặc các nền tảng website tùy biến

---

2. Luồng hoạt động

Toàn bộ quá trình diễn ra theo thứ tự:

text
Khách hàng điền Form
        ↓
Dữ liệu được lưu vào Landing Page hoặc CRM
        ↓
Website tạo đường dẫn Messenger có chứa dữ liệu Form
        ↓
Khách hàng được chuyển sang Messenger
        ↓
Trigger Ref Link trên Smax.AI được kích hoạt
        ↓
Dữ liệu trong ref được lưu vào Attribute
        ↓
Bot gửi tin nhắn xác nhận
        ↓
Gửi Dataset Event, email, kết bạn Zalo hoặc chạy các luồng chăm sóc khác

Ví dụ khách hàng điền:

text
Họ tên: Nguyễn Văn An
Điện thoại: 0985123456
Email: an@gmail.com
Sản phẩm: Khóa học Smax.AI

Đường dẫn được tạo ra sẽ có dạng:

text
https://m.me/<page_id>?ref=thank-you-landing|hoten:Nguyễn Văn An|dienthoai:0985123456|mail:an@gmail.com|sanpham:Khóa học Smax.AI

Khi khách hàng mở đường dẫn, Smax.AI sẽ nhận được:

text
{{hoten}} = Nguyễn Văn An
{{dienthoai}} = 0985123456
{{mail}} = an@gmail.com
{{sanpham}} = Khóa học Smax.AI

---

3. Phân tích cấu trúc đường dẫn Ref Link

Đường dẫn đầy đủ:

text
https://m.me/<page_id>?ref=thank-you-landing|hoten:{{name}}|dienthoai:{{phone}}|mail:{{email}}|sanpham:{{sanpham}}

3.1. Page ID

text
<page_id>

Đây là ID của Facebook Page được kết nối với Smax.AI.

Khi triển khai cho Page khác, cần thay Page ID này bằng Page ID tương ứng.

Cấu trúc chung:

text
https://m.me/FACEBOOK_PAGE_ID

3.2. Tên Ref Link

text
thank-you-landing

Đây là tên dùng để nhận diện Trigger trên Smax.AI.

Tên này phải trùng với tên được khai báo trong Trigger Ref Link.

Ví dụ:

text
ref=thank-you-landing

Trong đó:

• ref= là tham số Messenger Referral.
• thank-you-landing là tên trigger.
• Dấu | dùng để phân cách trigger và các attribute.

3.3. Các Attribute

Mỗi attribute được truyền theo cấu trúc:

text
ten_attribute:gia_tri

Nhiều attribute được phân cách bằng dấu |.

Ví dụ:

text
|hoten:{{name}}
|dienthoai:{{phone}}
|mail:{{email}}
|sanpham:{{sanpham}}

Bảng đối chiếu:

Tên biến của Form có thể khác nhau tùy nền tảng.

Ví dụ một nền tảng có thể sử dụng:

text
{{name}}

Nền tảng khác có thể sử dụng:

text
{{full_name}}

hoặc:

text
{{ho_ten}}

Điều quan trọng là phần bên trái dấu : phải đúng với Attribute trên Smax.AI, còn phần bên phải là giá trị lấy từ Form.

---

4. Tạo Trigger Ref Link trên Smax.AI

Bước 1: Tạo kịch bản Bot Auto

Truy cập khu vực quản lý kịch bản Bot Auto của Smax.AI và tạo một kịch bản mới cho Facebook Messenger.

Có thể đặt tên:

text
Chuyển tiếp từ Landing Page vào Bot

Bước 2: Thêm Trigger Ref Link

Chọn trigger dành cho Messenger Ref Link.

Thiết lập:

text
Tên Ref: thank-you-landing

Tên này phải trùng với phần đầu tiên của tham số ref:

text
ref=thank-you-landing

Bước 3: Khai báo Attribute

Thêm các Attribute cần nhận từ Form:

Sau khi trigger được kích hoạt, các giá trị nhận được sẽ có thể sử dụng trong toàn bộ kịch bản dưới dạng:

text
{{hoten}}
{{dienthoai}}
{{mail}}
{{sanpham}}

Bước 4: Kết nối Trigger với Block xử lý

Kết nối Trigger Thank-you-landing vào một Block mới, ví dụ:

text
Thank you link

Block này sẽ chịu trách nhiệm:

• Xác nhận thông tin khách hàng.
• Gửi sự kiện chuyển đổi.
• Gửi email.
• Kết bạn Zalo.
• Chuyển sang luồng tư vấn sản phẩm.

---

5. Gửi tin nhắn xác nhận thông tin

Trong Block xử lý, thêm thẻ Messenger Text với nội dung:

text
Cảm ơn bạn đã đăng ký.

Chúng tôi đã nhận được đăng ký của bạn với thông tin:

- Họ tên: {{hoten}}
- Điện thoại: {{dienthoai}}
- Email: {{mail}}
- Sản phẩm: {{sanpham}}

Đội ngũ tư vấn sẽ liên hệ và hỗ trợ bạn trong thời gian sớm nhất.

Khi chạy thực tế, khách hàng sẽ nhận được:

text
Cảm ơn bạn đã đăng ký.

Chúng tôi đã nhận được đăng ký của bạn với thông tin:

- Họ tên: Nguyễn Văn An
- Điện thoại: 0985123456
- Email: an@gmail.com
- Sản phẩm: Khóa học Smax.AI

Việc gửi lại thông tin giúp khách hàng kiểm tra đăng ký, đồng thời xác nhận dữ liệu đã được truyền thành công từ Form vào Bot.

---

6. Gửi Messenger Dataset Event

Sau tin nhắn xác nhận, có thể thêm thẻ Messenger Dataset Event để ghi nhận sự kiện chuyển đổi.

Cấu hình tham khảo:

text
Tên sự kiện: LeadSubmitted
Đơn vị tiền tệ: VND
Content Type: product
Phone: {{dienthoai}}
Email: {{mail}}

Mục đích của bước này là gửi thông tin lead vào Dataset, hỗ trợ đo lường và tối ưu các chiến dịch quảng cáo Messenger.

Có thể thay đổi tên sự kiện theo mục tiêu thực tế, chẳng hạn:

text
LeadSubmitted
CompleteRegistration
Contact
Schedule
Purchase

Tên sự kiện nên được thống nhất giữa đội vận hành chatbot và đội quảng cáo.

---

7. Gửi email xác nhận tự động

Nếu khách hàng có nhập email, có thể thêm thẻ Send Email.

Thiết lập người nhận:

text
Gửi theo Attribute: mail

Tiêu đề email:

text
Xác nhận đăng ký tham gia chương trình

Nội dung email:

html
<p>Chào bạn {{hoten}},</p>

<p>Chúng tôi đã nhận được đăng ký của bạn với thông tin:</p>

<p>
- Họ tên: {{hoten}}<br>
- Điện thoại: {{dienthoai}}<br>
- Email: {{mail}}<br>
- Sản phẩm: {{sanpham}}
</p>

<p>Đội ngũ tư vấn sẽ liên hệ và hỗ trợ bạn trong thời gian sớm nhất.</p>

<p>
Nếu cần hỗ trợ thêm, bạn có thể liên hệ với chúng tôi qua Zalo hoặc hotline.
</p>

Có thể tiếp tục sử dụng email để:

• Gửi tài liệu.
• Gửi vé tham dự.
• Gửi thông tin Zoom.
• Gửi mã ưu đãi.
• Gửi hướng dẫn thanh toán.
• Gửi thông tin sản phẩm.

---

8. Tìm và kết bạn Zalo bằng số điện thoại

Template có thể mở rộng bằng thẻ Find/Add ZaloUser.

Thiết lập số điện thoại tìm kiếm:

text
{{dienthoai}}

Lời nhắn kết bạn mẫu:

text
Xin chào anh/chị {{hoten}}.

Em là nhân viên hỗ trợ của [Tên doanh nghiệp]. Em nhận được thông tin anh/chị đang quan tâm đến {{sanpham}}.

Em xin phép kết bạn Zalo để gửi thông tin và hỗ trợ anh/chị thuận tiện hơn.

Tùy nhu cầu, có thể bật thêm:

• Tạo khách hàng mới nếu chưa tồn tại.
• Gửi lời mời kết bạn.
• Lưu Zalo User ID.
• Lưu tên Zalo.
• Lưu ảnh đại diện Zalo.
• Mời khách hàng vào nhóm Zalo.
• Chuyển đến Block khi tìm thấy hoặc không tìm thấy tài khoản.

---

9. Cài đặt chuyển hướng trên Landing Page

Nguyên tắc triển khai là:

1. Khách hàng nhấn nút gửi Form.
2. Hệ thống lưu dữ liệu Form thành công.
3. Website tạo đường dẫn Messenger có chứa dữ liệu.
4. Website chuyển khách hàng sang đường dẫn đó.

Không nên chuyển khách hàng sang Messenger trước khi dữ liệu Form được lưu thành công.

Cú pháp redirect mẫu

text
https://m.me/<page_id>?ref=thank-you-landing|hoten:{{name}}|dienthoai:{{phone}}|mail:{{email}}|sanpham:{{sanpham}}

Cần thay:

• <page_id> bằng Page ID thực tế.
• {{name}} bằng biến họ tên của Form.
• {{phone}} bằng biến số điện thoại.
• {{email}} bằng biến email.
• {{sanpham}} bằng biến sản phẩm.

---

10. Áp dụng trên LadiPage và Webcake

Đối với LadiPage hoặc Webcake, có hai phương án triển khai.

Phương án 1: Redirect trực tiếp bằng biến Form

Nếu nền tảng hỗ trợ chèn biến Form vào đường dẫn chuyển hướng, thiết lập hành động sau khi gửi Form thành công là mở URL:

text
https://m.me/<page_id>?ref=thank-you-landing|hoten:{{name}}|dienthoai:{{phone}}|mail:{{email}}|sanpham:{{sanpham}}

Tên biến phải được thay bằng đúng cú pháp mà nền tảng cung cấp.

Phương án 2: Chuyển đến trang cảm ơn trung gian

Nếu nền tảng không hỗ trợ tạo URL động trực tiếp:

1. Gửi Form thành công.
2. Chuyển khách hàng đến một trang cảm ơn trung gian.
3. Truyền dữ liệu sang trang cảm ơn bằng query string hoặc lưu tạm vào trình duyệt.
4. Tại trang cảm ơn, tạo nút "Nhận tư vấn qua Messenger".
5. Nút này mở đường dẫn m.me có chứa dữ liệu khách hàng.

Phương án trang trung gian thường dễ kiểm soát hơn, đồng thời có thể hiển thị thêm:

• Thông báo đăng ký thành công.
• Video hướng dẫn.
• Nút vào Messenger.
• Nút kết bạn Zalo.
• Nút tham gia nhóm.
• Mã ưu đãi.

---

11. Áp dụng cho Form WordPress

Với WordPress, cần thực hiện chuyển hướng sau khi plugin Form xác nhận gửi dữ liệu thành công.

Tùy plugin, có thể sử dụng một trong các cách:

• Redirect URL có hỗ trợ biến trường.
• Webhook gửi dữ liệu rồi redirect.
• JavaScript bắt sự kiện gửi Form thành công.
• Chuyển đến trang cảm ơn và tạo URL Messenger tại đó.

Quy trình đề xuất:

text
WordPress Form
    ↓
Lưu lead vào WordPress, Google Sheets hoặc CRM
    ↓
Xác nhận gửi Form thành công
    ↓
Tạo Messenger Ref Link
    ↓
Chuyển khách hàng sang Messenger

Không nên chỉ bắt sự kiện nhấn nút Submit vì Form có thể bị lỗi validation hoặc chưa lưu dữ liệu thành công.

---

12. Mã JavaScript dùng cho Form tùy biến và Vibe Coding

Đối với website tự viết, có thể sử dụng hàm sau để tạo đường dẫn Messenger:

javascript
function buildMessengerRefUrl(lead) {
    const pageId = '104200148333501';

    const refPayload = [
        'thank-you-landing',
        `hoten:${lead.name || ''}`,
        `dienthoai:${lead.phone || ''}`,
        `mail:${lead.email || ''}`,
        `sanpham:${lead.product || ''}`
    ].join('|');

    const messengerUrl = new URL(`https://m.me/${pageId}`);
    messengerUrl.searchParams.set('ref', refPayload);

    return messengerUrl.toString();
}

Ví dụ sử dụng sau khi API lưu Form thành công:

javascript
async function submitLead(formData) {
    try {
        const response = await fetch('/api/leads', {
            method: 'POST',
            headers: {
                'Content-Type': 'application/json'
            },
            body: JSON.stringify(formData)
        });

        if (!response.ok) {
            throw new Error('Không thể lưu thông tin đăng ký');
        }

        const messengerUrl = buildMessengerRefUrl({
            name: formData.name,
            phone: formData.phone,
            email: formData.email,
            product: formData.sanpham
        });

        window.location.assign(messengerUrl);
    } catch (error) {
        console.error(error);
        alert('Đã xảy ra lỗi. Vui lòng kiểm tra thông tin và thử lại.');
    }
}

Cách này phù hợp với:

• HTML và JavaScript thuần.
• React.
• Vue.
• Next.js.
• Nuxt.
• Website được tạo bằng AI hoặc Vibe Coding.
• Form kết nối n8n.
• Form gửi dữ liệu về API riêng.

Việc sử dụng URL và searchParams giúp trình duyệt xử lý khoảng trắng, dấu tiếng Việt và các ký tự đặc biệt trong dữ liệu.

---

13. Kiểm tra kịch bản trước khi sử dụng

Nên thực hiện kiểm tra theo từng bước.

Kiểm tra 1: Trigger cơ bản

Mở:

text
https://m.me/<page_id>?ref=thank-you-landing

Kiểm tra xem Block Thank you link có chạy hay không.

Kiểm tra 2: Truyền một Attribute

text
https://m.me/<page_id>?ref=thank-you-landing|hoten:Nguyen Van An

Trong tin nhắn Bot, kiểm tra:

text
{{hoten}}

có hiển thị đúng hay không.

Kiểm tra 3: Truyền đầy đủ dữ liệu

text
https://m.me/<page_id>?ref=thank-you-landing|hoten:Nguyen Van An|dienthoai:0985123456|mail:an@gmail.com|sanpham:Khoa hoc SmaxAI

Kiểm tra lần lượt:

• Tin nhắn Messenger.
• Attribute khách hàng.
• Dataset Event.
• Email xác nhận.
• Tính năng tìm Zalo.
• Dữ liệu lưu trong CRM.

Kiểm tra 4: Dữ liệu có dấu tiếng Việt

Kiểm tra họ tên và tên sản phẩm có dấu:

text
Nguyễn Thị Thanh Hằng
Khóa học Chăm sóc khách hàng

Đường dẫn nên được tạo bằng JavaScript hoặc được URL encode để tránh lỗi ký tự.

Kiểm tra 5: Dữ liệu trống

Thử bỏ trống email hoặc sản phẩm và kiểm tra Bot có hiển thị nội dung không phù hợp hay không.

Có thể thêm điều kiện:

text
Nếu {{mail}} có dữ liệu
→ Gửi email

Nếu {{mail}} trống
→ Bỏ qua bước gửi email

Tương tự:

text
Nếu {{dienthoai}} có dữ liệu
→ Tìm và kết bạn Zalo

---

14. Các lỗi thường gặp

Trigger không chạy

Kiểm tra:

• Page ID có đúng không.
• Facebook Page đã kết nối đúng với Smax.AI chưa.
• Trigger đã được bật chưa.
• Tên ref có đúng thank-you-landing không.
• Kịch bản có đang hoạt động không.

Attribute không nhận được giá trị

Kiểm tra:

• Tên attribute trong đường dẫn.
• Tên attribute được khai báo trong Trigger.
• Dấu phân cách |.
• Dấu phân cách giữa tên và giá trị :.
• Biến Form đã được thay thành dữ liệu thật chưa.

Ví dụ sai:

text
hoten={{name}}

Cú pháp cần dùng:

text
hoten:{{name}}

Bot hiển thị nguyên {{name}}

Điều này cho thấy nền tảng Landing Page chưa thay biến bằng dữ liệu thực.

Ví dụ link đang được mở:

text
hoten:{{name}}

thay vì:

text
hoten:Nguyễn Văn An

Cần kiểm tra lại cú pháp biến động của Form hoặc sử dụng JavaScript để lấy trực tiếp giá trị trường.

Dữ liệu bị lỗi dấu hoặc ký tự đặc biệt

Nên tạo đường dẫn bằng:

javascript
new URL()

và:

javascript
url.searchParams.set()

Không nên nối trực tiếp dữ liệu chưa xử lý vào URL khi họ tên hoặc sản phẩm có dấu, ký tự &, |, :, ? hoặc #.

Form chưa lưu nhưng đã chuyển sang Messenger

Chỉ thực hiện redirect trong sự kiện gửi Form thành công hoặc sau khi API trả về kết quả thành công.

---

15. Lưu ý về dữ liệu cá nhân

Khi truyền họ tên, số điện thoại và email trong URL, dữ liệu có thể xuất hiện trong:

• Lịch sử trình duyệt.
• Nhật ký máy chủ.
• Công cụ đo lường.
• Hệ thống thống kê đường dẫn.
• Ảnh chụp màn hình hoặc đường dẫn được chia sẻ lại.

Vì vậy, phương án truyền trực tiếp phù hợp với các luồng đơn giản và dữ liệu không quá nhạy cảm.

Đối với hệ thống cần bảo mật cao, nên truyền một mã định danh:

text
https://m.me/<page_id>?ref=thank-you-landing|lead_id:LD202607220001

Sau đó Bot hoặc hệ thống tự động hóa dùng lead_id để lấy thông tin khách hàng từ CRM, n8n hoặc API nội bộ.

Phương án này giúp hạn chế đưa số điện thoại và email trực tiếp vào URL.

---

16. Khả năng mở rộng

Sau khi khách hàng được chuyển từ Form vào Bot, có thể tiếp tục triển khai:

• Gắn nhãn theo sản phẩm.
• Phân loại nguồn Landing Page.
• Lưu mã chiến dịch quảng cáo.
• Chuyển lead cho nhân viên phụ trách.
• Gửi thông báo vào nhóm nội bộ.
• Gửi dữ liệu sang Google Sheets.
• Tạo cơ hội bán hàng trong CRM.
• Gửi email xác nhận.
• Kết bạn Zalo cá nhân.
• Mời khách hàng vào nhóm Zalo.
• Gửi mã giảm giá.
• Gửi tài liệu tự động.
• Đặt lịch tư vấn.
• Kích hoạt chuỗi chăm sóc theo sản phẩm.

Có thể bổ sung thêm các attribute:

text
|nguon:ladipage
|chien_dich:summer2026
|utm_source:facebook
|utm_campaign:lead_form
|nhanvien:ngocphuc

Ví dụ:

text
https://m.me/<page_id>?ref=thank-you-landing|hoten:{{name}}|dienthoai:{{phone}}|mail:{{email}}|sanpham:{{sanpham}}|nguon:ladipage|chien_dich:summer2026

---

17. Kết luận

Trigger Ref Link có gắn Attribute là một phương pháp hiệu quả để kết nối Form trên Landing Page với Messenger Bot của Smax.AI.

Thay vì để khách hàng hoàn tất Form rồi kết thúc hành trình, doanh nghiệp có thể chuyển họ ngay vào Messenger, đồng thời đưa toàn bộ thông tin vừa đăng ký vào kịch bản chatbot.

Từ dữ liệu này, Smax.AI có thể tiếp tục:

• Xác nhận thông tin đăng ký.
• Cá nhân hóa nội dung Messenger.
• Gửi sự kiện chuyển đổi.
• Gửi email.
• Tìm và kết bạn Zalo.
• Phân loại khách hàng.
• Kích hoạt quy trình chăm sóc tự động.

Cú pháp cốt lõi:

text
https://m.me/FACEBOOK_PAGE_ID?ref=TEN_TRIGGER|ATTRIBUTE_1:GIA_TRI_1|ATTRIBUTE_2:GIA_TRI_2

Cú pháp áp dụng cho template:

text
https://m.me/<page_id>?ref=thank-you-landing|hoten:{{name}}|dienthoai:{{phone}}|mail:{{email}}|sanpham:{{sanpham}}

Đây là giải pháp phù hợp cho LadiPage, Webcake, WordPress và các website được xây dựng bằng Vibe Coding, giúp tạo một hành trình liền mạch từ Landing Page đến Messenger và các kênh chăm sóc khách hàng khác.

\