Tiện ích Chat #

Hướng dẫn tích hợp Tiện ích Chat trên Website #

Thêm một tiện ích chat thân thiện với người dùng vào trang web của bạn, cho phép khách truy cập giao tiếp trực tiếp thông qua giao diện trang web. Quy trình tích hợp rất đơn giản và sẽ cung cấp cho trang web của bạn các tính năng nhắn tin được tích hợp sẵn.

Tạo và Cấu hình Tiện ích Trò chuyện #

Cách truy cập:

1. Nhấp vào Settings (Cài đặt) gần cuối thanh bên trái. (Trên điện thoại, trước tiên hãy nhấn vào biểu tượng menu ☰ ở góc trên cùng để mở thanh bên.)
2. Trong thanh điều hướng bên trái của phần Cài đặt, dưới mục Channels (Kênh), nhấp vào Channels.
3. Tìm thẻ Website chat widget (Tiện ích trò chuyện trên trang web).
4. Nếu bạn chưa có tiện ích, hãy nhấp vào Connect (Kết nối) để tạo một tiện ích với tên hiển thị và tin nhắn chào mừng.
5. Sau khi tạo, bạn có thể nhấp vào Manage (Quản lý) bất cứ lúc nào để mở bảng cấu hình đầy đủ.

Các thay đổi bạn lưu sẽ tự động áp dụng cho tiện ích trực tuyến của bạn — không cần phải dán lại mã cài đặt sau khi thực hiện thay đổi.

Một Bản xem trước trực tiếp nằm ngay cạnh các cài đặt: một trang web mẫu với tiện ích thực tế của bạn đang chạy trên đó, hiển thị màu sắc, vị trí, logo, biểu tượng trình khởi chạy và cửa sổ bật lên chủ động chính xác như cách khách truy cập sẽ thấy. Nó theo dõi các chỉnh sửa của bạn khi bạn thực hiện, vì vậy bạn không cần phải lưu để xem thay đổi màu sắc hoặc chủ đề trông như thế nào. Bạn thậm chí có thể nhấp vào nút trò chuyện bên trong bản xem trước để mở tiện ích và dùng thử.

Những gì bạn có thể tùy chỉnh #

Bảng Quản lý được chia thành bốn phần.

Giao diện #

• Chủ đề kiểu dáng: Thay đổi kiểu dáng toàn bộ widget chỉ với một cú nhấp chuột. Sáu chủ đề, mỗi chủ đề thiết lập giao diện, màu sắc, góc bo và phông chữ cùng nhau: Classic (giao diện khối nguyên bản — thanh tiêu đề có màu trên bảng phẳng), Glass (bảng mờ, trong suốt làm nhòe nhẹ trang phía sau, với tiêu đề và hộp tin nhắn nổi như các thẻ bo tròn bên trong), Midnight (Glass với tông màu tối), Bloom (hồng nhạt, bo tròn hơn), Ember (Glass tông cam ấm) và Mono (đen trắng, góc nhọn). Một chủ đề là điểm khởi đầu — sau khi chọn, bạn vẫn có thể thay đổi bất kỳ màu sắc hoặc tùy chỉnh nào một cách riêng biệt. Các widget mới bắt đầu với Glass; việc chuyển đổi diễn ra tức thì ở mọi nơi widget được nhúng mà không cần thay đổi mã trên trang web của bạn.
• Góc bo và Phông chữ: Hai tùy chỉnh kiểu dáng độc lập. Góc bo thiết lập độ bo tròn của bảng, bong bóng và nút (Tròn, Mềm hoặc Sắc cạnh), và Phông chữ chọn kiểu chữ mà khách truy cập nhìn thấy (Mặc định, Có chân, Bo tròn hoặc Đơn cách) — phông chữ lấy từ những gì đã có sẵn trên thiết bị của khách truy cập, vì vậy không có gì tải thêm trên trang web của bạn.
• Tên hiển thị: Được hiển thị trong tiêu đề widget.
• Logo: Tải lên một hình ảnh xuất hiện ở đầu cuộc trò chuyện. Sử dụng logo công ty hoặc ảnh đại diện thân thiện.
• Biểu tượng trình khởi chạy: Biểu tượng trên chính nút trò chuyện nổi. Chọn một trong các biểu tượng tích hợp (bong bóng trò chuyện, máy bay giấy, dấu hỏi, v.v.), sử dụng lại logo đã tải lên của bạn hoặc tải lên một hình ảnh riêng — rất tiện nếu bạn muốn dùng ảnh của một thành viên trong nhóm để chào đón khách truy cập.
• Màu sắc: Năm màu, mỗi màu đặt tên cho phần của widget mà nó tô điểm. Màu thương hiệu là nút nổi, tiêu đề và tin nhắn của chính khách truy cập, với Văn bản thương hiệu cho văn bản nằm trên đó. Bong bóng bot là nền cho các câu trả lời của bot và chỉ báo đang nhập, với Văn bản bong bóng bot cho các từ bên trong chúng và các dấu chấm đang nhập hoạt hình. Cửa sổ trò chuyện là bảng phía sau tất cả các tin nhắn. Hãy chọn màu Bong bóng bot khác biệt rõ ràng với Màu thương hiệu của bạn — nếu hai màu này trùng nhau, cả hai phía của cuộc trò chuyện sẽ có cùng màu và khách truy cập không thể phân biệt câu trả lời của bot với tin nhắn của chính họ. Bong bóng bot màu xám nhạt với văn bản tối bên cạnh màu thương hiệu của bạn là sự kết hợp an toàn.
• Vị trí: Đặt nút trò chuyện nổi ở góc dưới bên phải hoặc dưới bên trái, với độ lệch ngang và dọc (tính bằng pixel) nếu nó chồng lên thứ gì đó khác trên trang của bạn.
• Câu hỏi gợi ý: Các gợi ý trả lời nhanh (các thẻ có thể nhấp) được hiển thị trong cuộc trò chuyện để khách truy cập có thể bắt đầu chỉ với một lần chạm thay vì phải nhập — ví dụ: “Giá của bạn là bao nhiêu?” hoặc “Bạn có hỗ trợ không?” — tối đa 10 câu.
• Dòng chân trang: Một dòng văn bản nhỏ tùy chọn của riêng bạn bên dưới hộp tin nhắn, ví dụ: “Được cung cấp bởi Agency của bạn”. Theo mặc định, nó bị tắt và không có gì hiển thị bên dưới hộp tin nhắn khi nó bị tắt. Hãy bật nó lên, nhập văn bản của bạn (tối đa 40 ký tự) và nếu muốn, hãy thêm một liên kết bắt đầu bằng https://; khách truy cập nhấp vào văn bản đó sẽ mở trang đó trong một tab mới. Các Agency sử dụng nó để đặt tên riêng của họ trên các widget mà họ xây dựng cho khách hàng.

Hành vi #

• Tin nhắn chào mừng: Tin nhắn đầu tiên khách truy cập nhìn thấy khi họ mở cửa sổ chat (ví dụ: “Tôi có thể giúp gì cho bạn?”).
• Âm thanh: Phát âm thanh khi có tin nhắn mới trong cửa sổ chat.
• Yêu cầu quyền thông báo: Tùy chọn nhắc khách truy cập cho phép thông báo trình duyệt, để họ được cảnh báo về các phản hồi ngay cả khi họ đã chuyển sang tab khác.
• Bong bóng bật lên chủ động: Một bong bóng nhỏ tùy chọn bật lên bên cạnh nút chat để mời mọi người tham gia. Bật tính năng này để thiết lập tin nhắn, văn bản nút chấp nhận/từ chối và số giây chờ trước khi nó xuất hiện. Bong bóng sẽ tự đóng sau 20 giây nếu khách truy cập không nhấp vào nó. Đây là văn bản duy nhất mà tiện ích hiển thị bên cạnh nút chat: không có cài đặt nào cho nhãn cố định bên cạnh nút này.
• Tốc độ phản hồi của AI: Một thanh trượt giữa Chậm hơn (giống con người hơn — AI mất một chút thời gian trước khi trả lời) và Tốc độ tối đa (giống robot hơn — các câu trả lời được gửi lại nhanh nhất có thể). Cân bằng nằm ở giữa. Tin nhắn đầu tiên của phản hồi sẽ đến sau độ trễ mà thanh trượt thiết lập, với chỉ báo đang nhập liệu hiển thị ngay trước đó.
• Hiển thị ghi chú bận trong khi AI đang xử lý: Mặc định là Tắt. Khi một phản hồi mất hơn vài giây, ví dụ vì tác nhân của bạn đang tra cứu thông tin trong một hệ thống khác, khách truy cập sẽ thấy một dòng ngắn bên cạnh các dấu chấm đang nhập: “Đang soạn câu trả lời” sau 5 giây, “Đang tra cứu thông tin cho bạn” sau 15 giây, sau đó là “Vẫn đang xử lý, sắp xong rồi” và lời xin lỗi vì phải chờ đợi nếu quá trình kéo dài hơn. Các phản hồi nhanh vẫn chỉ hiển thị các dấu chấm. Dòng này tuân theo ngôn ngữ của tiện ích và nó chỉ xuất hiện khi AI của bạn thực sự đang xử lý phản hồi, không bao giờ xuất hiện khi AI bị tắt cho cuộc trò chuyện đó hoặc khi một người đã tiếp quản.

