close

Hướng dẫn kết nối Google Chat với Hermes Agent A-Z

Tác giả: Đông Tùng Ngày đăng: 17/06/2026 Chuyên mục: Hermes Agent
Disclosure
Website Tino blog được cung cấp bởi Tino Group. Truy cập và sử dụng website đồng nghĩa với việc bạn đồng ý với các điều khoản và điều kiện trong chính sách bảo mật - điều khoản sử dụng nội dung. Tino Group có thể thay đổi điều khoản sử dụng bất cứ lúc nào. Việc bạn tiếp tục sử dụng Tino blog sau khi thay đổi có nghĩa là bạn chấp nhận những thay đổi đó.
Why Trust Us
Các bài viết với hàm lượng tri thức cao tại Tino blog được tạo ra bởi các chuyên viên Marketing vững chuyên môn và được kiểm duyệt nghiêm túc theo chính sách biên tập bởi đội ngũ biên tập viên dày dặn kinh nghiệm. Mọi nỗ lực của chúng tôi đều hướng đến mong muốn mang đến cho cộng đồng nguồn thông tin chất lượng, chính xác, khách quan, đồng thời tuân thủ các tiêu chuẩn cao nhất trong báo cáo và xuất bản.

Để kết nối Google Chat với Hermes Agent, bạn tạo Chat App trong một Google Cloud project, cho Google Chat đẩy tin nhắn vào Cloud Pub/Sub, cấp cho Hermes một service account đọc subscription, rồi khai báo project, subscription và file key trong .env của Hermes. VPS không cần mở cổng hay có URL công khai.

Bài thuộc nhóm skills và tích hợp cho Hermes Agent; phần giới thiệu agent có ở bài Hermes Agent là gì. Khi kết nối xong, bạn trò chuyện với agent ngay trong Google Chat, gửi yêu cầu và nhận phản hồi tại môi trường làm việc hằng ngày. Dưới đây là 15 bước cấu hình Google Chat, Cloud Pub/Sub và Hermes Gateway.

Tại sao nên kết nối Google Chat với Hermes Agent?

Kết nối Google Chat biến ứng dụng chat của Google Workspace thành kênh giao tiếp trực tiếp với Hermes Agent: thay vì mở giao diện riêng hoặc terminal, nhân viên nhắn tin cho bot như nhắn đồng nghiệp. Google Chat là kênh chính thức trong gateway của Hermes, dùng Cloud Pub/Sub để nhận tin và Chat REST API để trả lời.

Một số tình huống sử dụng phổ biến gồm:

  • Gửi câu hỏi nhanh cho Hermes Agent trong Google Chat.
  • Tạo trợ lý nội bộ cho nhóm làm việc.
  • Nhận phản hồi tự động từ AI Agent trong cuộc trò chuyện 1:1.
  • Kết hợp Google Chat với các tác vụ Workspace khác như Gmail, Calendar, Drive, Docs hoặc Sheets.
  • Tạo kênh tương tác tiện lợi cho nhân viên, khách hàng hoặc đội vận hành.
Banner Tino Group: Tại sao nên kết nối Google Chat với Hermes Agent

Cách triển khai qua Cloud Pub/Sub là kiến trúc docs Hermes dùng cho Google Chat: tiến trình Hermes tự kéo tin từ subscription giống bot Telegram dùng long-polling, nên không cần tự dựng webhook, tunnel hay chứng chỉ TLS (docs Hermes, Google Chat, xem ngày 26/10/2026).

Thông tin cấu hình cần chuẩn bị

Bạn cần một tài khoản Google Workspace có quyền tạo Chat App, quyền vào Google Cloud Console, một Google Cloud project và VPS đã cài Hermes Agent có thể SSH vào. Theo docs Hermes, tài khoản Gmail cá nhân thường không đủ để chạy Chat App; nên dùng Workspace của doanh nghiệp hoặc tên miền riêng.

  • Tài khoản Google Workspace (tên miền riêng hoặc của công ty) có quyền tạo và cài Chat App.
  • Quyền truy cập Google Cloud Console và một Google Cloud project.
  • VPS/máy chủ đã cài Hermes Agent, có quyền SSH và quyền cấu hình Hermes Gateway.
  • Email Google được phép sử dụng Chat App.

