Google Sheets

Kết nối AI Agent với Google Sheets để những điểm hữu ích trong đối thoại, như khách đủ điều kiện, câu hỏi chưa trả lời, đề xuất tính năng hoặc yêu cầu demo, trở thành hàng trong bảng nhóm đang dùng. Không Zapier, webhook hay mã: kết nối chỉ một nhấp và tạo AI Action thông thường có thể chỉnh sửa.

Kiểm tra ví dụ tùy chọn

• Xem trước khóa siêu dữ liệu. Kiểm tra tên trường trở thành khóa biến thế nào, gồm trùng tên và lỗi khóa dành riêng. Không kiểm tra giá trị hoặc quyền riêng theo tài khoản.

• Kiểm tra điều kiện chạy Action. Đánh giá điều kiện trên siêu dữ liệu mẫu mà không chạy Action.

Cách hoạt động

AI Action là yêu cầu HTTP có mô tả, và ghi một hàng Google Sheet là một yêu cầu như vậy. Google Sheets có endpoint append thêm hàng vào tab; mỗi lần ghi là POST tới endpoint với giá trị hàng trong nội dung.

Một số điểm cần biết trước:

• Cột không cố định. Cột là những gì Action gửi. Bạn quyết định bằng cách sửa nội dung yêu cầu và hàng tiêu đề, nên cùng tích hợp có thể ghi khách tiềm năng, lỗi hoặc dữ liệu khác.
• Quyền tối thiểu. Kết nối Google chỉ yêu cầu phạm vi drive.file, cấp quyền riêng các tệp tích hợp tạo. Nó không thấy phần còn lại của Drive.
• AI không thấy thông tin xác thực. Yêu cầu có tiêu đề Authorization đặt thành placeholder {{google_sheets_access_token}}. Quickchat điền token thật tự gia hạn sau khi mô hình xong việc; token không vào prompt.

Kết nối Google Sheets

Mở Actions và MCPs, nhấp Thêm Action rồi chọn Google Sheets.

Trước khi cấp quyền, hộp thoại giải thích một nhấp sẽ tạo gì: Google Sheet mới trong Drive và Action ghi dữ liệu sẵn dùng, mặc định cho khách tiềm năng. Nhấp Kết nối, chọn tài khoản Google chứa sheet rồi chấp thuận quyền drive.file.

Một nhấp tự làm hai việc:

1. Tạo bảng tính trong Google Drive, có tab Leads và hàng tiêu đề.
2. Thêm một AI Action đang tắt (log_lead_to_google_sheet), đã nối tới sheet.

Ghi chú

Nếu xóa Action khởi đầu, mở lại Thêm Action → Google Sheets rồi dùng Kết nối lại: Action được tạo lại và dùng sheet cũ, không tạo sheet thứ hai.

Action ghi dữ liệu được tạo

Action khởi đầu là API Action thông thường, chỉnh sửa đầy đủ được. Nó nằm trong Actions tùy chỉnh và đang tắt để bạn xem trước khi bật.

Vì Quickchat tạo sheet và Action cùng nhau, URL endpoint đã có ID bảng tính:

https://sheets.googleapis.com/v4/spreadsheets/<your sheet ID>/values/Leads:append?valueInputOption=RAW

Giữ valueInputOption=RAW để tin bắt đầu bằng = hoặc + được lưu nguyên văn, không phân tích thành công thức. Tiêu đề giống nhau cho mọi loại báo cáo:

Khóa	Giá trị
Authorization	Bearer {{google_sheets_access_token}}
Content-Type	application/json

Nội dung yêu cầu là một hàng, mỗi ô là một tham số. Ô theo cùng thứ tự cột trong sheet:

{ "values": [["{{email}}", "{{what_they_asked}}", "{{conversation_url}}", "{{conversation_channel}}"]] }

Vì vậy, cột được định nghĩa bởi nội dung này và hàng tiêu đề tab, không mã hóa cứng trong tích hợp. {{conversation_url}} (liên kết trực tiếp về Hộp thư đến) và {{conversation_channel}} (nguồn khách) là biến có sẵn cho mọi Action.

Xem lại tham số và Mô tả (AI đọc mô tả để quyết định khi ghi hàng), rồi bật Action.

Ghi mọi dữ liệu, không chỉ khách tiềm năng

Để thêm báo cáo, tạo tab mới trong sheet và thêm API Action ghi vào đó. Sao chép URL đầy đủ từ Action khách tiềm năng, chỉ đổi tên tab rồi điều chỉnh tham số, nội dung và mô tả:

https://sheets.googleapis.com/v4/spreadsheets/<your sheet ID>/values/Unanswered:append?valueInputOption=RAW

Báo cáo phổ biến ngoài khách tiềm năng:

Báo cáo	Khi nào Agent ghi hàng
Câu hỏi chưa trả lời	Agent không trả lời được câu hỏi thực tế, khách yêu cầu nhân viên hoặc có vẻ không hài lòng
Phản hồi	Khách yêu cầu tính năng, báo lỗi hoặc khen
Yêu cầu demo	Khách yêu cầu rõ ràng demo, cuộc gọi hoặc gặp đội bán hàng

Mẹo

Thêm cột bằng cách thêm tham số vào nội dung và tiêu đề tương ứng trong sheet. Dùng {{metadata_*}} để ghi dữ liệu đã có trong đối thoại. Xem Biến AI Action cho danh sách đầy đủ.

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

Cần Zapier, webhook hay mã không? Không. Quickchat kết nối trực tiếp Google Sheets qua AI Action, tức yêu cầu HTTP gốc Agent thực hiện trong đối thoại. Một nhấp tạo sheet và Action ghi đầu tiên.

Dữ liệu Google Drive có an toàn không? Có. Tích hợp chỉ yêu cầu phạm vi OAuth drive.file, chỉ cho tệp nó tạo như sheet dành cho bạn. Không đọc hay đổi nội dung khác trong Drive, và token không bao giờ lộ cho mô hình AI.

Hoạt động trên kênh nào? Tất cả. Cùng Actions chạy ở mọi nơi Agent được triển khai (widget, Slack, WhatsApp, v.v.), và cột {{conversation_channel}} ghi nguồn từng hàng.

Liên quan

• Actions tùy chỉnh: cách AI Actions hoạt động và chỉnh sửa.
• Biến AI Action: placeholder {{...}} có thể đưa vào hàng.
• Kết nối AI Agent với Google Sheets: hướng dẫn đầy đủ xây và tinh chỉnh cả bốn báo cáo.