Ngôn ngữ #

Tiện ích này tự động hỗ trợ đa ngôn ngữ — bạn không cần phải bật bất kỳ cài đặt nào.

• Nó tự động chọn ngôn ngữ của khách truy cập. Trước tiên, nó xem xét ngôn ngữ mà trang của bạn khai báo trong HTML (<html lang="it">), sau đó nó sẽ chuyển sang ngôn ngữ trình duyệt của khách truy cập. Nếu không có ngôn ngữ nào trong số đó được chúng tôi hỗ trợ, các nhãn của tiện ích sẽ hiển thị bằng ngôn ngữ bạn đã viết tin nhắn chào mừng, và tin nhắn chào mừng, bong bóng bật lên (popup) cũng như các câu hỏi bắt đầu sẽ xuất hiện chính xác như những gì bạn đã viết.
• Ngôn ngữ trang mâu thuẫn với lời chào của bạn sẽ không được tin cậy. Một số trình tạo trang web đặt lang="en" trên mọi trang bất kể ngôn ngữ của trang web là gì. Khi trang khai báo một ngôn ngữ và bạn viết tin nhắn chào mừng bằng một ngôn ngữ khác, tiện ích sẽ coi giá trị của trang là mặc định của trình tạo: nó sẽ tuân theo ngôn ngữ trình duyệt của khách truy cập, và nếu đó không phải là ngôn ngữ chúng tôi hỗ trợ, nó sẽ sử dụng ngôn ngữ bạn đã viết. Một trang thay đổi giá trị lang của nó khi khách truy cập chọn ngôn ngữ trên trang web của bạn sẽ luôn được tuân theo. Nếu bạn không muốn phụ thuộc vào bất kỳ điều này, hãy ghim ngôn ngữ trong phần Hành vi (Behavior).
• Hoặc tự chọn một ngôn ngữ. Trường Ngôn ngữ tiện ích trong phần Hành vi được đặt thành Tự động theo mặc định, đó là cơ chế phát hiện nêu trên. Hãy chọn một ngôn ngữ ở đó và các nhãn của tiện ích (các trường Tên, Email và Điện thoại của biểu mẫu khách truy cập cùng văn bản ví dụ của chúng, thông báo quyền riêng tư, các nút) sẽ giữ nguyên ngôn ngữ đó bất kể trang hoặc trình duyệt hiển thị gì. Hãy sử dụng tùy chọn này khi trình tạo trang web của bạn không khai báo đúng ngôn ngữ, hoặc khi bạn muốn một ngôn ngữ cố định cho mọi khách truy cập.
• Các ngôn ngữ được hỗ trợ: Tiếng Anh, tiếng Hà Lan, tiếng Đức, tiếng Pháp, tiếng Tây Ban Nha, tiếng Ý, tiếng Bồ Đào Nha, tiếng Romania, tiếng Ba Lan, tiếng Ả Rập, tiếng Phần Lan, tiếng Philippines, tiếng Slovenia, tiếng Thái, tiếng Bengal, tiếng Nhật, tiếng Na Uy (Bokmål) và tiếng Thổ Nhĩ Kỳ. Đây là danh sách cho các nút và nhãn của chính tiện ích.
• Các ngôn ngữ viết từ phải sang trái được trình bày từ phải sang trái. Đối với khách truy cập sử dụng tiếng Ả Rập, tiếng Do Thái, tiếng Ba Tư và tiếng Urdu, toàn bộ cửa sổ trò chuyện sẽ đảo ngược: tiêu đề, các bong bóng tin nhắn, các dấu chấm báo hiệu đang nhập, biểu mẫu khách truy cập và hộp tin nhắn đều bắt đầu từ bên phải. Nút bong bóng vẫn nằm ở góc bạn đã chọn. Khách truy cập sử dụng tiếng Do Thái, tiếng Ba Tư và tiếng Urdu sẽ thấy các nhãn bằng tiếng Anh (hoặc ngôn ngữ bạn đã ghim), nhưng bố cục vẫn tuân theo ngôn ngữ của họ. Một tin nhắn được viết theo hướng khác, chẳng hạn như câu trả lời bằng tiếng Anh trong cuộc trò chuyện bằng tiếng Ả Rập, vẫn được đọc theo đúng thứ tự.
• Tin nhắn của bạn được dịch cho bạn. Mỗi khi bạn lưu, tin nhắn chào mừng, bong bóng bật lên chủ động và các câu hỏi bắt đầu của bạn sẽ được dịch sang tất cả mười tám ngôn ngữ nêu trên. Bạn chỉ cần viết chúng một lần, bằng bất kỳ ngôn ngữ nào bạn thích: ngôn ngữ bạn viết sẽ được nhận diện từ chính văn bản đó, phiên bản đó được giữ nguyên từng chữ, và mọi ngôn ngữ khác sẽ là bản dịch của nó. Không quan trọng tài khoản của bạn được đặt ở ngôn ngữ nào.
• Viết phiên bản của riêng bạn cho một ngôn ngữ. Phần Bản dịch trong bảng Quản lý, ngay bên dưới phần Hành vi, cho phép bạn thay thế bản dịch tự động bằng cách diễn đạt của riêng bạn, ví dụ như tiếng Tây Ban Nha trang trọng (“usted”) trong khi bản dịch tự động là thân mật. Chọn một ngôn ngữ trong phần Ngôn ngữ, sau đó điền vào bất kỳ trường nào: Tin nhắn chào mừng, Tin nhắn bật lên, Văn bản chấp nhận và Văn bản từ chối của popup (hiển thị khi bong bóng bật lên đang hiện) và Câu hỏi bắt đầu. Mỗi trường hiển thị bản dịch tự động bằng màu xám; Bắt đầu từ bản dịch tự động sẽ sao chép nội dung đó để bạn có thể chỉnh sửa từ đó. Bất kỳ trường nào bạn để trống sẽ giữ nguyên bản dịch tự động. Các ngôn ngữ bạn tự viết sẽ được liệt kê đầu tiên, được đánh dấu là Cách diễn đạt của riêng bạn, và Xóa cách diễn đạt (ngôn ngữ) của tôi sẽ quay lại bản dịch tự động cho ngôn ngữ đó. Cách diễn đạt của riêng bạn sẽ được giữ lại khi bạn chỉnh sửa văn bản gốc sau này; chỉ các bản dịch tự động mới được thực hiện lại.
• Các nút bật lên cũng được dịch. Các nút Chấp nhận và Từ chối của bong bóng bật lên chủ động được dịch cùng với các tin nhắn khác của bạn, vì vậy khách truy cập người Tây Ban Nha sẽ không còn thấy các nút bằng tiếng Anh nữa.
• Viết mỗi tin nhắn bằng một ngôn ngữ duy nhất. Nếu bạn đặt hai ngôn ngữ vào cùng một trường — ví dụ: một dòng tiếng Anh và một dòng tiếng Ý — toàn bộ nội dung đó sẽ được coi là một tin nhắn duy nhất và được dịch nguyên trạng, vì vậy khách truy cập người Ý sẽ thấy cùng một câu hai lần. Hãy viết một lần, bằng bất kỳ ngôn ngữ nào bạn thích.
• AI trả lời bằng ngôn ngữ của khách truy cập. Dù khách truy cập gõ bằng ngôn ngữ nào, tác nhân (agent) của bạn sẽ trả lời bằng chính ngôn ngữ đó, bất kể các nhãn của tiện ích đang hiển thị bằng ngôn ngữ nào. Nếu bạn muốn nó luôn trả lời bằng một ngôn ngữ cố định, hãy chỉ định điều đó trong hướng dẫn dành cho tác nhân của bạn.
• Đặt ngôn ngữ cho mỗi trang trong mã nhúng. Bạn đang chạy một tiện ích trên trang web tiếng Anh và một bản sao đã dịch của nó? Thêm data-lang vào thẻ script của tiện ích trên mỗi trang. data-lang="es" hiển thị tiện ích bằng tiếng Tây Ban Nha trên trang đó bất kể trình duyệt hiển thị gì; data-lang="page" làm cho nó tuân theo giá trị <html lang="..."> của chính trang đó (vì vậy lang="es-MX" sẽ cho ra tiếng Tây Ban Nha), ngay cả khi tin nhắn chào mừng của bạn được viết bằng ngôn ngữ khác. Nó sẽ ưu tiên hơn trường Ngôn ngữ tiện ích (Widget language), trường này lại ưu tiên hơn tính năng phát hiện tự động. Ví dụ:

<script src="https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID" data-lang="page" defer></script>

Giữ nguyên mã nhúng từ bảng Quản lý và chỉ thêm thuộc tính data-lang. Đối với bảng trò chuyện nội dòng, hãy đặt data-lang trên <div data-chat-widget="…"> thay thế.

Mẹo: nếu trang web của bạn không đặt thuộc tính lang trên thẻ <html>, hãy thêm thuộc tính đó vào. Đây là tín hiệu mạnh nhất mà chúng tôi có để chọn đúng ngôn ngữ, đặc biệt là đối với những khách truy cập đang duyệt web từ nước ngoài.

Thu thập Khách hàng tiềm năng & Quyền riêng tư #

• Thu thập thông tin khách truy cập: Mặc định là Tắt. Khi bật, khách truy cập sẽ được yêu cầu cung cấp tên và email (và tùy chọn là số điện thoại) trước khi cuộc trò chuyện bắt đầu, để bạn nắm bắt được khách hàng tiềm năng ngay cả khi họ rời đi giữa chừng.
• Tiêu đề biểu mẫu và Phụ đề biểu mẫu: Tùy chỉnh tiêu đề và lời giải thích ngắn hiển thị phía trên biểu mẫu.
• Thu thập số điện thoại: Bật để yêu cầu thêm số điện thoại; tắt thì chỉ thu thập tên và email.
• Thu thập họ: Mặc định là Tắt. Bật để thêm trường Họ bắt buộc ngay sau trường Tên. Nó được lưu vào liên hệ dưới dạng họ của họ, vì vậy AI của bạn và bất kỳ thông tin nào nó tra cứu trong hệ thống của riêng bạn đều có đầy đủ tên từ tin nhắn đầu tiên. Những khách truy cập đã điền vào biểu mẫu trước khi bạn bật tính năng này sẽ không bị hỏi lại.
• Email trả lời chưa đọc cho khách truy cập: một khách truy cập đã để lại địa chỉ email và chưa xem phản hồi của bạn sau 15 phút sẽ nhận được email hướng họ quay lại cuộc trò chuyện. Tắt tính năng này trong Cài đặt → Thông báo → Khách truy cập tiện ích chat. Xem Email gửi cho khách truy cập tiện ích chat.

Khách truy cập đã để lại số điện thoại và rời khỏi trang web của bạn — tôi có thể tiếp tục trên WhatsApp không? Có. Hãy mở cuộc trò chuyện của họ và chọn Tiếp tục trên WhatsApp từ menu ba chấm (cần kết nối WhatsApp Web hoặc WhatsApp Business). Your AI Connector tạo một cuộc trò chuyện WhatsApp được liên kết cho cùng một người, sao chép tên, email và thông tin chi tiết của họ, đồng thời AI sẽ chuyển tiếp những gì họ đã nói trên trang web của bạn, vì vậy không ai phải lặp lại những gì đã nói. Cuộc trò chuyện trên trang web vẫn giữ nguyên và cả hai cuộc trò chuyện đều trỏ đến nhau trong phần Các cuộc trò chuyện được liên kết trong bảng điều khiển liên hệ. Xem Giao diện trò chuyện.

Một khách truy cập đã để lại email nhưng không đặt lịch — tôi có thể gửi email theo dõi không? Có, với một quy trình tự động hóa. Bước Tạo liên hệ với Kênh được đặt thành Email sẽ chuyển địa chỉ mà khách truy cập để lại thành một liên hệ email trên Kênh email đã kết nối của bạn, và bước Gửi tin nhắn ngay sau đó sẽ gửi đi dưới dạng email; các phản hồi sẽ quay trở lại Trò chuyện để nhân viên email của bạn xử lý. Công thức đầy đủ, bao gồm cách dừng chuỗi tin nhắn khi họ thông báo đã đặt lịch, có trong Tự động hóa → Ví dụ: gửi email theo dõi cho khách hàng tiềm năng từ trò chuyện trên trang web.

Tác nhân AI có thể tự đề nghị chuyển sang WhatsApp không? Có, và không cần thêm tính năng nào — chỉ cần một dòng trong hướng dẫn của tác nhân là đủ. Tạo một Liên kết rút gọn cho số WhatsApp của bạn với tin nhắn soạn sẵn như “Xin chào, tôi đang trò chuyện trên trang web của bạn và muốn tiếp tục tại đây”, sau đó cho tác nhân biết khi nào cần gửi tin nhắn đó, ví dụ: “Nếu khách truy cập cần rời đi, muốn tiếp tục sau hoặc yêu cầu dùng WhatsApp, hãy đề nghị tiếp tục ở đó và gửi liên kết này: (liên kết rút gọn của bạn)”. Các liên kết trong tiện ích có thể nhấn vào được, vì vậy khách truy cập sẽ chuyển đến WhatsApp với số của bạn đã được chọn và tin nhắn đã được soạn sẵn, và tin nhắn đầu tiên của họ sẽ mở một cuộc trò chuyện WhatsApp trong hộp thư đến của bạn. Nếu khách truy cập đã để lại số điện thoại mà họ dùng để nhắn tin (kèm mã quốc gia) trong biểu mẫu tiện ích, Your AI Connector sẽ tự động liên kết hai cuộc trò chuyện và AI trên WhatsApp sẽ biết về cuộc trò chuyện trên trang web, giống hệt như với Tiếp tục trên WhatsApp. Nếu không có số điện thoại nào được thu thập, hai cuộc trò chuyện sẽ không được liên kết, vì vậy hãy giữ tin nhắn soạn sẵn đủ cụ thể để tác nhân WhatsApp biết người đó đến từ đâu.

• Yêu cầu xác nhận chính sách quyền riêng tư: Tùy chọn yêu cầu khách truy cập chấp nhận chính sách quyền riêng tư của bạn trước khi trò chuyện và đặt URL mà chính sách đó trỏ đến.

Widget lưu trữ những gì trong trình duyệt của khách truy cập và tôi có cần đặt nó sau biểu ngữ cookie không? Không có gì được lưu trữ chỉ bằng việc tải trang. Widget không ghi cookie và không sử dụng bộ nhớ trình duyệt cho đến khi khách truy cập chọn trò chuyện: gửi tin nhắn đầu tiên, điền vào biểu mẫu thông tin khách truy cập hoặc chấp nhận chính sách quyền riêng tư của bạn. Kể từ thời điểm đó, nó giữ một ID cuộc trò chuyện ngẫu nhiên và một bản sao của cuộc trò chuyện trong trình duyệt đó, dưới dạng bộ nhớ bên thứ nhất trên tên miền của riêng bạn, để cuộc trò chuyện vẫn còn đó khi họ quay lại. Nó không tải bất kỳ tập lệnh phân tích hoặc theo dõi nào và không đặt cookie của bên thứ ba. Vì không có gì được ghi lại cho đến khi khách truy cập yêu cầu trò chuyện, nên nó thuộc loại bộ nhớ hoàn toàn cần thiết cho dịch vụ mà khách truy cập đã yêu cầu, vì vậy bạn có thể tải nó mà không cần đặt nó sau biểu ngữ đồng ý. Nếu trang web của bạn vẫn sử dụng công cụ đồng ý, bạn hoàn toàn có thể đặt widget sau công cụ đó; cuộc trò chuyện sẽ chỉ xuất hiện khi khách truy cập chấp nhận.

Kênh & Nhúng #