Tác giả chụp ảnh và chạy thử tháng 6/2026. Docs Hermes ngày 26/10/2026 ghi Chat App cần Google Workspace, tài khoản chỉ có Gmail không host được Chat App; nếu bạn dùng Gmail cá nhân mà không thấy mục cấu hình, hãy chuyển sang tài khoản Workspace.

Các bước kết nối Google Chat với Hermes Agent

Kết nối gồm 15 bước, chia ba phần: dựng Pub/Sub và quyền trên Google Cloud (bước 1–8), cấu hình Chat App (bước 9), rồi khai báo và khởi động lại Hermes trên VPS (bước 10–15). Hai chỗ dễ sai là quyền Publisher ở bước 5 và service account thứ hai ở bước 9.

Sơ đồ luồng tin nhắn Google Chat tới Hermes Agent: Google Chat publish vào Topic (quyền Pub/Sub Publisher cho chat-api-push), Topic chuyển sang Subscription kiểu Pull, Hermes gateway trên VPS pull bằng service account có quyền Subscriber và Viewer, trả lời qua Chat REST API

Bước 1: Chọn đúng Google Cloud Project

Đầu tiên, hãy truy cập Google Cloud Console: https://console.cloud.google.com/

Trang Welcome của Google Cloud Console hiển thị project đang chọn

Sau khi đăng nhập, hãy chọn đúng Google Cloud Project dùng để cấu hình Google Chat App và Cloud Pub/Sub.

Nút chọn project ở góc trên Google Cloud Console

Nếu chưa có project, bạn có thể tạo project mới bằng cách:

  1. Nhấn vào khu vực chọn project ở thanh trên cùng.
  2. Chọn New Project.
  3. Nhập tên project, ví dụ: Hermes Google Chat
  4. Nhấn Create.
Hộp thoại Select a project với nút New project
Form New Project: đặt tên project, Parent resource là No organization, nút Create

Chọn lại project vừa tạo để tiếp tục cấu hình.

Google Cloud Console đã chuyển sang project vừa tạo

Lưu ý: Tất cả API, Topic, Subscription, Service Account và Google Chat App nên nằm trong cùng một project để tránh lỗi sai project khi cấu hình.

Bước 2: Bật các API cần thiết

Để Google Chat và Cloud Pub/Sub hoạt động, bạn cần bật 2 API sau:

  • Google Chat API: Cho phép bạn cấu hình Chat App và dùng Chat REST API để phản hồi tin nhắn.
  • Cloud Pub/Sub API: Cho phép tạo Topic, Subscription và xử lý luồng message giữa Google Chat và Hermes Gateway.

Truy cập nhanh trang API Library tại: https://console.cloud.google.com/apis/library

Sau đó thực hiện lần lượt:

Nhập từ khóa Google Chat API -> Chọn kết quả -> Nhấn Enable -> Chờ Google bật API cho project.

Tìm Google Chat API trong API Library
Trang Google Chat API với nút Enable

Sau khi bật thành công, nút Enable sẽ chuyển sang trạng thái đã kích hoạt hoặc giao diện sẽ hiển thị trang quản lý API.

Google Chat API ở trạng thái Enabled

Tương tự, nhập từ khóa Cloud Pub/Sub API -> Chọn kết quả -> Nhấn Enable -> Chờ Google bật API cho project.

Bước 3: Tạo Cloud Pub/Sub Topic

Sau khi bật API, bạn cần tạo Pub/Sub Topic để Google Chat publish event vào.

Truy cập nhanh trang quản lý Topics: https://console.cloud.google.com/cloudpubsub/topic/list

