How-To Series · 5: Everywhere You Are

Google Chat

Connect Hermes to Google Chat using Cloud Pub/Sub. No public URL, no tunnel.

After this videoYou can run your Hermes agent in Google Chat without exposing a public endpoint

Google Chat connects Hermes through Cloud Pub/Sub pull subscriptions for inbound events and the Chat REST API for outbound messages, so no public URL or tunnel is needed. You enable the Chat and Pub/Sub APIs, create a service account and JSON key, and create a topic and pull subscription with the right IAM bindings. Then you point Hermes at the subscription, authorize users by email, and install the bot in a space. Native attachments need a one-time per-user OAuth flow via /setup-files.

About these resources. This episode explains how to set up Google Chat in Hermes. The Sources block names the Hermes docs page that backs every claim.

Sources · What this video distills

1 docs page · every command below traces to one of them

Primary guide

Google Chat

Commands shown · Copy and paste

each shows the source doc it came from

Install the Google Chat dependenciesfrom source ↗

pip install google-cloud-pubsub google-api-python-client google-auth google-auth-oauthlib

Configure Google Chat in Hermesfrom source ↗

hermes gateway setup

Start the gatewayfrom source ↗

hermes gateway

Going deeper · Related Hermes docs

further reading · not sources of facts shown above

Messaging Platforms overview

All messaging integrations at a glance.

Microsoft Teams Setup

Another workplace messaging platform.

Next in the series · Episodes that build on this