• Nút đính kèm: Cho phép khách truy cập gửi hình ảnh và tệp trong cuộc trò chuyện.
• Bộ chọn biểu tượng cảm xúc: Thêm bộ chọn biểu tượng cảm xúc bên cạnh hộp tin nhắn.
• Liên kết kênh: Tùy chọn bao gồm các liên kết WhatsApp, Instagram hoặc Messenger để khách truy cập có thể tiếp tục cuộc trò chuyện trên nền tảng họ thích. Tùy chọn này chỉ xuất hiện sau khi bạn đã kết nối số WhatsApp (WhatsApp Business hoặc WhatsApp Web), Instagram hoặc Messenger. Việc bật liên kết WhatsApp sẽ tự động điền số đã kết nối của bạn; liên kết vẫn có thể chỉnh sửa, vì vậy sau khi thay đổi số, bạn có thể nhập số mới vào đó.
• Nút hành động: Một hàng phím tắt ở đầu cuộc trò chuyện giúp đưa khách truy cập đến một nơi nào đó thay vì vào cuộc trò chuyện — xem Nút hành động bên dưới.
• Danh sách trắng tên miền: Hạn chế các trang web được phép nhúng tiện ích của bạn. Thêm các tên miền nơi bạn đã cài đặt tiện ích (ví dụ: example.com hoặc *.example.com); để trống để cho phép mọi tên miền.
• Quốc gia bị chặn: Ngăn tiện ích hiển thị với khách truy cập ở các quốc gia bạn không phục vụ. Khách truy cập có vị trí mạng nằm trong quốc gia bạn chọn sẽ không bao giờ thấy tiện ích và mọi cuộc trò chuyện họ cố gắng bắt đầu đều bị từ chối. Để trống để cho phép tất cả mọi người. Xem Ngăn chặn bot và tránh lãng phí tín dụng bên dưới.
• Chuyển các cuộc trò chuyện này đến: Chọn nhân viên sẽ xử lý các cuộc trò chuyện đến từ mã bạn sắp sao chép. Để ở chế độ Mặc định tài khoản để sử dụng định tuyến tiện ích trò chuyện thông thường của bạn. Xem Gửi các trang khác nhau đến các nhân viên khác nhau bên dưới.
• Đoạn mã nhúng: Chọn Bong bóng nổi hoặc Nhúng trực tiếp và sao chép mã cài đặt (xem bên dưới).
• Liên kết demo khách hàng: Dán bất kỳ địa chỉ trang web nào và nhấp vào Tạo liên kết để nhận liên kết có thể chia sẻ, mở trang web đó với tiện ích của bạn chạy trên đó mà không cần cài đặt bất cứ thứ gì ở phía họ. Mọi liên kết bạn tạo đều được liệt kê và bạn có thể tắt từng liên kết một. Xem Hiển thị tiện ích trên trang web của người khác bên dưới.
• Liên kết chia sẻ: Một liên kết có sẵn giúp mở trợ lý của bạn trên một trang riêng, toàn màn hình, không cần trang web. Sao chép và gửi liên kết đó đến bất cứ đâu. Xem Chia sẻ liên kết trực tiếp đến cuộc trò chuyện bên dưới.

Ở cuối bảng, hành động Delete chat widget (Xóa tiện ích trò chuyện) sẽ xóa tiện ích khỏi trang web của bạn ngay lập tức — thao tác này không thể hoàn tác và khách truy cập sẽ không còn thấy bong bóng trò chuyện nữa.

Nút hành động #

Một số khách truy cập không muốn trò chuyện. Họ muốn số điện thoại, địa chỉ hoặc email của bạn và họ muốn có được thông tin đó chỉ bằng một lần nhấn. Các nút hành động là một hàng phím tắt ở đầu bảng trò chuyện dành riêng cho mục đích đó.

Thêm tối đa sáu nút. Mỗi nút có một nhãn (từ ngữ trên nút) và một đích đến, và đích đến phụ thuộc vào hành động bạn chọn:

Các nút này không sử dụng tín dụng. Việc nhấn vào một nút không gửi tin nhắn và không bắt đầu cuộc trò chuyện — nó chỉ đưa khách truy cập đến nơi họ muốn. Chỉ một cuộc trò chuyện thực sự với tác nhân AI của bạn mới sử dụng tín dụng, giống như trước đây.

Một vài điều cần lưu ý:

• Các nút vẫn hiển thị trong khi khách truy cập trò chuyện. Ai đó có thể đặt hai câu hỏi và vẫn nhấn Chỉ đường sau đó mà không cần tải lại trang.
• Nhãn của bạn được hiển thị chính xác như bạn đã viết. Không giống như tin nhắn chào mừng và câu hỏi gợi ý, nhãn nút không được tự động dịch, vì vậy nếu bạn phục vụ khách truy cập bằng nhiều ngôn ngữ, hãy giữ cho nhãn ngắn gọn và dễ hiểu (hoặc viết chúng bằng ngôn ngữ chính của bạn).
• Điền thông tin nút đúng cách nếu không nó sẽ không lưu. Nếu số điện thoại, địa chỉ email hoặc liên kết không hợp lệ, bảng điều khiển sẽ thông báo và chặn Lưu thay đổi thay vì xuất bản một nút không có tác dụng gì trên trang web của bạn.
• Chúng không phải là câu trả lời FAQ. Các nút hành động chỉ gửi mọi người đến nơi khác; chúng không trả lời bằng văn bản soạn sẵn. Câu hỏi là công việc của tác nhân AI của bạn và nó sẽ trả lời từ cơ sở kiến thức của bạn. Nếu bạn muốn gợi ý những gì cần hỏi, hãy sử dụng câu hỏi gợi ý trong phần Giao diện.

Những gì bạn không thể tùy chỉnh #

Bảng Manage (Quản lý) là toàn bộ các tùy chọn có sẵn. Cụ thể:

• Không có CSS hoặc tệp kiểu tùy chỉnh. Kiểu dáng được cung cấp bởi chủ đề, góc, phông chữ và bộ chọn màu — bạn không thể chèn CSS của riêng mình vào tiện ích và các quy tắc trên trang của bạn sẽ không thể tác động vào bên trong tiện ích.
• Không có văn bản giữ chỗ tùy chỉnh trong hộp tin nhắn.
• Không có nhúng video bên trong cuộc trò chuyện.

Nếu một trong những điều trên là rào cản đối với bạn, nhúng nội dòng sẽ cung cấp cho bạn quyền kiểm soát tối đa: tiện ích nằm trong một vùng chứa trên trang của riêng bạn, nơi bạn tự định kích thước và vị trí.

Ngăn chặn Bot và Tiêu hao Tín dụng #

Mỗi câu trả lời của AI đều tốn tín dụng, vì vậy một tập lệnh (hoặc một người rảnh rỗi) mở hết cuộc trò chuyện này đến cuộc trò chuyện khác trên trang web của bạn là điều duy nhất mà một tiện ích công cộng phải chống lại. Tiện ích tự xử lý hầu hết các vấn đề này và hai cài đặt trên bảng Quản lý cho phép bạn thắt chặt hơn cho trang web của mình.

• Danh sách trắng tên miền. Chỉ các trang web bạn liệt kê mới có thể hiển thị tiện ích. Bất kỳ ai sao chép mã nhúng của bạn sang trang web khác sẽ không thấy gì cả.
• Các quốc gia bị chặn. Khách truy cập có vị trí mạng nằm trong quốc gia bạn chặn sẽ không bao giờ thấy tiện ích, và cuộc trò chuyện mà họ cố gắng bắt đầu cũng sẽ bị từ chối. Vị trí được xác định từ kết nối của khách truy cập: người dùng VPN sẽ hiển thị là quốc gia của VPN đó, và khách truy cập không xác định được vị trí sẽ được cho phép thay vì bị chặn. Bản xem trước của riêng bạn trong ứng dụng vẫn hoạt động ngay cả khi bạn chặn quốc gia nơi bạn đang ngồi.
• Số cuộc trò chuyện mới trên mỗi kết nối. Một kết nối (trên thực tế là một địa chỉ hộ gia đình hoặc văn phòng) có thể mở 20 cuộc trò chuyện mới mỗi ngày trên một tiện ích. Khách truy cập quay lại tiếp tục cuộc trò chuyện hiện có sẽ không bị tính, chỉ các cuộc trò chuyện hoàn toàn mới mới bị tính, vì vậy một tập lệnh liên tục bắt đầu các cuộc trò chuyện mới để khai thác phản hồi AI sẽ bị chặn sau 20 lần trong khi khách truy cập thực sự sẽ không bao giờ nhận thấy. Nếu nhiều người dùng chung một kết nối trên trang web của bạn (một khuôn viên, một trung tâm cuộc gọi), hãy tăng số lượng này thông qua REST API với max_new_chats_per_ip_daily; 0 sẽ tắt kiểm tra này.
• Kiểm tra con người (tùy chọn). Khách truy cập vượt qua kiểm tra Cloudflare Turnstile nhanh chóng trước khi tin nhắn đầu tiên của họ được gửi đi, vì vậy tập lệnh không thể bắt đầu cuộc trò chuyện. Hầu hết mọi người không bao giờ phải nhấp vào bất cứ thứ gì; Cloudflare chỉ hiển thị hộp kiểm khi không chắc chắn. Nó sử dụng các khóa Turnstile miễn phí của riêng bạn, xem Thêm kiểm tra con người bên dưới.
• Các giới hạn tích hợp. Ngoài ra, mỗi phiên trình duyệt bị giới hạn số lượng tin nhắn có thể gửi mỗi phút và mỗi ngày, và tác nhân trả lời cuộc trò chuyện sẽ ngừng phản hồi khách truy cập sau khi đạt đến Số tin nhắn AI tối đa mỗi cuộc trò chuyện được đặt trong Giới hạn phản hồi của nó.