Sau đó thực hiện:

  1. Chọn Topics.
  2. Nhấn Create topic.
  3. Nhập Topic ID: hermes-chat-events
  4. Giữ các tùy chọn mặc định nếu không có yêu cầu đặc biệt.
  5. Kéo xuống nhấn Create.
Mục Pub/Sub, Topics với nút Create topic
Form Create topic với Topic ID hermes-chat-events

Sau khi tạo xong, topic sẽ có tên đầy đủ dạng:

projects/<PROJECT_ID>/topics/hermes-chat-events

Ví dụ:

projects/dulcet-legend-499603-h9/topics/hermes-chat-events
Trang chi tiết topic hermes-chat-events, tab Permissions

Bạn cần lưu lại tên đầy đủ này để dùng ở bước cấu hình Google Chat App.

Bước 4: Tạo Pull Subscription

Tiếp theo, bạn cần tạo Subscription để Hermes Gateway có thể đọc message từ Topic.

Tại trang quản lý Subscriptions:

  1. Chọn Subscriptions.
  2. Nhấn Create subscription.
  3. Nhập Subscription ID: hermes-chat-events-subscription
  4. Chọn Topic vừa tạo: hermes-chat-events
  5. Tại Delivery type, chọn: Pull
  6. Message retention có thể để mặc định hoặc đặt: 7 days
  7. Giữ mặc định các thiết lập khác
  8. Kéo xuống nhấn Create.
Mục Pub/Sub, Subscriptions với nút Create subscription
Form Create subscription: Subscription ID hermes-chat-events-subscription, chọn topic, Delivery type Pull

Sau khi tạo thành công, Subscription sẽ có tên đầy đủ dạng:

projects/<PROJECT_ID>/subscriptions/hermes-chat-events-subscription

Ví dụ:

projects/dulcet-legend-499603-h9/subscriptions/hermes-chat-events-subscription
Subscription hermes-chat-events-subscription ở trạng thái active

Bạn cần dùng tên đầy đủ này khi cấu hình Hermes.

Bước 5: Cấp quyền để Google Chat publish vào Topic

Google Chat cần quyền publish message vào Pub/Sub Topic. Nếu thiếu quyền này, bot có thể hiển thị trong Google Chat nhưng Hermes sẽ không nhận được message.

Truy cập lại danh sách Topic: https://console.cloud.google.com/cloudpubsub/topic/list

Sau đó:

  1. Mở topic: hermes-chat-events
  2. Chọn tab Permissions.
  3. Nhấn Add principal.
  4. Tại ô New principals, nhập: chat-api-push@system.gserviceaccount.com
  5. Tại Role, chọn: Pub/Sub Publisher
  6. Nhấn Save.
Danh sách Topics, chọn topic hermes-chat-events
Tab Permissions của topic với nút Add principal
Thêm principal chat-api-push@system.gserviceaccount.com với role Pub/Sub Publisher

Nếu trong giao diện cấu hình Google Chat có hiển thị thêm service account dạng: service-xxxxxxxxxxxx@gcp-sa-gsuiteaddons.iam.gserviceaccount.com bạn nên cấp thêm quyền Pub/Sub Publisher cho email service account này trên cùng Topic. Việc này giúp tránh trường hợp bot nhận tin nhắn nhưng không publish event vào Pub/Sub, dẫn đến bot im lặng. Phần này sẽ được hướng dẫn ở bước 9.

Bước 6: Tạo Service Account cho Hermes

Hermes Gateway cần một Service Account để đọc message từ Pub/Sub Subscription. Service Account này sẽ được tạo trong Google Cloud và tải key JSON về server Hermes.

Truy cập nhanh trang Service Accounts: https://console.cloud.google.com/iam-admin/serviceaccounts

Sau đó thực hiện:

  1. Chọn Project hiện tại.
  2. Nhấn Create service account.
  3. Nhập Service account name: hermes-chat-bot
  4. Service account ID sẽ được tạo tự động, ví dụ: hermes-chat-bot
  5. Phần cấp quyền project-level có thể bỏ trống.
  6. Nhấn Create and Close để hoàn tất.
