Lỗi Ingest Google Sheet: Bot Không Đọc Được Dữ Liệu – Cách Xử Lý

Lỗi ingest Google Sheet bot không đọc được dữ liệu

Khắc phục lỗi bot không đọc được dữ liệu từ Google Sheet khi ingest, hướng dẫn kiểm tra quyền, định dạng và API chi tiết.

Việc đồng bộ bảng tính sản phẩm vào hệ thống là một trong những bước quan trọng nhất để tạo ra một trợ lý ảo thông minh. Tuy nhiên, đôi khi bạn sẽ gặp tình huống lỗi ingest google sheet chatbot không đọc được, khiến bot trả lời sai giá, không hiện ảnh hoặc hoàn toàn im lặng khi khách hàng hỏi mua.

Thay vì phải tạo ticket chờ đội ngũ kỹ thuật hỗ trợ, bài viết này sẽ giúp bạn tự sửa lỗi upload google sheet một cách nhanh chóng. Dưới đây là các nguyên nhân phổ biến khiến chatbot không đọc sheet và hướng dẫn xử lý dứt điểm.

Bot báo lỗi khi ingest Sheet

Khi bạn dán link Google Sheet vào Dashboard và nhấn nút “Đồng bộ”, hệ thống sẽ tiến hành một quá trình gọi là Ingest (Nạp dữ liệu). Nếu quá trình ingest sheet thất bại, trên màn hình thường sẽ hiển thị thanh thông báo lỗi màu đỏ (Error/Failed).

Tuy nhiên, có một trường hợp nguy hiểm hơn: Hệ thống báo “Success” (Thành công) nhưng lỗi chatbot không đọc sheet vẫn xảy ra khi chat thực tế. Nguyên nhân của hiện tượng “thành công giả” này thường đến từ việc dữ liệu bên trong file bị rác, sai cột hoặc thiếu quyền truy cập sâu. Hãy rà soát tuần tự theo các lỗi dưới đây.

Lỗi Permission: Chưa share đúng quyền

Đây là nguyên nhân số 1 khiến quá trình đồng bộ thất bại ngay từ giây đầu tiên. Hệ thống chatbot hoạt động như một “người dùng ẩn danh” truy cập vào link của bạn. Nếu file đang ở chế độ bảo mật nội bộ, bot sẽ bị chặn đứng ngoài cửa.

  • Dấu hiệu: Màn hình Dashboard báo lỗi 403 Forbidden hoặc Permission Denied.

  • Cách khắc phục:

    1. Mở file Google Sheet của bạn.

    2. Nhấn nút Chia sẻ (Share) ở góc trên bên phải.

    3. Đổi quyền Truy cập chung từ Bị hạn chế (Restricted) sang Bất kỳ ai có đường liên kết (Anyone with the link).

    4. Cột vai trò bên cạnh chọn Người xem (Viewer).

    5. Quay lại Dashboard và nhấn Ingest lại.

Lỗi Format: Cột bị sai kiểu dữ liệu

Nếu quyền truy cập đã mở nhưng bot vẫn báo sai giá hoặc không nhận diện được sản phẩm, 99% lỗi nằm ở cách bạn định dạng bảng tính.

  • Dấu hiệu: Bot hiển thị sai con số, thiếu thuộc tính, hoặc không thể render (hiển thị) thẻ Card sản phẩm. Quá trình ingest có thể báo lỗi Invalid Format hoặc Mapping Error.

  • Cách khắc phục:

    • Cột Giá (Price): Phải là số thuần túy (VD: 500000). Tuyệt đối không nhập chữ như 500.000 VNĐ, Liên hệ hay 500k.

    • Tiêu đề cột (Headers): Không được đổi tên các cột bắt buộc đã được hệ thống quy định (như sku, name, price, image). Đảm bảo hàng 1 luôn là hàng tiêu đề.

    • Không gộp ô: Tuyệt đối không sử dụng tính năng Merge Cells. AI đọc dữ liệu theo từng dòng độc lập, gộp ô sẽ làm gãy cấu trúc mảng.
      👉 Để rà soát lại cấu trúc chuẩn, hãy đối chiếu file của bạn với bài viết: Format Google Sheet Chuẩn Cho Chatbot: Cột, Kiểu Dữ Liệu & Template.

URL Sheet bị thay đổi hoặc hết hạn

Nhiều quản trị viên có thói quen nhân bản (Duplicate) file Sheet sang một file mới vào mỗi đầu tháng để làm báo cáo, sau đó xóa file cũ đi mà quên cập nhật lại trên hệ thống bot.

  • Dấu hiệu: Hệ thống báo 404 Not Found hoặc Sheet ID Invalid.

  • Cách khắc phục:

    1. Đảm bảo file Google Sheet gốc chưa bị xóa hoặc di chuyển vào thư mục cấm.

    2. Nếu bạn làm việc trên một Tab mới (Sheet 2, Sheet 3…), thông số gid=... ở cuối đường link URL sẽ thay đổi. Hãy copy lại chính xác đường link của Tab đang chứa dữ liệu sản phẩm, dán đè lên link cũ trong Dashboard và đồng bộ lại.