Không có điều nào trong số này xác định thiết bị hoặc con người: tiện ích không lưu trữ bất cứ thứ gì trong trình duyệt của khách truy cập cho đến khi họ chọn trò chuyện (xem ở trên) và không có dấu vân tay kỹ thuật số nào được thực hiện.

Thêm kiểm tra con người (Cloudflare Turnstile) #

Hãy bật tính năng này khi các bot liên tục mở cuộc trò chuyện trên trang web của bạn và các cài đặt ở trên là không đủ. Kiểm tra chạy một lần, ngay trước khi tin nhắn đầu tiên của khách truy cập được gửi đi. Khách truy cập vượt qua có thể tiếp tục trò chuyện trong 24 giờ mà không cần thấy lại kiểm tra này, và bất kỳ ai quay lại cuộc trò chuyện trước đó vẫn có thể đọc nó trước khi kiểm tra.

1. Đăng nhập vào tài khoản Cloudflare của bạn (tài khoản miễn phí là đủ) và mở Turnstile.
2. Nhấp vào Add widget, đặt tên cho nó và thêm mọi tên miền mà tiện ích trò chuyện của bạn chạy trên đó (ví dụ: yourshop.com). Để chế độ tiện ích là Managed.
3. Sao chép Site key và Secret key mà Cloudflare hiển thị cho bạn.
4. Trong ứng dụng, mở bảng Manage của tiện ích trò chuyện, bật Human check before chatting, dán cả hai khóa và lưu lại.

Những điều cần lưu ý:

• Kiểm tra vẫn tắt cho đến khi cả hai khóa được điền, vì vậy việc bật nó mà không có khóa sẽ không bao giờ chặn khách truy cập.
• Nếu khách truy cập không vượt qua kiểm tra hoặc để trống không giải quyết, tin nhắn của họ sẽ không được gửi và họ sẽ nhận được nút Retry.
• Kiểm tra chỉ xuất hiện trên các tên miền bạn đã thêm trong Cloudflare. Trên bất kỳ tên miền nào khác, Cloudflare sẽ từ chối nó và không ai trên trang web đó có thể gửi tin nhắn, vì vậy hãy thêm mọi tên miền trước khi bạn bật nó.
• Nếu trang web của bạn sử dụng Chính sách bảo mật nội dung (Content Security Policy), hãy cho phép https://challenges.cloudflare.com cho các tập lệnh và khung, nếu không kiểm tra sẽ không thể tải.
• Các khóa này thuộc về tài khoản Cloudflare của riêng bạn và khóa bí mật (secret key) không bao giờ được gửi đến trình duyệt của khách truy cập.

Hướng dẫn Cài đặt #

Để thêm tiện ích trò chuyện vào trang web của bạn, hãy thêm một dòng mã vào HTML của trang web.

1. Mở tệp HTML trên trang web của bạn bằng trình soạn thảo văn bản.
2. Tìm thẻ đóng </body> — thẻ này thường nằm ở cuối tệp.
3. Dán dòng mã này ngay trước thẻ </body> để phần còn lại của trang web được tải trước:

<script src="https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID" defer></script>

4. Thay thế CONFIG_ID bằng mã định danh cấu hình duy nhất của bạn, được hiển thị trong phần Channels & Embed (Kênh & Nhúng) của bảng Quản lý (Manage panel). Mã định danh này dành riêng cho tài khoản của bạn và kết nối tiện ích với hệ thống nhắn tin của bạn.

Đoạn mã này sẽ không làm chậm trang web của bạn: nó là một trình tải nhỏ gọn và bản thân tiện ích sẽ được tải xuống trong nền mà không chặn trang. Nếu bạn vẫn muốn tiện ích chờ cho đến khi trang của bạn tải xong hoàn toàn, bạn có thể bao bọc cùng một URL như thế này:

<script>
window.addEventListener('load', function () {
  var s = document.createElement('script');
  s.src = 'https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID';
  s.async = true;
  document.body.appendChild(s);
});
</script>

Và nếu điều bạn muốn trì hoãn là bong bóng lời mời nhỏ thay vì việc tải tiện ích, đó chính là độ trễ Bong bóng bật lên chủ động trong phần Hành vi ở trên — không cần mã.

Cài đặt trên Shopify #

1. Trong trang quản trị Shopify của bạn, đi tới Cửa hàng trực tuyến > Chủ đề.
2. Trên chủ đề được đánh dấu là chủ đề hiện tại (đã xuất bản) của bạn, hãy nhấp vào nút … và chọn Chỉnh sửa mã. Việc chỉnh sửa bản nháp hoặc bản sao của chủ đề sẽ không thay đổi bất cứ điều gì trên cửa hàng trực tiếp của bạn.
3. Mở layout/theme.liquid và cuộn xuống thẻ đóng </body> gần cuối trang.
4. Dán dòng cài đặt của bạn ngay phía trên </body> và nhấp vào Lưu:

<script src="https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID" defer></script>

Nếu bạn đã cài đặt widget trước khi dòng cài đặt mang theo defer, trình chỉnh sửa mã của Shopify sẽ hiển thị một đường gạch chân màu đỏ bên dưới nó. Đường gạch chân đó là cảnh báo từ trình kiểm tra mã của Shopify về các dòng tập lệnh không có defer hoặc async, chứ không phải lỗi: chủ đề vẫn lưu và widget vẫn hoạt động. Việc thêm defer như hiển thị ở trên sẽ làm mất đường gạch chân và không thay đổi bất cứ điều gì về cách widget hoạt động, vì vậy không cần phải cài đặt lại trên các trang web khác.

Dưới đây là ví dụ hoàn chỉnh về cách tệp HTML của bạn sẽ trông như thế nào khi đã triển khai tiện ích chat:

<!DOCTYPE html>
<html>
<head>
    <title>My Website</title>
</head>
<body>
    <!-- Your existing website content would be here -->

    <!-- Chat Widget Integration -->
    <script src="https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID" defer></script>
</body>
</html>

Nhúng nội dòng trên trang (Nâng cao) #

Nếu bạn muốn khung trò chuyện xuất hiện như một phần của trang web — ví dụ: bên trong phần “Liên hệ với chúng tôi”, tab trợ giúp hoặc thanh bên — thay vì là một bong bóng nổi ở góc, hãy chuyển Embed snippet (Đoạn mã nhúng) sang Inline (Nội dòng) trong bảng Quản lý và sao chép đoạn mã nội dòng.

Nó trông như thế này:

<div data-chat-widget="CONFIG_ID" style="width:100%;height:600px;"></div>
<script src="https://api.youraiconnector.com/v1/chat-widget/embed.js" async></script>

<div> là điểm gắn kết — bảng trò chuyện sẽ hiển thị bên trong đó và lấp đầy kích thước của nó. Bạn có thể định kiểu cho div này theo bất kỳ cách nào bạn muốn (đặt chiều cao cố định, đặt nó vào trong một flex container, đặt nó vào một ô lưới, v.v.) và bảng trò chuyện sẽ tuân theo.

Bạn chỉ cần một thẻ <script> trên trang, ngay cả khi bạn đang nhúng nhiều tiện ích trò chuyện. Tập lệnh sẽ quét trang để tìm mọi <div data-chat-widget="…"> và gắn một bảng trò chuyện vào mỗi thẻ đó.

Khi nào nên chọn nhúng nội dòng (inline) so với nổi (floating):