Trang IAM & Admin, Service Accounts, chọn project Hermes Google Workspace
Trang Service accounts với nút Create service account
Form Create service account: tên và ID hermes-chat-bot
Form Create service account, nhấn Create and close khi không cần cấp quyền project

Lưu ý: Ở bước tạo service account, bạn chưa cần cấp quyền toàn project. Quyền sẽ được cấp riêng trên Subscription ở bước tiếp theo để đảm bảo nguyên tắc phân quyền tối thiểu.

Bước 7: Tạo key JSON cho Service Account và upload lên Hermes Agent

Tạo key JSON

Sau khi tạo Service Account, bạn cần tạo key JSON để Hermes Gateway sử dụng.

Thực hiện như sau:

  1. Mở Service Account vừa tạo.
  2. Chọn tab Keys.
  3. Nhấn Add key.
  4. Chọn Create new key.
  5. Chọn định dạng: JSON
  6. Nhấn Create.
Service account hermes-chat-bot đã tạo, trạng thái Enabled
Tab Keys của service account, Add key, Create new key
Hộp thoại Create private key, chọn JSON rồi nhấn Create

File JSON sẽ được tải về máy tính. Bạn có thể đổi tên file đơn giản hơn, ví dụ: google-chat-sa

File key google-chat-sa.json vừa tải về máy

Upload file lên server Hermes

Tiếp theo, bạn cần upload file JSON này lên server Hermes tại đường dẫn:

/root/.hermes/google-chat-sa.json

Để thực hiện, bạn có thể dùng SCP, SFTP, WinSCP hoặc FileZilla để upload file.

Ví dụ dùng SCP trên máy tính. Mở PowerShell trên Windows và nhập lệnh:

scp "C:\Users\ADMIN\Downloads\google-chat-sa.json" root@<IP_VPS>:/root/.hermes/google-chat-sa.json

Nhập mật khẩu VPS khi được yêu cầu. Sau đó, file JSON sẽ được upload lên server Hermes.

Lệnh scp trong PowerShell tải google-chat-sa.json lên /root/.hermes trên VPS

Sau khi upload, SSH vào VPS và đặt quyền file:

chmod 600 /root/.hermes/google-chat-sa.json

Xem thêm: cách kết nối SSH tới VPS.

SSH vào VPS và chạy chmod 600 cho file /root/.hermes/google-chat-sa.json

Lệnh này giúp giới hạn quyền đọc file key, tránh rủi ro lộ thông tin xác thực.

Bước 8: Cấp quyền để Hermes đọc Subscription

Hermes Gateway cần quyền đọc Subscription để pull message từ Pub/Sub. Ngoài quyền Subscriber, Hermes cũng cần quyền Viewer vì khi khởi động, Gateway có thể gọi subscription.get() để kiểm tra Subscription.

Truy cập danh sách Subscriptions: https://console.cloud.google.com/cloudpubsub/subscription/list

Sau đó:

  1. Mở subscription: hermes-chat-events-subscription
  2. Chọn tab Permissions.
  3. Nhấn Add principal.
  4. Tại New principals, nhập email Service Account Hermes, dạng: hermes-chat-bot@<PROJECT_ID>.iam.gserviceaccount.com
  5. Thêm role thứ nhất: Pub/Sub Subscriber
  6. Thêm role thứ hai: Pub/Sub Viewer
  7. Nhấn Save.
Danh sách Subscriptions, chọn hermes-chat-events-subscription
Tab Permissions của subscription với nút Add principal
Thêm service account hermes-chat-bot với hai role Pub/Sub Subscriber và Pub/Sub Viewer

Nếu cấu hình đúng, Hermes sẽ có đủ quyền đọc message từ Subscription.

Bước 9: Cấu hình Google Chat App

Sau khi Pub/Sub và Service Account đã sẵn sàng, bạn cần cấu hình Google Chat App để bot hiển thị trong Google Chat.

