Tích hợp nền tảng

Chatbot chỉ thực sự hữu ích khi khách hàng có thể tiếp cận được nó. Hướng dẫn này sẽ giúp bạn kết nối chatbot với các kênh mà khách hàng của bạn đang sử dụng hàng ngày — không cần kinh nghiệm lập trình.

Tổng quan

Kết nối chatbot của bạn với một hoặc nhiều kênh cùng lúc. Các kênh được hỗ trợ bao gồm Widget trang web, Telegram, Zalo, Zalo OA, Facebook Messenger và API tùy chỉnh. Tất cả cài đặt nền tảng nằm trong chatbot của bạn ở tab Nền tảng, và các kênh khả dụng phụ thuộc vào gói đăng ký của bạn.

Nền tảng khả dụng theo gói

Widget trang web

Widget trang web thêm một nút chat nhỏ vào website của bạn. Khi khách truy cập nhấn vào, cửa sổ chat sẽ mở ra — không cần đăng nhập hay tải ứng dụng.

Cài đặt

1. Mở chatbot của bạn và nhấn tab Nền tảng.
2. Nhấn Thêm nền tảng và chọn Web.
3. Nền tảng được tạo tự động — bạn sẽ thấy đoạn mã nhúng.
4. Sao chép đoạn mã nhúng và dán vào HTML của website, ngay trước thẻ đóng </body>.

Ví dụ mã nhúng

htmlCopy
<script
  src="https://your-platform-domain.com/embed/chatbot.js"
  data-chatbot-id="your-chatbot-id"
  defer
></script>

Dán đoạn mã này một lần vào template website và widget sẽ tự động xuất hiện trên mọi trang.

Tùy chỉnh widget

• Màu sắc — đặt màu thương hiệu tại Cài đặt → Thông tin cơ bản → Màu sắc
• Ảnh đại diện — tải lên hình vuông (logo hoặc hình minh họa) để hiển thị trên nút chat và phần đầu cuộc trò chuyện
• Trạng thái — chatbot phải được đặt ở chế độ Công khai để khách truy cập website có thể sử dụng; giữ ở chế độ Riêng tư khi bạn vẫn đang thử nghiệm

Mẹo: Mở trình duyệt ở chế độ ẩn danh và truy cập website của bạn để xem chính xác những gì khách truy cập lần đầu nhìn thấy trước khi bạn phát hành chính thức.

Cách theo dõi khách truy cập

Mỗi khách truy cập sẽ được tự động gán một ID ẩn danh duy nhất khi họ bắt đầu cuộc trò chuyện. Lịch sử trò chuyện được lưu lại và liên kết với hồ sơ khách hàng. Nếu CRM được bật, bạn có thể xem toàn bộ lịch sử từ trang Hội thoại.

Telegram

Kết nối chatbot với bot Telegram để người dùng có thể trò chuyện trực tiếp trong ứng dụng Telegram — trên điện thoại hoặc máy tính.

Yêu cầu trước khi bắt đầu

• Tài khoản Telegram (miễn phí tại telegram.org)
• Một bot Telegram, tạo miễn phí bằng @BotFather trong Telegram

Các bước cài đặt

1. Mở Telegram và tìm kiếm @BotFather.
2. Gửi tin nhắn /newbot và làm theo hướng dẫn — bạn sẽ chọn tên và username cho bot.
3. BotFather sẽ cung cấp cho bạn một Bot Token có dạng 123456789:ABCdef-GHIjkl... — sao chép lại.
4. Vào chatbot của bạn → Nền tảng → Thêm nền tảng → Telegram.
5. Dán bot token vào ô nhập liệu và nhấn Lưu.
6. Nền tảng sẽ tự động đăng ký webhook — bot Telegram của bạn đã hoạt động.

Kiểm tra

• Trong Telegram, tìm bot theo username bạn đã chọn.
• Gửi bất kỳ tin nhắn nào — bạn sẽ nhận được phản hồi trong vài giây.

Lưu ý: Telegram gửi tin nhắn qua HTTPS webhook. Điều này hoạt động tự động khi sử dụng nền tảng — không cần cấu hình máy chủ từ phía bạn.