• Bong bóng nổi phù hợp cho nút “Cần trợ giúp?” luôn hiển thị trên toàn trang web.
• Nhúng nội dòng phù hợp khi trò chuyện cần nằm ở một vị trí cụ thể — trang hỗ trợ, thanh bên của cơ sở kiến thức, tab trợ giúp trong ứng dụng — và tạo cảm giác như một phần tự nhiên của trang đó.

Tiện ích nhúng nội dòng sử dụng lại cùng một cấu hình như bong bóng nổi (logo, tin nhắn chào mừng, thu thập thông tin khách hàng tiềm năng, câu hỏi bắt đầu, v.v.), vì vậy bạn không cần phải thiết lập bất cứ điều gì hai lần.

Hiển thị tiện ích trên trang web của người khác #

Bạn có thể hiển thị tiện ích trò chuyện của mình chạy trên một trang web mà bạn không kiểm soát — không cần mã, không cần quyền truy cập vào trang web của họ. Đây là cách nhanh nhất để cho khách hàng tiềm năng thấy trợ lý sẽ trông như thế nào trên các trang của chính họ.

1. Mở bảng Quản lý (Manage) và cuộn xuống Kênh & Nhúng (Channels & Embed).
2. Trong phần Liên kết demo khách hàng (Client demo link), hãy nhập địa chỉ trang web (ví dụ: www.theircompany.com).
3. Tùy chọn: bên dưới trường này, hãy chọn Tác nhân (Agent) sẽ trả lời trong bản demo này, ví dụ như một tác nhân bạn đã xây dựng từ chính trang web của khách hàng tiềm năng để nó có thể nói về các dịch vụ, giá cả và câu hỏi thường gặp của họ. Hãy để ở chế độ Mặc định của tài khoản (Account default) để sử dụng định tuyến tiện ích trò chuyện thông thường của bạn.
4. Nhấp vào Tạo liên kết (Create link). Liên kết sẽ được sao chép cho bạn và xuất hiện trong danh sách bên dưới trường này, cùng với các nút Sao chép (Copy) và Mở (Open) cũng như tác nhân mà nó sử dụng.
5. Gửi liên kết cho bất kỳ ai bạn muốn hiển thị.

Việc mở liên kết sẽ tải trang web đó với tiện ích trò chuyện của bạn nổi bên trên, chính xác như cách nó hiển thị nếu được cài đặt. Bất kỳ ai có liên kết đều có thể mở nó — không cần đăng nhập gì cả.

Một vài điều cần lưu ý:

• Các cuộc trò chuyện từ bản demo là thật. Tin nhắn mà khách truy cập gửi trong bản demo sẽ đến hộp thư đến của bạn và được nhân viên của bạn trả lời, đồng thời chúng sử dụng tín dụng như bất kỳ cuộc trò chuyện nào khác.
• Trang này không có thương hiệu. Nó chỉ hiển thị trang web của họ và tiện ích của bạn, không có gì khác.
• Một số trang web không thể được đóng khung. Một số trang web (ngân hàng, nhà bán lẻ lớn, bất kỳ trang nào có cài đặt bảo mật nghiêm ngặt) chặn các trang khác hiển thị chúng. Khi đó, liên kết vẫn hoạt động: nó hiển thị một cửa sổ trình duyệt giả lập trung tính thay vì trang web thực, với tiện ích của bạn chạy trực tiếp trên đó để bản demo vẫn thực hiện được chức năng của nó.
• Nó không thay đổi trang web của họ. Không có gì được cài đặt và không có gì bị sửa đổi — bản demo chỉ tồn tại bên trong liên kết đó.
• Tắt liên kết khi bản demo kết thúc. Nhấp vào Tắt bên cạnh liên kết trong danh sách và xác nhận. Kể từ đó, bất kỳ ai mở liên kết sẽ thấy một trang thông báo rằng liên kết đã bị tắt. Tiện ích của bạn và các liên kết demo khác vẫn tiếp tục hoạt động. Một liên kết đã bị tắt không thể bật lại; hãy tạo một liên kết mới thay thế.
• Các liên kết được sao chép trước ngày 25 tháng 9 năm 2026. Các liên kết demo được tạo trước khi danh sách tồn tại sẽ không nằm trong đó. Chúng vẫn hoạt động cho đến khi bạn nhấp vào Tắt các liên kết đó bên dưới danh sách, thao tác này sẽ tắt tất cả chúng cùng một lúc (và Bật lại chúng sẽ đảo ngược thao tác này).

Một liên kết demo được tạo mà không có tác nhân sẽ sử dụng định tuyến mặc định của tài khoản bạn, bất kể mục Định tuyến các cuộc trò chuyện này tới được đặt là gì. Khi đã chọn một tác nhân, mọi cuộc trò chuyện từ liên kết đó sẽ được chỉ định cho tác nhân đó và do tác nhân đó trả lời. Tiện ích vẫn giữ nguyên giao diện, tên và tin nhắn chào mừng của riêng nó. Liên kết mang theo nó dưới dạng &agent=AGENT_ID; việc thêm thủ công vào một liên kết cũ hơn cũng có hiệu quả (sử dụng &, không phải ?, vì liên kết đã chứa một ?).

Nếu sau này bạn xóa tác nhân mà liên kết demo đang sử dụng, liên kết đó vẫn tiếp tục hoạt động: các cuộc trò chuyện của nó sẽ chuyển sang định tuyến mặc định của tài khoản bạn, và danh sách sẽ hiển thị “tác nhân đã xóa, sử dụng mặc định” bên cạnh nó. Việc xóa tác nhân là mặc định cho tiện ích trò chuyện của bạn sẽ không ảnh hưởng đến các liên kết đã được ghim vào một tác nhân khác.

Chia sẻ liên kết trực tiếp đến cuộc trò chuyện #

Đôi khi không có trang web nào để đặt tiện ích — bạn muốn gửi cho ai đó một liên kết và để họ trò chuyện với trợ lý của bạn ngay lập tức. Mỗi tiện ích trò chuyện đều có một liên kết như vậy:

1. Mở bảng Quản lý và cuộn đến Kênh & Nhúng.
2. Tìm Liên kết chia sẻ (nằm ngay dưới liên kết bản demo cho khách hàng).
3. Nhấp vào Sao chép để lấy liên kết hoặc Mở để tự mình dùng thử.

Khi mở ra, nó sẽ chỉ hiển thị trợ lý của bạn, lấp đầy toàn bộ màn hình — không có trang web phía sau, không có bong bóng để nhấp vào trước, không cần cài đặt gì cả. Hãy đặt nó vào tiểu sử Instagram, mã QR trên tờ rơi, chữ ký email hoặc tin nhắn WhatsApp gửi cho khách hàng tiềm năng.

Liên kết chia sẻ tuân theo định tuyến mặc định của tiện ích trò chuyện của bạn. Để mở một tác nhân cụ thể thay thế, hãy thêm ?agent=AGENT_ID vào cuối liên kết; mọi cuộc trò chuyện từ đó sau đó sẽ được chỉ định cho tác nhân đó và do tác nhân đó trả lời, trong khi trang vẫn giữ nguyên tên và tin nhắn chào mừng của tiện ích của bạn.

Một vài điều cần lưu ý:

• Các cuộc trò chuyện từ liên kết là thật. Chúng đến hộp thư đến của bạn, nhân viên của bạn trả lời chúng và chúng sử dụng tín dụng giống như bất kỳ cuộc trò chuyện nào khác.
• Trang này không mang thương hiệu của chúng tôi. Nó chỉ hiển thị trợ lý của bạn và không gì khác, đồng thời nó được loại khỏi kết quả tìm kiếm.
• Nó hoạt động trên địa chỉ của riêng bạn. Nếu nhà cung cấp của bạn chạy ứng dụng trên tên miền riêng của họ, liên kết cũng sử dụng địa chỉ đó, vì vậy sẽ không có gì lạ lẫm xuất hiện trong đó.
• Một khách truy cập cho mỗi liên kết, mỗi trình duyệt. Bất kỳ ai mở nó đều giữ cùng một danh tính trong trình duyệt đó, vì vậy việc quay lại sau đó sẽ tiếp tục cùng một cuộc trò chuyện thay vì bắt đầu một cuộc trò chuyện mới với người lạ. Một trình duyệt khác hoặc liên kết của một tiện ích khác sẽ là một khách truy cập khác.

Gửi các trang khác nhau đến các nhân viên khác nhau #