Truy cập nhanh trang cấu hình Google Chat API: https://console.cloud.google.com/apis/api/chat.googleapis.com/hangouts-chat

Sau đó vào phần Configuration.

Cấu hình thông tin ứng dụng

Ở mục Application info, bạn điền như sau:

  • App name: Hermes Agent
  • Avatar URL: URL ảnh logo dạng HTTPS
  • Description: AI trợ lý Hermes Agent
  • Functionality: bật Receive 1:1 messages và Join spaces and group conversations (theo docs Hermes; nếu giao diện của bạn có mục này).
Application info của Chat App: App name Hermes Agent, Avatar URL dạng HTTPS, Description

Lưu ý:

  • Phần Avatar URL không nhập file trên máy tính được. Google yêu cầu một đường dẫn ảnh công khai dạng HTTPS, ví dụ: https://tenmiencuaban.com/hermes-agent.png. Cách đơn giản là bạn upload logo Hermes Agent lên website/hosting của mình, sau đó lấy link ảnh.
  • Ảnh nên là PNG, vuông 1:1, tối thiểu 256×256 pixel.

Cấu hình Connection settings

Tại phần Connection settings, chọn Cloud Pub/Sub

Sau đó nhập Cloud Pub/Sub Topic Name theo dạng đầy đủ:

projects/<PROJECT_ID>/topics/hermes-chat-events

Ví dụ:

projects/dulcet-legend-499603-h9/topics/hermes-chat-events

Connection settings chọn Cloud Pub/Sub và nhập tên đầy đủ của topic

Lưu ý: Đây phải là Topic đã cấp quyền Publisher cho Google Chat ở bước trước.

Đặc biệt quan trọng:

Lát nữa sau khi Save lần đầu rồi nhấn F5, Google Chat sẽ hiển thị thêm Service Account Email. Hãy copy email này.

Sau khi lưu lần đầu, Connection settings hiện Service Account Email dạng service-…@gcp-sa-gsuiteaddons

Sau đó, quay lại phần Cấp quyền để Google Chat publish vào Topic ở bước 5 và tiến hành tạo thêm một principal khác:

Nhập Service Account Email vào ô New principals vừa copy -> sau đó cấp quyền Pub/Sub Publisher tương tự như principal trước.

Thêm service account gsuiteaddons làm Pub/Sub Publisher trên topic
Topic có hai principal Pub/Sub Publisher: chat-api-push và service-…@gcp-sa-gsuiteaddons

Cấu hình Visibility

Tại phần Visibility, thêm email Google được phép sử dụng bot.

Nếu bạn đang test bằng tài khoản cá nhân hoặc tài khoản Workspace cụ thể, hãy thêm đúng email đó vào Visibility. Nếu sai email, khi vào Google Chat, bạn có thể không tìm thấy bot.

Mục Visibility của Chat App, thêm email được dùng bot rồi nhấn Save

Sau khi cấu hình xong, nhấn Save.

Bước 10: Cấu hình biến môi trường cho Hermes

Trên server Hermes, bạn cần cấu hình các biến môi trường để Hermes Gateway biết project, subscription, service account JSON và danh sách user được phép dùng Google Chat.

Mở file cấu hình môi trường của Hermes. Trên VPS Hermes của Tino như trong ảnh, file mẫu nằm ở thư mục cài /opt/hermes/hermes-agent; với bản tự cài bằng script, docs Hermes dùng ~/.hermes/.env.

Vào thư mục Hermes:

cd /opt/hermes/hermes-agent

Sử dụng lệnh sau để kiểm tra xem file .env có tồn tại không:

ls -la

Bạn hãy nhìn lướt qua danh sách hiện ra xem có thấy file .env hoặc file .env.example không nhé! Thông thường VPS Hermes của Tino sẽ chứa file mẫu .env.example.

Lệnh ls -la trong /opt/hermes/hermes-agent thấy file .env.example

Thực hiện lệnh sau để tạo file .env từ file mẫu:

cp .env.example .env

