Variables – Biến trong Chat Flow

Variables – Biến trong Chat Flow

Biến (Variables) là thành phần quan trọng trong Chat Flow, giúp lưu trữ dữ liệu và tạo ra các nhánh logic linh hoạt. Nhờ biến, chatbot có thể ghi nhớ thông tin người dùng, phản hồi theo ngữ cảnh và vận hành những luồng hội thoại phức tạp.

Biến được chia làm hai loại:

1. Local Variables (Biến cục bộ)

• Chỉ tồn tại trong một phiên trò chuyện (thread)

• Bị xóa khi phiên chat kết thúc

• Thường dùng để lưu dữ liệu tạm thời như email, số điện thoại, lựa chọn,…

2. Global Variables (Biến toàn cục)

• Gắn liền với người dùng, tồn tại xuyên suốt nhiều phiên chat

• Dùng để lưu thông tin dài hạn như tên khách hàng, trạng thái đăng ký, phân loại khách,…

Việc lựa chọn loại biến phù hợp sẽ giúp flow hoạt động đúng và chính xác hơn.

Danh sách Biến Hệ Thống (Built-in Variables)

ChatBox AI Muathemewpgiare cung cấp một số biến hệ thống có sẵn, giúp bạn lấy thông tin ngẫu nhiên, thời gian, hoặc dữ liệu từ các nền tảng tích hợp.

Dưới đây là toàn bộ biến đang được hỗ trợ:

1. {randomString}

• Sinh chuỗi ký tự ngẫu nhiên

• Ví dụ: zsufQUm5KVPj

• Dùng để tạo ID tạm hoặc mã xác nhận

2. {randomGUID}

• Sinh mã GUID ngẫu nhiên

• Ví dụ: ae5cc26e-0798-43b3-b0fc-d0758aea249b

• Phù hợp để tạo mã thread, mã giao dịch,…

3. {timestamp}

• Thời gian hiện tại (số giây từ epoch)

• Ví dụ: 1760987019

4. {timestampMS}

• Timestamp tính bằng miligiây

• Ví dụ: 1760987018548

• Dùng trong các API cần độ chính xác cao

5. {timezone}

• Múi giờ của khách truy cập

• Chỉ hỗ trợ trong Live Chat Widget

• Ví dụ: Europe/Warsaw

6. {dateTime}

• Thời gian hiện tại theo chuẩn ISO8601

• Ví dụ: 2025-10-20T22:03:39+03:00

7. {date}

• Ngày hiện tại

• Ví dụ: Oct 20 2025

8. {time24H}

• Giờ theo định dạng 24h

• Ví dụ: 22:03

9. {time12H}

• Giờ theo định dạng 12h

• Ví dụ: 10:03 PM

10. {randomNumber}

• Số ngẫu nhiên trong khoảng 0 → 9.999.999.999

• Ví dụ: 9658979602

• Dùng để tạo OTP hoặc mã tracking

11. {location}

• URL mà khách đang truy cập

• Chỉ áp dụng cho Live Chat Widget

• Ví dụ: https://mywebsite.com/

12. {tgUsername}

• Username Telegram của người dùng

• Chỉ áp dụng cho kênh Telegram

• Ví dụ: @mytgusername

13. {tgId}

• Telegram User ID

• Chỉ áp dụng cho Telegram

• Ví dụ: 726721923

14. {threadGUID}

• GUID đại diện cho phiên chat hiện tại

• Ví dụ: d56b6cd7-5079-43b0-b587-87a1af89e8df

15. {waPhoneNumber}

• Số điện thoại WhatsApp của khách

• Chỉ áp dụng cho WhatsApp

• Ví dụ: +1234567890

16. {isGroupChat}

• Xác định cuộc trò chuyện có phải group hay không

• Giá trị: 1 hoặc 0

17. {incomingMessage}

• Nội dung tin nhắn mà khách vừa gửi

• Dùng để phân tích, chuyển hướng, hoặc gửi vào AI

Ứng dụng thực tế của Variables

Tóm tắt lợi ích của việc sử dụng biến

• Lưu trữ dữ liệu người dùng trong quá trình chat

• Tạo luồng hội thoại thông minh và phân nhánh linh hoạt

• Giúp chatbot hiểu người dùng hơn và đưa ra phản hồi phù hợp

• Cho phép chạy logic phức tạp dựa trên thời gian, nền tảng hoặc thông tin kỹ thuật

• Kết nối dễ dàng với API, CRM, Google Sheets,…