Theo mặc định, mọi cuộc trò chuyện đến qua tiện ích của bạn đều được xử lý bởi cùng một nhân viên. Bạn có thể ghi đè điều đó cho từng trang, để khách truy cập trên trang giá của bạn nói chuyện với nhân viên bán hàng trong khi khách truy cập trên trang trợ giúp nói chuyện với nhân viên hỗ trợ, tất cả đều từ một tiện ích trò chuyện.

Có hai cách để lấy mã:

• Từ nhân viên. Trên trang Nhân viên AI, nhấp vào nút </> trên hàng hoặc mở nhân viên đó và đi đến tab Điểm truy cập của họ. Dù bằng cách nào, bạn cũng sẽ nhận được một đoạn mã sẵn sàng để dán đã được trỏ đến nhân viên đó.

  Tab Điểm truy cập của tác nhân cũng có bảng Tiện ích trò chuyện trên trang web hiển thị số lượng cuộc trò chuyện trên trang web mà tác nhân đó đang xử lý. Các cuộc trò chuyện từ mã nhúng sẽ tiếp cận trực tiếp tác nhân, vì vậy bạn không cần tạo quy tắc điểm truy cập cho chúng — một tác nhân không có bất kỳ quy tắc nào vẫn sẽ trả lời mã nhúng của nó.

  Nút </> chỉ xuất hiện trên các nhân viên đang hoạt động. Một nhân viên bị tạm dừng sẽ nhận được cuộc trò chuyện nhưng không bao giờ trả lời, vì vậy tùy chọn này bị ẩn cho đến khi bạn bật lại. Không có kênh nào cần thiết lập cho nhân viên — một nhân viên có thể nhận cuộc trò chuyện từ bất kỳ kênh nào.

• Từ cài đặt tiện ích. Trong Cài đặt → Kênh → Quản lý trên tiện ích trò chuyện của bạn, hãy đặt Chuyển các cuộc trò chuyện này đến và sao chép đoạn mã bên dưới. Việc thay đổi menu thả xuống sẽ viết lại đoạn mã.

Đoạn mã nổi mang thông tin đích trong địa chỉ:

<script src="https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID?agent=AGENT_ID" defer></script>

Đoạn mã nhúng trực tiếp mang thông tin đó trên <div> thay vào đó, vì vậy một trang có thể chứa nhiều cuộc trò chuyện đi đến các nơi khác nhau:

<div data-chat-widget="CONFIG_ID" data-agent="AGENT_ID" style="width:100%;height:600px;"></div>
<script src="https://api.youraiconnector.com/v1/chat-widget/embed.js" async></script>

Các đoạn mã được sao chép trước khi các chiến dịch bị ngừng hoạt động sẽ mang ?campaign= hoặc data-campaign= thay thế. Chúng vẫn tiếp tục hoạt động, vì vậy không cần phải dán lại.

Một vài điều cần lưu ý:

• Sử dụng nút sao chép thay vì tự nhập ID. Nếu ID không khớp với nhân viên trong tài khoản của bạn, cuộc trò chuyện vẫn hoạt động nhưng sẽ quay lại định tuyến mặc định của bạn.
• Người đang trong cuộc trò chuyện sẽ tiếp tục với người mà họ đã bắt đầu, ngay cả khi sau đó họ truy cập vào một trang trỏ đến nơi khác. Điều này giúp cuộc trò chuyện không bị thay đổi tính cách giữa chừng.
• Điểm đến dành riêng cho trang sẽ được ưu tiên hơn mặc định tài khoản của bạn và các từ khóa kích hoạt.

Cho Widget biết khách truy cập là ai (Nâng cao) #

Nếu bạn đặt widget trò chuyện trong khu vực thành viên, cổng thông tin khách hàng hoặc ứng dụng nơi mọi người đã đăng nhập, trang web của bạn đã biết họ là ai. Bạn có thể chuyển thông tin đó cho widget để khách truy cập không bị hỏi lại những chi tiết họ đã cung cấp trước đó, đồng thời để AI của bạn có thể sử dụng những gì bạn đã biết về họ.

Thêm một khối cài đặt nhỏ trước tập lệnh widget:

<script>
  window.chatWidgetSettings = {
    visitor: {
      id: "12345",
      name: "Maria",
      email: "maria@example.com",
      phone: "+391234567890"
    },
    data: {
      plan: "Professional",
      customer_since: "2024",
      last_order: "A-2291"
    }
  };
</script>
<script src="https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID" defer></script>

Trang của bạn nên điền các giá trị đó ở phía máy chủ, từ bất kỳ ai đã đăng nhập.

Để lưu cả họ, hãy thêm last_name bên cạnh name trong khối visitor (data-visitor-last-name trên một nhúng nội dòng). Điều này là tùy chọn: tên và email vẫn đủ để bỏ qua biểu mẫu, bất kể Thu thập họ có được bật hay không.

Hai điều sẽ xảy ra:

• Biểu mẫu “Trước khi bắt đầu…” sẽ bị bỏ qua. Với tên và email được cung cấp, khách truy cập sẽ đi thẳng vào cuộc trò chuyện và các chi tiết đó được lưu vào liên hệ của họ chính xác như thể họ đã tự nhập.
• Mọi thứ trong data đều được chuyển cho AI của bạn. Bất cứ điều gì bạn đặt ở đó — gói dịch vụ, số đơn hàng, ngày gia hạn, số dư tín dụng, số lượng chỗ ngồi họ có — đều trở thành một phần thông tin mà AI biết về người đó, vì vậy nó có thể trả lời “khi nào gói của tôi gia hạn?” mà không cần yêu cầu họ giải thích họ là ai trước. Hãy sử dụng bất kỳ tên trường nào có ý nghĩa với bạn; chúng sẽ xuất hiện trên liên hệ trong phần Trường tùy chỉnh (Custom Fields). Tối đa 20 giá trị, được gửi mới với mỗi tin nhắn, vì vậy nếu gói dịch vụ thay đổi giữa cuộc trò chuyện, AI sẽ thấy thông tin mới.

Đối với các nhúng nội dòng (inline embeds), bạn có thể đặt cùng thông tin đó trên <div>, điều này rất tiện lợi khi một trang chứa nhiều cuộc trò chuyện:

<div data-chat-widget="CONFIG_ID"
     data-visitor-name="Maria"
     data-visitor-email="maria@example.com"
     data-visitor-data='{"plan":"Professional"}'
     style="width:100%;height:600px;"></div>
<script src="https://api.youraiconnector.com/v1/chat-widget/embed.js" async></script>

Nếu trang web của bạn chỉ biết khách truy cập là ai sau khi trang đã tải xong — ví dụ như ứng dụng một trang (single-page app) nơi việc đăng nhập diễn ra mà không cần tải lại trang — hãy gọi lệnh này bất cứ khi nào bạn có thông tin chi tiết và widget sẽ tự cập nhật:

<script>
  window.chatWidget.setVisitor({
    visitor: { id: "12345", name: "Maria", email: "maria@example.com" },
    data: { plan: "Professional" }
  });
</script>

Một vài điều cần lưu ý:

• Nếu hai người khác nhau đăng nhập trên cùng một máy tính, người thứ hai sẽ bắt đầu một cuộc trò chuyện mới thay vì nhìn thấy cuộc trò chuyện của người thứ nhất. Tiện ích sẽ nhận thấy sự thay đổi người dùng và tự đặt lại.
• Về bản chất, điều này phục vụ mục đích ngữ cảnh, không phải để đăng nhập cho ai đó. Các cuộc trò chuyện vẫn được giữ riêng biệt như trước đây, vì vậy việc truyền id không cho phép bất kỳ ai mở cuộc trò chuyện của người khác và người dùng sử dụng thiết bị hoặc trình duyệt khác sẽ bắt đầu một cuộc trò chuyện mới ở đó. Để tiếp tục cuộc trò chuyện trên các thiết bị, hãy đăng nhập id như được mô tả tiếp theo.
• Đây là tùy chọn. Một tiện ích trên trang công cộng thông thường không cần bất kỳ điều này và hoạt động chính xác như trước.

Tiếp tục cùng một cuộc trò chuyện trên mọi thiết bị (ID khách truy cập đã đăng nhập) #

Nếu khách hàng của bạn có tài khoản, bạn có thể làm cho cuộc trò chuyện của họ theo chân họ: đăng nhập trên điện thoại, tiếp tục trên máy tính xách tay, và đó vẫn là cùng một cuộc trò chuyện với cùng một liên hệ trong hộp thư đến của bạn, và AI vẫn biết mọi thứ đã được trao đổi. Để làm được điều đó, Your AI Connector cần bằng chứng rằng khách truy cập thực sự là người mà trang của bạn xác nhận, nếu không bất kỳ ai cũng có thể nhập số khách hàng vào trình duyệt của họ và đọc cuộc trò chuyện của khách hàng đó. Bằng chứng là một chữ ký bạn tính toán trên máy chủ của mình.