Sau đó mở bằng vi:

vi .env

Trong vi, làm theo các bước này:

  1. Di chuyển đến cuối file bằng cách nhấn Shift + g rồi nhấn i để chuyển sang chế độ gõ
  2. Dán đoạn cấu hình này vào:
GOOGLE_CHAT_PROJECT_ID=<PROJECT_ID>
GOOGLE_CHAT_SUBSCRIPTION_NAME=projects/<PROJECT_ID>/subscriptions/hermes-chat-events-subscription
GOOGLE_CHAT_SERVICE_ACCOUNT_JSON=/root/.hermes/google-chat-sa.json
GOOGLE_CHAT_ALLOWED_USERS=<EMAIL_ALLOWED>
GOOGLE_CHAT_MAX_MESSAGES=1

Trong đó:

  • GOOGLE_CHAT_PROJECT_ID: ID project Google Cloud.
  • GOOGLE_CHAT_SUBSCRIPTION_NAME: tên đầy đủ của Pull Subscription.
  • GOOGLE_CHAT_SERVICE_ACCOUNT_JSON: đường dẫn file JSON service account trên server.
  • GOOGLE_CHAT_ALLOWED_USERS: email được phép tương tác với bot.
  • GOOGLE_CHAT_MAX_MESSAGES: số lượng message Hermes xử lý mỗi lần pull.

Ví dụ:

GOOGLE_CHAT_PROJECT_ID=dulcet-legend-499603-h9
GOOGLE_CHAT_SUBSCRIPTION_NAME=projects/dulcet-legend-499603-h9/subscriptions/hermes-chat-events-subscription
GOOGLE_CHAT_SERVICE_ACCOUNT_JSON=/root/.hermes/google-chat-sa.json
GOOGLE_CHAT_ALLOWED_USERS=huynhdongtung.74119@gmail.com
GOOGLE_CHAT_MAX_MESSAGES=1
Khối biến GOOGLE_CHAT_ trong file .env của Hermes

Nếu có nhiều người dùng, ghi các email cách nhau bằng dấu phẩy, ví dụ GOOGLE_CHAT_ALLOWED_USERS=ban@congty.vn,dongnghiep@congty.vn. Biến tuỳ chọn GOOGLE_CHAT_HOME_CHANNEL đặt kênh nhận kết quả cron.

Nhấn Esc để thoát chế độ nhập.

Gõ:

:wq

Nhấn Enter để lưu và thoát.

Bước 11: Cài dependency cho Google Chat

Tiếp theo, cài các thư viện Python cần thiết để Hermes làm việc với Google Chat và Pub/Sub.

Chạy lệnh sau trên server:

/root/.local/bin/uv pip install --python /opt/hermes/hermes-agent/.venv/bin/python google-cloud-pubsub google-api-python-client google-auth google-auth-oauthlib google-auth-httplib2

Docs Hermes ngày 26/10/2026 dùng trình cài riêng của adapter: chạy python -m plugins.platforms.google_chat.oauth --install-deps bằng Python của Hermes rồi khởi động lại gateway. Lệnh uv ở trên là cách tác giả chạy trên VPS tháng 6/2026; bản Docker đã có sẵn các thư viện này.

Các dependency này giúp Hermes Gateway:

  • Kết nối Cloud Pub/Sub.
  • Xác thực bằng Service Account.
  • Gọi Google Chat REST API.
  • Xử lý các thư viện auth cần thiết của Google.
Cài thư viện google-cloud-pubsub và google-auth bằng uv pip vào môi trường Python của Hermes

Bước 12: Bật plugin Google Chat Platform

Sau khi cài dependency, bật plugin Google Chat cho Hermes:

hermes plugins enable google_chat-platform

Docs Google Chat hiện hành không liệt kê bước bật plugin; chạy hermes plugins list để xem trạng thái. Nếu adapter đã bật, bỏ qua bước này. Bạn cũng có thể chạy hermes gateway setup và chọn Google Chat để được hướng dẫn từng bước.