Mẹo: Trong @BotFather, sử dụng lệnh /setdescription và /setuserpic để thêm ảnh đại diện và mô tả cho bot. Điều này tạo sự khác biệt lớn về mức độ chuyên nghiệp mà người dùng cảm nhận được.

Zalo

Kết nối chatbot với Zalo Official Account (OA) để tiếp cận khách hàng Việt Nam qua Zalo — một trong những ứng dụng nhắn tin phổ biến nhất Việt Nam.

Yêu cầu trước khi bắt đầu

• Một Zalo Official Account — đăng ký và xác minh tại developers.zalo.me
• Bot Token và Secret Token từ Zalo Developer Dashboard

Lưu ý: Zalo Official Account cần được Zalo phê duyệt. Đảm bảo OA của bạn đã được xác minh và đang hoạt động trước khi kết nối.

Các bước cài đặt

1. Vào chatbot của bạn → Nền tảng → Thêm nền tảng → Zalo.
2. Nhập Bot Token và Secret Token từ Zalo Developer Dashboard.
3. Nhấn Lưu.
4. Nhấn nút Đặt Webhook — thao tác này tự động đăng ký chatbot làm trình xử lý tin nhắn cho OA của bạn.
5. Trong Zalo Developer Dashboard, xác nhận rằng URL webhook đang hoạt động và OA đã được cấu hình để sử dụng chatbot.

Kiểm tra

• Gửi tin nhắn đến Zalo OA của bạn từ một tài khoản Zalo.
• Bạn sẽ nhận được phản hồi tự động từ chatbot trong vài giây.

Mẹo: Nếu tin nhắn không đến được sau khi làm mới token trên Zalo, hãy quay lại Nền tảng, cập nhật token, lưu và nhấn Đặt Webhook lại.

Zalo OA (Tài khoản chính thức — Ứng dụng ủy quyền)

Kết nối chatbot với Zalo Official Account bằng tích hợp ứng dụng ủy quyền. Đây là phương pháp được khuyến nghị cho Zalo — thay vì quản lý token thủ công, bạn ủy quyền cho ứng dụng của chúng tôi hoạt động thay mặt OA. Việc làm mới token được xử lý tự động.

Yêu cầu trước khi bắt đầu

• Một Zalo Official Account — tạo tại oa.zalo.me
• OA phải được xác minh và đang hoạt động

Các bước cài đặt

1. Mở chatbot của bạn và nhấn tab Nền tảng (hoặc trình chỉnh sửa Chat Flow).
2. Tìm Zalo OA và nhấn Thêm (nút +).
3. Bạn sẽ được chuyển hướng đến trang ủy quyền của Zalo.
4. Đăng nhập Zalo và chọn Official Account bạn muốn kết nối.
5. Cấp các quyền được yêu cầu (đọc tin nhắn, gửi tin nhắn).
6. Bạn sẽ được chuyển hướng về trang chatbot — kết nối hoàn tất tự động.

Cách hoạt động

Ứng dụng của chúng tôi sử dụng OAuth để xin quyền hoạt động thay mặt OA của bạn. Access token được làm mới tự động nên không cần quản lý token thủ công. Tin nhắn từ người theo dõi OA được chuyển tiếp đến chatbot qua webhook, và phản hồi từ chatbot được gửi lại qua Zalo OA API.

Khác biệt so với tích hợp Zalo cũ

Kiểm tra

• Gửi tin nhắn đến Zalo OA từ bất kỳ tài khoản Zalo nào.
• Bạn sẽ nhận được phản hồi tự động từ chatbot trong vài giây.

Lưu ý: Nếu kết nối OA ngừng hoạt động, hãy thử ngắt kết nối và kết nối lại nền tảng Zalo OA. Thao tác này sẽ cấp lại quyền cho token.

Facebook Messenger

Kết nối chatbot với Facebook Page để khách hàng có thể nhắn tin qua Facebook Messenger — trên web hoặc ứng dụng Messenger.

Yêu cầu trước khi bắt đầu

• Một Facebook Page (chỉ trang doanh nghiệp — trang cá nhân không được hỗ trợ)
• Một Facebook Developer App đã bật sản phẩm Messenger (tạo tại developers.facebook.com)
• Page Access Token từ Facebook Developer App → cài đặt Messenger
• Page ID (tìm trong phần Giới thiệu hoặc cài đặt của Page)

