Skip to main content
Trang này tổng hợp các vấn đề phổ biến nhất mà người dùng gặp phải khi sử dụng EVOKA, kèm nguyên nhân và cách xử lý cụ thể. Nếu vấn đề của bạn không có trong danh sách này, hãy gửi yêu cầu hỗ trợ qua email contact@evoka.vn hoặc sử dụng tính năng Ticket trong Tổng quan.

​
Bot & Hội thoại

Nguyên nhân phổ biến:
  1. Bot đang tắt — Bot chưa được bật hoặc đã bị vô hiệu hoá.
  2. Kiến thức chưa sẵn sàng — Tài liệu đang trong trạng thái đồng bộ (Đang xử lý).
  3. Credit hết — Tài khoản không còn đủ credit để xử lý tin nhắn.
  4. Kênh tích hợp lỗi — Kết nối với Facebook/Zalo/Website Widget bị đứt.
Cách kiểm tra và xử lý:
1

Kiểm tra trạng thái bot

Vào Quản lý tin nhắn → chọn phiên chat cụ thể. Kiểm tra toggle Bot phản hồi ở góc trên phải đang bật.Toggle Bot phản hồi đang bật trong phiên chat
2

Kiểm tra Kiến thức

Vào Kiến thức → xem cột Trạng thái của từng tài liệu. Nếu hiện Đang xử lý, hãy chờ quá trình đồng bộ hoàn tất (thường 1–5 phút tuỳ kích thước tài liệu).Kiến thức hiển thị trạng thái Đang tiến hành và Hoàn thành
3

Kiểm tra credit

Vào Tổng quan → xem widget Quota & Credit. Nếu credit về 0, mua thêm hoặc nâng gói tại trang Gói dịch vụ.Tổng quan Dung lượng và Credit còn lại
4

Kiểm tra kênh

Vào Tích hợp → kiểm tra trạng thái kết nối từng kênh. Nếu thấy biểu tượng cảnh báo, thực hiện kết nối lại.
Nếu bot đã tắt mà khách vẫn nhắn tin, tin nhắn sẽ không được xử lý và không có phản hồi nào được gửi đi.
Nguyên nhân phổ biến:
  1. Knowledge chưa đồng bộ xong — Tài liệu mới thêm vào nhưng pipeline xử lý chưa hoàn tất.
  2. Nội dung tài liệu chất lượng thấp — File PDF bị scan ảnh, thiếu text, hoặc định dạng bảng phức tạp.
  3. Cài đặt Prompt chưa phù hợp — System prompt quá rộng hoặc không đủ cụ thể.
  4. Câu hỏi nằm ngoài phạm vi kiến thức — Bot không có thông tin liên quan trong Kiến thức.
Cách xử lý:
  • Vào Kiến thức → kiểm tra tài liệu có trạng thái Hoàn tất chưa.
  • Thử đặt câu hỏi trực tiếp trong Playground (Chat thử) để xem bot phản hồi ra sao.
  • Chỉnh sửa System Prompt trong tab Cài đặt Bot → thêm hướng dẫn cụ thể hơn về phạm vi trả lời.
  • Nếu tài liệu là PDF scan ảnh, hãy convert sang PDF text hoặc nhập nội dung dưới dạng Q&A thủ công.
Thêm câu hỏi & trả lời (Q&A) thủ công vào Kiến thức giúp bot trả lời chính xác hơn cho các câu hỏi quan trọng.

​
Tải lên tài liệu

Dialog Upload tài liệuNguyên nhân và cách xử lý theo từng thông báo lỗi:
Thông báo lỗiNguyên nhânCách xử lý
”Định dạng không được phép upload”Sai loại fileDùng đúng định dạng được hỗ trợ (xem bên dưới)
“Bạn không đủ dung lượng để upload”Vượt quota lưu trữ góiXóa tài liệu cũ hoặc nâng cấp gói
”File empty”File rỗng hoặc bị hỏngKiểm tra lại file trước khi tải lên
Lỗi mạng / timeoutKết nối không ổn địnhKiểm tra mạng và thử lại
Định dạng được hỗ trợ:
  • Tài liệu: .pdf, .docx, .xlsx, .csv, .txt, .md
  • Hình ảnh: .jpg, .jpeg, .png, .gif, .webp
  • Âm thanh: .mp3, .wav, .m4a
  • Video: .mp4, .mov, .avi
Giới hạn kích thước:
  • File thông thường: tối đa 50 MB
  • Ảnh đại diện bot: tối đa 10 MB
File PDF được scan từ ảnh (không có text layer) có thể tải lên thành công nhưng chất lượng đồng bộ sẽ kém hơn. Nên dùng PDF có text để kết quả tốt nhất.
Triệu chứng:
  • Tải lên file thất bại với lỗi “Bạn không đủ dung lượng”
  • Bot không trả lời dù đang hoạt động
  • Tổng quan hiển thị cảnh báo quota