Nếu lệnh chạy thành công, plugin Google Chat Platform sẽ được bật trong Hermes.

Lệnh hermes plugins enable google_chat-platform báo plugin đã bật

Bước 13: Restart Hermes Gateway

Sau khi cập nhật .env hoặc bật plugin, bạn cần restart Hermes Gateway để cấu hình mới có hiệu lực.

Lệnh khởi động lại chuẩn của Hermes là:

hermes gateway restart

Trên VPS chạy gateway bằng systemd như trong bài, lệnh tương đương là:

systemctl restart hermes-gateway

Bước 14: Test bot trong Google Chat

Sau khi gateway khởi động, log có dòng [GoogleChat] Connected; project=…. Lúc này bạn kiểm tra bot trong Google Chat.

Truy cập: https://chat.google.com/

Sau đó thực hiện:

  1. Bấm Cuộc trò chuyện mới.
  2. Gõ trực tiếp Hermes Agent vào ô Thêm 1 hoặc nhiều người.
  3. Khi bot hiện ra, bấm chọn bot để mở ứng dụng. Có thể được yêu cầu cài đặt.
  4. Gửi tin nhắn test, ví dụ: Chào Bot
  5. Chờ bot phản hồi.
Tìm ứng dụng Hermes Agent trong Google Chat để bắt đầu trò chuyện
Bot Hermes Agent trả lời tin nhắn thử trong Google Chat

Bạn nên thử gõ trực tiếp tên bot trong ô thêm người trước. Nếu không thấy bot, lúc đó mới dùng tùy chọn Tìm ứng dụng và tìm Hermes Agent.

Lưu ý: Không tìm bot này trong Google Workspace Marketplace nếu đây là private/test Chat App. App private/test không phải app public Marketplace nên có thể không xuất hiện ở Marketplace.

Bước 15: Kiểm tra nếu bot không phản hồi

Nếu bot đã hiện trong Google Chat nhưng không phản hồi, hãy kiểm tra lại các điểm sau:

  • Topic name trong Google Chat App có đúng không.
  • Google Chat đã được cấp quyền Pub/Sub Publisher trên Topic chưa.
  • Service account chat-api-push@system.gserviceaccount.com đã có quyền Pub/Sub Publisher chưa.
  • Nếu UI Google Chat hiển thị service account dạng service-…@gcp-sa-gsuiteaddons.iam.gserviceaccount.com, email này đã được cấp Pub/Sub Publisher chưa.
  • Hermes Service Account đã có quyền Pub/Sub Subscriber và Pub/Sub Viewer trên Subscription chưa.
  • File service account JSON đã nằm đúng tại /root/.hermes/google-chat-sa.json chưa.
  • File JSON đã được chmod 600 chưa.
  • Dependency đã cài đầy đủ chưa.
  • Plugin google_chat-platform đã bật chưa.
  • Gateway đã restart sau khi đổi .env chưa.

Phần lớn lỗi bot không phản hồi đến từ sai Topic Name hoặc thiếu quyền Pub/Sub Publisher cho Google Chat. Mẹo theo docs: mở subscription trên Google Cloud Console xem có tin chưa được nhận không. Có tin tồn đọng nghĩa là Hermes chưa xác thực được (kiểm tra file JSON và quyền Subscriber); không có tin nào nghĩa là Google Chat chưa publish được vào Topic.

Khi nào không nên dùng Google Chat cho Hermes Agent?

Không nên chọn Google Chat khi bạn chỉ có tài khoản Gmail cá nhân, khi cần bot công khai cho khách bên ngoài tổ chức, hoặc khi agent hay trả lời dài và dồn dập. Chat API mặc định giới hạn khoảng 60 tin mỗi phút cho một space, nên phản hồi dài bị tách nhỏ và có thể chậm.

  • Cá nhân không có Workspace: dùng Telegram hoặc Discord với bot token chính thức.
  • Cần đọc email, lịch, Drive thay vì chat: dùng kết nối Google Workspace với Hermes Agent.
  • Nhiều người ngoài công ty nhắn bot: Chat App ở chế độ thử nghiệm chỉ hiện cho email trong Visibility, không lên Marketplace.