Các bước cài đặt

1. Vào chatbot của bạn → Nền tảng → Thêm nền tảng → Facebook.
2. Điền các trường sau:
   • Page ID — ID số của Facebook Page
   • Access Token — sao chép từ Facebook Developer App → Messenger → Page Access Tokens
   • Verify Token — chuỗi bất kỳ do bạn chọn (ví dụ: my-verify-token-2024); bạn sẽ dùng lại chuỗi này ở bước 4
3. Nhấn Lưu.
4. Trong Facebook Developer App, vào Messenger → Webhooks và nhập:
   • Callback URL: https://your-platform-domain.com/api/webhooks/facebook
   • Verify Token: cùng chuỗi bạn đã nhập ở bước 2
5. Đăng ký webhook nhận sự kiện messages.
6. Gửi ứng dụng để Facebook xét duyệt nếu cần (đối với page công khai có nhiều người dùng).

Lưu ý: Facebook yêu cầu tất cả URL webhook phải sử dụng HTTPS. Điều này được xử lý tự động trên nền tảng.

Mẹo: Sử dụng tính năng Test User trong Facebook Developer App → cài đặt Messenger để gửi tin nhắn thử trước khi ứng dụng được Facebook xét duyệt.

API tùy chỉnh

Nếu bạn muốn tích hợp chatbot trực tiếp vào ứng dụng, công cụ nội bộ hoặc sản phẩm bên thứ ba, nền tảng API cho phép kết nối lập trình bằng token bảo mật.

Khả dụng trên: Gói Standard trở lên

Tạo API Token

1. Vào chatbot của bạn → Nền tảng → Thêm nền tảng → API.
2. Nhập tên mô tả cho token — ví dụ: Mobile App hoặc Partner Portal.
3. Nhấn Tạo.
4. Token đầy đủ chỉ hiển thị một lần duy nhất — sao chép ngay và lưu ở nơi an toàn (trình quản lý mật khẩu là lựa chọn tốt).

Cảnh báo: Sau khi bạn rời trang hoặc tải lại, token đầy đủ không thể xem lại được. Nếu bạn mất token, bạn cần xóa và tạo token mới.

Sử dụng token

Đưa token vào header Bearer trong các yêu cầu API:

Authorization: Bearer sk_live_your-token-here

Để xem tài liệu đầy đủ về các endpoint và định dạng yêu cầu, tham khảo Tài liệu API.

Thu hồi token

1. Vào Nền tảng và tìm mục API bạn muốn xóa.
2. Nhấn Xóa.
3. Token bị vô hiệu hóa ngay lập tức — mọi yêu cầu sử dụng token đó sẽ bị từ chối.

Quản lý nền tảng

Xem tất cả nền tảng đã kết nối

Tab Nền tảng liệt kê tất cả tích hợp bạn đã thiết lập, bao gồm loại nền tảng (Web, Telegram, Zalo, Zalo OA, Facebook, API), tóm tắt cấu hình (ví dụ: username bot hoặc tên page), và trạng thái đang hoạt động hoặc không hoạt động.

Cập nhật nền tảng

Nhấn Chỉnh sửa trên bất kỳ nền tảng nào để cập nhật cấu hình:

• Telegram — cập nhật bot token nếu bạn tạo bot mới trong @BotFather
• Zalo / Facebook — cập nhật token khi hết hạn hoặc được thay đổi
• Zalo OA — token tự động làm mới; nếu gặp sự cố, ngắt kết nối và kết nối lại để cấp lại quyền
• Web — mã nhúng không đổi trừ khi ID chatbot thay đổi

Tắt và xóa

Sử dụng Tắt khi bạn muốn tạm dừng một kênh. Chỉ sử dụng Xóa khi bạn chắc chắn không còn cần tích hợp đó.

Xử lý sự cố

Nếu bạn gặp vấn đề không có trong danh sách trên, hãy liên hệ hỗ trợ kèm theo loại nền tảng và mô tả tình trạng bạn đang gặp phải. Chúng tôi sẵn lòng giúp bạn kết nối thành công.