Các bước tạo và Cấu hình tương tự Trigger New Row
Lưu ý: với trigger Update Row hàm chạy sẽ là onUpdateRow
-
Bước 1: Tạo Trigger mới
Thực hiện theo các bước sau:
- Truy cập Bots-Auto → Triggers.
- Chọn kênh Custom Google Sheet
- Thêm mới Trigger Update Row
-
Bước 2: Cấu hình Google Sheet Trigger
-
Tại mục Integrations, chọn kết nối Google.
Nếu chưa có kết nối, nhấn Thêm mới hoặc tạo mới trong Settings → Integrations.
-
Sao chép liên kết (URL) của Google Sheet và dán vào trường URL.
-
Nhấn Reload để hệ thống đọc thông tin từ Google Sheet.
-
Trong mục Cột chứa phone, chọn cột chứa số điện thoại khách hàng.
-
Ánh xạ (Mapping) các cột dữ liệu còn lại trong Google Sheet với các Customer Attributes tương ứng của hệ thống.
-
Bước 3: Lưu Trigger
- Nhấn Save để lưu cấu hình Trigger.
- Sau khi lưu thành công, hệ thống sẽ hiển thị đoạn mã Google Apps Script để kết nối Google Sheet với SmaxAI.
Người dùng có thể lựa chọn một trong hai phương thức đồng bộ dữ liệu sau:
- Manual
- Người dùng nhập trực tiếp (thêm mới) từng dòng dữ liệu vào Google Sheet.
- Khi có dữ liệu mới, Trigger sẽ được kích hoạt và xử lý theo luồng đã cấu hình.
- Automation
- Dữ liệu được thêm vào Google Sheet thông qua API hoặc các hệ thống tích hợp khác.
- Trigger sẽ tự động phát hiện bản ghi mới và thực thi quy trình xử lý mà không cần thao tác thủ công.
Lưu ý
- Đảm bảo Google Sheet đã được cấp quyền truy cập cho tài khoản Google được sử dụng trong Integration.
- Cột Customer Phone là trường bắt buộc để hệ thống nhận diện khách hàng.
- Tên các cột trong Google Sheet nên được đặt rõ ràng và thống nhất để thuận tiện cho việc ánh xạ dữ liệu.
- Sau khi hoàn tất cấu hình, nên thêm một bản ghi thử nghiệm để kiểm tra Trigger hoạt động chính xác.
Bước 1: Mở trình chỉnh sửa Apps Script
-
Mở Google Sheets cần kết nối với SmaxAI.
-
Trên thanh menu, chọn Tiện ích (Extensions) → Apps Script.
-
Google sẽ mở Apps Script trong một tab mới.
-
Tại tệp Code.gs, xóa toàn bộ nội dung mặc định.
-
Sao chép đoạn mã (Apps Script) được hệ thống SmaxAI sinh ra từ bước tạo Trigger và dán vào Code.gs.
-
Nhấn Save để lưu mã nguồn.

\
Bước 2: Tạo Trình kích hoạt trong Google Apps Script
-
Trong giao diện Apps Script, chọn mục Kích hoạt ở thanh menu bên trái.
-
Nhấn Thêm trình kích hoạt.
-
Cấu hình theo nhu cầu sử dụng.

\
-
Trường hợp 1: Trigger Manual
Sử dụng khi người dùng nhập dữ liệu trực tiếp vào Google Sheets.
Cấu hình như sau:
| Thuộc tính | Giá trị |
|---|
| Hàm chạy | onUpdateRow |
| Nguồn sự kiện | Từ bảng tính |
| Loại sự kiện | Đang chỉnh sửa |
\

\
-
Trường hợp 2: Trigger Automation
Sử dụng khi dữ liệu được thêm tự động thông qua API hoặc hệ thống khác.
Cấu hình như sau:
| Thuộc tính | Giá trị |
|---|
| Hàm chạy | onUpdateRow |
| Nguồn sự kiện | Từ bảng tính |
| Loại sự kiện | Đang thay đổi |
\

\
Bước 3: Cấp quyền cho Apps Script
- Sau khi hoàn tất cấu hình Trình kích hoạt, nhấn Save.
- Lần đầu tiên sử dụng, Google sẽ yêu cầu cấp quyền cho Apps Script.
- Chọn tài khoản Google tương ứng.
- Thực hiện các bước xác nhận và cấp quyền truy cập theo hướng dẫn của Google.
- Sau khi cấp quyền thành công, Trigger sẽ được tạo và chuyển sang trạng thái hoạt động.
Lưu ý: Việc cấp quyền chỉ cần thực hiện một lần cho mỗi dự án Apps Script.
Bước 4: Kiểm tra hoạt động
Sau khi hoàn thành cấu hình ở Bước 2 và Bước 3, hãy thêm một bản ghi (record) mới vào Google Sheets để kiểm tra.
Nếu cấu hình chính xác:
- Hệ thống SmaxAI sẽ tự động tạo Customer mới.
- Thông tin khách hàng sẽ được lưu trong danh sách Customers của doanh nghiệp.
- Mỗi record trong Google Sheets chỉ tạo 1 Customer trên hệ thống.
- Trigger chỉ xử lý các bản ghi mới được thêm vào sau khi hoàn tất cấu hình.
- Đảm bảo cột Customer Phone chứa số điện thoại hợp lệ để hệ thống có thể nhận diện và tạo khách hàng.
- Nếu không thấy dữ liệu được đồng bộ, hãy kiểm tra:
- Trigger đã ở trạng thái Enabled.
- Apps Script đã được cấp quyền.
- URL Google Sheets và cấu hình ánh xạ (Mapping) trong SmaxAI là chính xác.
- Hàm và loại Trigger được cấu hình đúng với hình thức nhập dữ liệu (Manual hoặc Automation).