Các bài viết liên quan:

Kết luận

Kết nối Google Chat với Hermes Agent phù hợp khi đội của bạn đã làm việc trên Google Workspace. Làm đúng hai chỗ quyền ở bước 5 và bước 9, giữ file key ở chế độ chmod 600, giới hạn email trong GOOGLE_CHAT_ALLOWED_USERS, Google Chat sẽ thành kênh nhắn tin ổn định để giao việc cho agent hằng ngày.

Muốn chạy Hermes Agent 24/7 mà không tự cài? VPS Hermes Agent của Tino cài sẵn Hermes Agent trên VPS NVMe đặt tại Việt Nam; bạn vẫn có quyền root để cấu hình. Xem cấu hình và giá trên trang sản phẩm.

Bạn dùng trong 30 ngày, không hài lòng được hoàn 100% (xem điều kiện).

Những câu hỏi thường gặp

Vì sao cần cấp quyền Pub/Sub Publisher cho Google Chat?

Google Chat cần quyền Pub/Sub Publisher để gửi event tin nhắn vào Pub/Sub Topic. Nếu thiếu quyền này, bot vẫn có thể xuất hiện trong Google Chat nhưng Hermes Agent sẽ không nhận được nội dung tin nhắn, dẫn đến tình trạng “Hermes Agent hiện không phản hồi”.

Service account service-…@gcp-sa-gsuiteaddons.iam.gserviceaccount.com dùng để làm gì?

Đây là service account do Google tạo cho Chat App khi bạn cấu hình kết nối qua Cloud Pub/Sub. Trong một số trường hợp, ngoài chat-api-push@system.gserviceaccount.com, bạn cần cấp thêm quyền Pub/Sub Publisher cho service account dạng service-…@gcp-sa-gsuiteaddons.iam.gserviceaccount.com trên cùng Topic để Google Chat có thể publish message thành công.

Hermes Agent cần những quyền nào trên Pub/Sub Subscription?

Service Account của Hermes, ví dụ hermes-chat-bot@<PROJECT_ID>.iam.gserviceaccount.com, nên được cấp ít nhất 2 quyền trên Subscription: Pub/Sub Subscriber; Pub/Sub Viewer. Quyền Pub/Sub Subscriber giúp Hermes đọc message từ Subscription. Quyền Pub/Sub Viewer giúp Gateway kiểm tra thông tin Topic, Subscription và trạng thái kết nối khi khởi động.

Sau khi sửa file .env, có cần restart Hermes Gateway không?

Có. Sau khi đổi các biến GOOGLE_CHAT_PROJECT_ID, GOOGLE_CHAT_SUBSCRIPTION_NAME, GOOGLE_CHAT_SERVICE_ACCOUNT_JSON hoặc GOOGLE_CHAT_ALLOWED_USERS, chạy hermes gateway restart (hoặc systemctl restart hermes-gateway nếu gateway chạy bằng systemd) để cấu hình mới có hiệu lực.

Đông Tùng

Senior Technology Writer

Là cử nhân Quản trị kinh doanh của Trường Đại học Tài chính - Marketing, Tùng bắt đầu làm việc tại Tino Group từ năm 2021 ở vị trí Content Marketing để thỏa mãn niềm đam mê viết lách của bản thân. Sở hữu khả năng sáng tạo đặc biệt, anh cùng đội ngũ của mình đã tạo nên những chiến dịch quảng cáo độc đáo cùng vô số bài viết hữu ích về nhiều chủ đề khác nhau. Sự tỉ mỉ, kiên trì và tinh thần sáng tạo của Tùng đã góp phần lớn vào thành công của Tino Group trong lĩnh vực marketing trực tuyến.

Xem thêm bài viết

Bài viết liên quan

Xem nhiều