1. Trong bảng Manage (Quản lý) của tiện ích, tại mục Channels & Embed (Kênh & Nhúng), hãy tìm Signed-in visitors (Khách truy cập đã đăng nhập) và nhấp vào Generate secret (Tạo bí mật). Sao chép mã bí mật định danh. Chỉ lưu giữ nó trên máy chủ của bạn; không bao giờ đặt nó trực tiếp trên trang.

2. Khi máy chủ của bạn hiển thị trang cho khách hàng đã đăng nhập, hãy tính toán HMAC-SHA256 của ID khách hàng đó bằng cách sử dụng mã bí mật, dưới dạng chuỗi thập lục phân viết thường:

// Node.js
const hash = require("crypto").createHmac("sha256", IDENTITY_SECRET).update(customerId).digest("hex");

// PHP
$hash = hash_hmac('sha256', $customerId, IDENTITY_SECRET);

# Python
import hmac, hashlib
hash = hmac.new(IDENTITY_SECRET.encode(), customer_id.encode(), hashlib.sha256).hexdigest()

3. Đặt ID và mã băm vào khối cài đặt, bên cạnh tên và email mà bạn đã truyền:

<script>
  window.chatWidgetSettings = {
    visitor: {
      id: "12345",
      hash: "3f2a…e91c",
      name: "Maria",
      email: "maria@example.com"
    }
  };
</script>
<script src="https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID" defer></script>

Nhúng nội dòng (inline embed) nhận cùng giá trị với data-visitor-hash trên <div>, và window.chatWidget.setVisitor({ visitor: { id, hash } }) hoạt động cho các ứng dụng đăng nhập người dùng mà không cần tải lại trang.

Điều gì xảy ra khi chữ ký được xác thực:

• Cuộc trò chuyện của khách hàng được lưu trữ theo tài khoản của họ thay vì theo trình duyệt, vì vậy đó là cùng một cuộc trò chuyện trên mọi thiết bị và mọi trình duyệt mà họ đăng nhập, và là một liên hệ duy nhất trong hộp thư đến của bạn.
• Các tin nhắn trước đó của họ sẽ tải trên thiết bị mới và AI sẽ tiếp tục từ nơi họ đã dừng lại.
• Nếu chữ ký không chính xác, tiện ích sẽ âm thầm hoạt động như trước đây, dưới dạng trò chuyện thông thường theo trình duyệt và in lý do trong bảng điều khiển trình duyệt để nhà phát triển có thể phát hiện. Khách truy cập của bạn sẽ không bao giờ thấy lỗi.
• ID được so sánh chính xác như bạn đã gửi, vì vậy hãy ký cùng giá trị mà bạn truyền dưới dạng id và sử dụng cùng một ID cho cùng một người ở mọi nơi.

Hai điều cần biết:

• Tạo lại trong bảng Quản lý sẽ cung cấp cho bạn một bí mật mới. Các trang vẫn ký bằng bí mật cũ sẽ quay lại trò chuyện bình thường theo trình duyệt cho đến khi máy chủ của bạn sử dụng bí mật mới. Các cuộc trò chuyện hiện có vẫn được giữ nguyên; chúng được gắn với ID của khách hàng, không phải với bí mật.
• Một cuộc trò chuyện mà ai đó đã có trước khi đăng nhập, với tư cách là khách truy cập ẩn danh, vẫn là một cuộc trò chuyện riêng biệt. Cuộc trò chuyện dựa trên tài khoản bắt đầu với tin nhắn đầu tiên họ gửi khi đã đăng nhập.

Thay đổi cài đặt Widget từ mã của riêng bạn (API) #

Mọi thứ trên bảng Quản lý (Manage) của widget cũng có thể được thay đổi thông qua REST API, điều này rất hữu ích nếu bạn quản lý nhiều trang web hoặc muốn nút đính kèm tự động tắt cho khách hàng. Gửi một PATCH đến https://api.youraiconnector.com/v1/chat-widget-configs/CONFIG_ID cùng với khóa API của bạn và chỉ các trường bạn muốn thay đổi — ví dụ: {"show_upload_button": false} ẩn nút đính kèm, {"show_emoji_button": false} ẩn bộ chọn biểu tượng cảm xúc và {"launcher_icon": "chat-dots"} thay đổi biểu tượng trình khởi chạy. CONFIG_ID là cùng một định danh như trong tập lệnh nhúng của bạn. Danh sách đầy đủ các trường được chấp nhận (tên, tin nhắn chào mừng, màu sắc, biểu tượng trình khởi chạy, tên miền được phép, biểu mẫu thông tin khách truy cập, thông báo quyền riêng tư, chủ đề, góc và kiểu phông chữ) có trong Tài liệu tham khảo API tại mục Chat Widget. Các trang web sẽ cập nhật thay đổi vào lần tải trang tiếp theo.

Những gì sẽ xảy ra sau khi cài đặt #

Sau khi bạn đã thêm tập lệnh vào trang web của mình, tiện ích trò chuyện sẽ tự động tạo một nút trò chuyện ở góc trang web của bạn (mặc định là góc dưới bên phải). Tiện ích vẫn ở vị trí cố định khi người dùng cuộn qua các trang của bạn, đảm bảo rằng nó luôn có thể truy cập được.

Khi khách truy cập nhấp vào nút này, nó sẽ mở rộng thành một cửa sổ trò chuyện đầy đủ, nơi họ có thể bắt đầu cuộc trò chuyện, hiển thị tin nhắn mở đầu của bạn. Nếu Thu thập thông tin khách truy cập được bật, một biểu mẫu nhỏ sẽ xuất hiện trước tiên để yêu cầu tên và email (và tùy chọn là số điện thoại) của họ trước khi họ có thể nhập tin nhắn.

Giao diện trò chuyện tự động thích ứng với các kích thước màn hình khác nhau, vì vậy nó hoạt động liền mạch trên cả máy tính để bàn và thiết bị di động.

Kiểm tra việc triển khai của bạn #

Sau khi thêm tiện ích vào trang web của bạn, hãy kiểm tra xem nó có hoạt động không:

1. Mở trang web của bạn trong trình duyệt.
2. Nhấp vào nút trò chuyện để mở tiện ích.
3. Gửi tin nhắn kiểm tra và xác nhận rằng bạn nhận được phản hồi.
4. Lặp lại trên một thiết bị hoặc trình duyệt khác để xác nhận nó hoạt động ở mọi nơi.

Nếu tiện ích trò chuyện không xuất hiện trên trang web của bạn, hãy kiểm tra các mục sau:

1. Đảm bảo bạn đã thay thế CONFIG_ID bằng mã định danh cấu hình thực tế của mình.
2. Đảm bảo thẻ tập lệnh được đặt trước thẻ đóng </body>.
3. Kiểm tra mã để tìm lỗi đánh máy.
4. Trên Shopify, hãy đảm bảo bạn đã chỉnh sửa chủ đề đã xuất bản và nhấp vào Lưu. Một chỉnh sửa được thực hiện trong bản nháp hoặc chủ đề trùng lặp sẽ không bao giờ đến được cửa hàng trực tiếp của bạn.

Phía sau Tường lửa Doanh nghiệp #

Nếu tiện ích tải được cho công chúng nhưng không tải được cho nhân viên trong mạng văn phòng, thì gần như chắc chắn mạng đó đang chặn tên miền mà tiện ích tải từ đó. Hãy yêu cầu nhóm CNTT của bạn cho phép truy cập qua HTTPS thông thường trên cổng 443:

• Tên miền trong đoạn mã nhúng của bạn — địa chỉ trong dòng <script src="..."> mà bạn đã sao chép từ bảng Manage.
• api.youraiconnector.com — tiện ích cũng gửi tin nhắn của nó đến đây.

Không cần mở thêm bất cứ thứ gì khác: không cần thêm cổng và không cần quy tắc gửi đến. Nếu tiện ích vẫn không xuất hiện sau đó, hãy mở bảng điều khiển dành cho nhà phát triển của trình duyệt trên trang đó và gửi cho chúng tôi những gì nó báo cáo — một yêu cầu bị chặn sẽ nêu tên miền bị từ chối, đó thường là câu trả lời đầy đủ.