Kết nối GomIO với phần mềm khác

Ba cách nối GomIO với phần mềm khác, đều ở bản thử nghiệm. Hai cách đầu dành cho chủ tổ chức và quản trị. Theo gói: Ứng dụng AI trên máy này và Webhook ra cần gói Business; công cụ gọi API của cửa hàng (Trợ lý AI → Công cụ) cần gói Pro. Hạ gói thì webhook ngừng gửi và không gửi bù, còn trợ lý lặng lẽ thôi gọi công cụ dù công cụ vẫn còn trong danh sách.

Cho Claude Desktop, Claude Code, Cursor đọc dữ liệu

Ứng dụng AI cài trên chính máy chạy GomIO đọc được hội thoại, hồ sơ khách và số liệu. Mục này chỉ có trên macOS; bản Windows chưa bật.

Vào Cài đặt → Hệ thống → Kết nối → Ứng dụng AI trên máy này, bấm Cấp phép.
Đặt Tên gợi nhớ và tick những việc được làm: Tìm hội thoại, Đọc một hội thoại, Tra khách hàng, Xem số liệu.
Hộp thoại Dán đoạn này vào ứng dụng AI hiện ra. Chọn tab ứng dụng của bạn và làm theo các bước đánh số: Claude Desktop, Cursor dán cấu hình vào một tệp rồi thoát hẳn ứng dụng (Command + Q), mở lại; Claude Code dán một lệnh vào Terminal rồi gõ /mcp.

Giữ nguyên đường dẫn dài trong đoạn cấu hình. Hộp thoại này không mở lại được: lỡ đóng thì cấp phép mới và thu hồi cái cũ.

Ứng dụng AI đọc đến đâu?

Nó đọc bằng quyền của tài khoản bạn đang đăng nhập, nên chỉ thấy chi nhánh bạn thấy, và chỉ đọc: không gửi tin cho khách, không sửa hồ sơ. Số điện thoại, email hiện dạng che nếu tài khoản không có quyền xem đầy đủ. GomIO không gửi gì ra Internet, nhưng nội dung tin ứng dụng AI đọc đi vào cuộc trò chuyện với hãng làm ra nó; chỉ hỏi số liệu thì chỉ tick Xem số liệu.

Hết cần thì bấm Thu hồi: quyền mất ngay. Khởi động lại ứng dụng AI sau đó, vì nó không tự nối lại.

Webhook ra: báo sự kiện sang CRM

GomIO tự gọi sang phần mềm của bạn khi có sự kiện. Nhờ người làm kỹ thuật bên đó đưa một địa chỉ nhận bắt đầu bằng https://.

Vào Cài đặt → Hệ thống → Kết nối → Webhook ra (CRM), bấm Đăng ký địa chỉ, điền tên, địa chỉ và tick sự kiện muốn báo. Hai ô Kèm nội dung tin nhắn và Kèm số điện thoại và email đầy đủ mặc định tắt; chỉ bật khi bên kia cần.
Chuỗi bí mật hiện đúng một lần. Chép ngay và gửi cho người làm phần mềm bên kia; mất thì xoá địa chỉ rồi đăng ký lại.
Bấm Gửi thử; mọi lần gửi xem ở Nhật ký (30 ngày).

Bên nhận kiểm chữ ký: X-Gomio-Signature là sha256= cộng HMAC-SHA256 (hex), khoá là bí mật, nội dung là X-Gomio-Timestamp, dấu chấm, rồi gói tin nguyên văn. Nên từ chối gói lệch quá 5 phút.

Bên nhận lỗi tạm thì GomIO thử lại, giãn dần tới một giờ. Lỗi 4xx khác báo Hỏng hẳn — kiểm tra hệ thống nhận; sửa xong bấm Gửi lại. Hỏng hẳn 20 lần liên tiếp thì địa chỉ Tự tắt vì hỏng liên tiếp; bật lại ở menu ⋯, sự kiện lúc tắt không gửi bù. Địa chỉ mạng nội bộ (192.168.x.x…) bị từ chối.

Công cụ: cho trợ lý hỏi API của cửa hàng

Phần mềm bán hàng có API trả JSON qua https thì trợ lý tra được tồn kho, tình trạng đơn. Màn hình ở Trợ lý AI → Công cụ; trợ lý cấu hình ở Bật trợ lý AI.

Thêm tên miền vào Tên miền được phép, rồi Thêm công cụ và viết Mô tả cho trợ lý đủ bốn phần: dùng khi, không dùng khi, tham số, trả về.
Tab Chạy thử: nút Kích hoạt mờ đi cho tới khi chạy thử thành công một lần.
Thêm công cụ vào Cài đặt → Cách làm việc → Chính sách, tab Nguồn thông tin, mục Công cụ, ô Công cụ AI được phép dùng. Ô này chỉ hiện ở mức Nâng cao (đổi Mức thiết lập hoặc bấm Xem nâng cao). Để trống là trợ lý không gọi công cụ nào; bước này hay quên nhất.

Công cụ ghi dữ liệu không chạy thẳng: mỗi lần trợ lý đề xuất, hộp thư hiện khối Trợ lý đề xuất một thao tác để nhân viên Xác nhận, Sửa hoặc Từ chối.