Kiểm tra: Vào Tổng quan → xem Quota & Credit section. Bạn sẽ thấy:Tổng quan Dung lượng sử dụng & Credit
  • Dung lượng lưu trữ còn lại
  • Số credit còn lại trong tháng
  • Tỷ lệ sử dụng theo từng loại (tài liệu, video, âm thanh)
Cách xử lý:
  1. Giải phóng dung lượng — Xóa tài liệu cũ không còn cần thiết trong Kiến thức.
  2. Mua thêm credit — Liên hệ EVOKA để mua Credit Add-On.
  3. Nâng cấp gói — Chuyển lên gói cao hơn để có quota lớn hơn.
Credit được tính theo lượng tin nhắn xử lý và dung lượng tài liệu đồng bộ. Xem chi tiết tại Dung lượng & Credit.

​
Crawl URL & Kiến thức

Nguyên nhân phổ biến:
  1. Website yêu cầu đăng nhập — Nội dung ẩn sau login wall không thể crawl.
  2. Website chặn bot — robots.txt hoặc cơ chế anti-bot ngăn crawler.
  3. Website render bằng JavaScript — Nội dung được render phía client, không có trong HTML tĩnh.
  4. URL không thể truy cập — Server trả về 403/404/timeout.
  5. URL nội bộ/localhost — Hệ thống chặn các địa chỉ IP private vì lý do bảo mật.
Cách xử lý:
1

Kiểm tra URL có thể truy cập không

Mở URL trong trình duyệt ở chế độ ẩn danh (Incognito). Nếu không mở được → URL không hợp lệ.
2

Kiểm tra robots.txt

Truy cập your-domain.com/robots.txt. Nếu có Disallow: / → website đang chặn crawler.
3

Thử crawl trang con cụ thể

Thay vì crawl toàn bộ website, thử nhập URL của từng trang cụ thể (ví dụ: trang sản phẩm, trang giới thiệu).
4

Sao chép nội dung thủ công

Nếu website không thể crawl, sao chép nội dung và tạo tài liệu Q&A hoặc upload file .txt / .docx.
EVOKA sử dụng kết hợp traditional crawling và sitemap scanning. Nếu website có file sitemap.xml, khả năng crawl thành công cao hơn.
Nguyên nhân:
  • File phức tạp (PDF nhiều trang, scan ảnh) cần thời gian xử lý dài hơn.
  • Hệ thống đang có tải cao.
Cách xử lý:
  1. Chờ 5–10 phút rồi refresh trang.
  2. Nếu sau 15 phút vẫn chưa xong → Xóa tài liệu và tải lên lại.
  3. Nếu file PDF bị scan ảnh → convert sang PDF có text layer hoặc nhập nội dung thủ công.
Không xóa tài liệu đang ở trạng thái Đang xử lý ngay lập tức — hãy chờ ít nhất 10 phút trước.

​
Tích hợp Facebook Messenger

Các lỗi thường gặp:
Thông báoNguyên nhânCách xử lý
”State expired”Quá trình xác thực mất quá nhiều thời gian (>10 phút)Bắt đầu lại từ đầu — nhấn Kết nối Facebook
”Invalid state parameter”Phiên xác thực bị gián đoạn hoặc mở trên nhiều tabĐóng tất cả tab → thử lại trên 1 tab duy nhất
”Không tìm thấy page nào”Tài khoản Facebook không có quyền quản lý FanpageĐăng nhập bằng tài khoản Quản trị viên của Fanpage
Kết nối thành công nhưng bot không phản hồiPage chưa subscribe webhookVào cài đặt Fanpage → kiểm tra Subscribed Apps
Điều kiện để kết nối thành công:
  • Tài khoản Facebook phải là Quản trị viên (Admin) của Fanpage cần kết nối.
  • Cần cấp đủ quyền truy cập khi Facebook yêu cầu (pages_messaging, pages_manage_metadata).
  • Fanpage phải ở trạng thái Đã xác minh hoặc Công khai.
1

Kiểm tra quyền tài khoản

Vào Fanpage → Cài đặt → Quyền Trang → xác nhận tài khoản của bạn là Admin.
2

Thực hiện kết nối lại

Trong EVOKA: Bot → Tích hợp → Facebook Messenger → Kết nối lại.
3

Chọn đúng Fanpage

Trên màn hình chọn Page, chọn đúng Fanpage muốn kết nối → nhấn Kết nối Page đã chọn.
Nếu bạn quản lý nhiều Fanpage, màn hình sẽ hiển thị danh sách tất cả Pages để chọn. Chỉ chọn 1 Page cho mỗi bot.
Kiểm tra lần lượt:
  1. Trạng thái bot — Vào Quản lý tin nhắn → chọn phiên chat → đảm bảo toggle Bot phản hồi đang bật.
  2. Subscription webhook — Vào Facebook Developer Console → App của EVOKA → Webhooks → kiểm tra messages và messaging_postbacks đã được subscribe.
  3. Messenger Settings — Trong Fanpage Settings → Messaging → đảm bảo tính năng nhắn tin đang bật.
  4. Test với tài khoản khác — Nhắn tin vào Fanpage bằng tài khoản Facebook cá nhân khác để kiểm tra.