Sheet có quá nhiều hàng (Dữ liệu rác)

Khi bạn sử dụng file Sheet quá lâu, đôi khi bạn vô tình tạo ra hàng chục ngàn dòng trống (Empty rows) ở phía dưới cùng, hoặc file chứa quá nhiều cột công thức tính toán phức tạp (VLOOKUP, IF) không cần thiết cho bot.

  • Dấu hiệu: Quá trình Ingest xoay vòng rất lâu (Timeout) rồi báo lỗi Payload Too Large hoặc Processing Error.

  • Cách khắc phục:

    1. Cuộn xuống dòng dữ liệu cuối cùng của bạn.

    2. Chọn dòng trống ngay bên dưới, nhấn tổ hợp phím Ctrl + Shift + Mũi tên xuống để bôi đen toàn bộ các dòng thừa.

    3. Nhấn chuột phải -> Xóa các hàng (Delete rows).

    4. Chỉ giữ lại dạng Text (Văn bản thuần), loại bỏ các cột nháp không liên quan đến cấu trúc của bot.

Lỗi ảnh: URL không Accessible

Sản phẩm được bot tìm thấy, giá hiển thị đúng, nhưng thẻ Card lại bị một khoảng trắng mờ hoặc hiện icon ảnh bị gãy.

  • Dấu hiệu: Chatbot trả lời được chữ nhưng không hiện được hình ảnh.

  • Cách khắc phục:

    • Chatbot không thể đọc file ảnh tải trực tiếp lên ô (Insert Image in Cell).

    • Cột image bắt buộc phải là một đường link URL.

    • Nếu bạn dùng link Google Drive, Facebook Messenger và trình duyệt Web thường không thể render được do Google chặn hotlink. Tốt nhất, hãy lấy đường link ảnh trực tiếp (.jpg, .png) từ thư viện Media trên website của bạn.
      👉 Xem thêm cách tối ưu hiển thị thẻ ảnh tại: Cách Nạp Catalog Sản Phẩm Từ Google Sheet Vào Bot Website.

Cách test sau khi sửa (Checklist Debug)

Sau khi đã rà soát và điều chỉnh các lỗi trên, hãy thực hiện quy trình debug chatbot sheet theo 4 bước sau để đảm bảo hệ thống đã hoạt động trơn tru:

  1. Re-ingest: Vào Dashboard, dán lại link Sheet và nhấn “Đồng bộ lại”. Chờ thông báo Success.

  2. Kiểm tra Chunks: Xem số lượng dữ liệu (Documents/Chunks) trong hệ thống có khớp với số dòng sản phẩm trong Sheet hay không. (Nếu Sheet có 100 sản phẩm mà hệ thống báo chỉ nạp 10, nghĩa là file vẫn đang bị lỗi dòng rỗng hoặc gộp ô).

  3. Test Prompt: Mở khung chat Preview, gõ đúng tên một sản phẩm vừa mới thêm vào Sheet.

  4. Check Card: Nhìn xem ảnh có rõ nét không, giá tiền có đúng định dạng không, và bấm vào nút xem link có điều hướng về đúng trang mua hàng không.

(Lưu ý: Bạn nên kết hợp kiểm tra cùng lúc với dữ liệu website để có bức tranh toàn cảnh. Xem hướng dẫn tại Nạp Dữ Liệu Vào Chatbot AI: Google Sheet & Sitemap – Hướng Dẫn Đầy Đủ.

Câu hỏi thường gặp (FAQ)

1. Sửa file Sheet xong thì bot có tự động cập nhật không?

Không. AI không theo dõi bảng tính của bạn theo thời gian thực (Real-time). Mỗi khi có thay đổi về giá hay thêm sản phẩm mới, bạn bắt buộc phải vào Dashboard nhấn nút Ingest (Đồng bộ) để bot nạp lại trí nhớ.

2. Tôi lỡ sửa tên cột trong file Sheet thì có sao không?

Hệ thống dựa vào Tiêu đề cột (Headers ở dòng 1) để ánh xạ dữ liệu (Mapping). Nếu bạn đổi price thành gia_ban, hệ thống sẽ không tìm thấy cột giá, dẫn đến việc bot không thể báo giá sản phẩm. Tuyệt đối không tự ý đổi tên cột mặc định.

3. Làm sao để biết chính xác tôi đang mắc lỗi ở dòng nào trong số hàng ngàn sản phẩm?

Hãy chia nhỏ (Split) bảng dữ liệu. Bạn tạo một file Sheet mới, copy khoảng 50 sản phẩm đầu tiên vào và Ingest thử. Nếu thành công, tiếp tục copy các phần sau. Cách này giúp bạn nhanh chóng khoanh vùng được đoạn dữ liệu chứa ký tự lạ gây lỗi hệ thống.

Có thể bạn quan tâm

Mimo Group
Chuyên SEO, thiết kế website và marketing online cho doanh nghiệp.