Nếu gửi tin nhắn từ chính tài khoản Admin của Fanpage, bot có thể bỏ qua (echo message filtering). Hãy test bằng tài khoản Facebook khác.

​
Tích hợp Zalo OA

Điều kiện bắt buộc:
  • Zalo OA phải ở trạng thái đã xác minh (Verified OA).
  • Tài khoản Zalo dùng để kết nối phải là Admin của OA.
  • OA phải đã đăng ký Zalo Mini App API hoặc Zalo OA Open API.
Các lỗi thường gặp:
Thông báoNguyên nhânCách xử lý
”State expired”Xác thực timeout (>10 phút)Bắt đầu lại quy trình kết nối
”Invalid state parameter”Phiên bị gián đoạnĐóng tab → thử lại từ đầu
”Zalo OA not found”OA đã bị xóa hoặc mất quyềnKiểm tra lại trạng thái OA trên Zalo
”Failed to connect Zalo OA”Access Token không hợp lệThực hiện kết nối lại để lấy token mới
Zalo không hỗ trợ tin nhắn dạng: Sticker, link, audio, video, vị trí, danh thiếp, và file — bot sẽ tự động trả lời thông báo loại tin nhắn không được hỗ trợ.
1

Kiểm tra OA đã xác minh

Đăng nhập Zalo OA Portal → kiểm tra trạng thái OA.
2

Kết nối lại

Trong EVOKA: Bot → Tích hợp → Zalo OA → Kết nối lại. Làm trong 1 tab duy nhất, không quá 10 phút.
3

Kiểm tra webhook

Trong Zalo OA Portal → Cài đặt → Webhook → đảm bảo URL webhook đang trỏ đúng.

​
Nhúng Widget Website

Trang Tích hợp — preview widget và script nhúngKiểm tra theo thứ tự:
1

Xác nhận bot đang hoạt động

Vào Quản lý tin nhắn → chọn phiên chat → toggle Bot phản hồi phải đang bật.
2

Kiểm tra vị trí script

Script nhúng phải được đặt trước thẻ đóng </body>, không đặt trong <head>.
<!-- ✅ Đúng -->
<body>
  ...nội dung website...
  <script src="https://cdn.evoka.vn/upload/js/evoka-embed.js" bot-code="YOUR_BOT_CODE"></script>
</body>

<!-- ❌ Sai -->
<head>
  <script src="https://cdn.evoka.vn/upload/js/evoka-embed.js" bot-code="YOUR_BOT_CODE"></script>
</head>
3

Kiểm tra Bot Code

Đảm bảo bot-code trong script khớp chính xác với Bot Code trong Cài đặt Bot → Nhúng Widget.
4

Kiểm tra Content Security Policy (CSP)

Nếu website của bạn có CSP, thêm cdn.evoka.vn vào allowlist của script-src và connect-src.
5

Xóa cache trình duyệt

Nhấn Ctrl + Shift + R (Windows) hoặc Cmd + Shift + R (Mac) để reload không dùng cache.
Mở DevTools (F12) → tab Console để xem có lỗi JavaScript liên quan đến script EVOKA không.

​
Tài khoản & Đăng nhập

Nguyên nhân:
  • Token xác thực đã hết hạn (thường sau vài giờ không hoạt động).
  • Đang dùng nhiều thiết bị cùng lúc.
  • Tài khoản bị khóa.
Cách xử lý:
  1. Xóa cache trình duyệt → thử đăng nhập lại.
  2. Dùng chức năng Quên mật khẩu nếu không nhớ mật khẩu.
  3. Liên hệ support nếu tài khoản bị khóa: contact@evoka.vn.
Phiên đăng nhập tự động hết hạn sau một khoảng thời gian không hoạt động để bảo mật tài khoản. Đây là hành vi bình thường.

​
Vẫn cần hỗ trợ?

Nếu bạn đã thử tất cả các bước trên mà vấn đề vẫn chưa được giải quyết:

Gửi email hỗ trợ

Mô tả vấn đề và gửi đến contact@evoka.vn — đội ngũ hỗ trợ sẽ phản hồi trong vòng 1 ngày làm việc.

Xem FAQ

Câu trả lời cho các câu hỏi thường gặp về tài khoản, billing, và tính năng.
Khi liên hệ hỗ trợ, hãy cung cấp: tên tài khoản, tên bot, mô tả chi tiết vấn đề, và ảnh chụp màn hình (nếu có) để được hỗ trợ nhanh nhất.