Google Chat — AI di Google Workspace

Bayangkan asisten AI kamu akhirnya punya kursi di meja kantor—tepat di dalam Google Chat, tempat timmu sudah ngobrol sepanjang hari.

Itulah yang Hermes Agent lakukan. Tanpa perlu menyiapkan server web publik, tunnel, atau berurusan dengan sertifikat TLS, kamu menghubungkan bot kamu ke Google Chat seperti mencolokkan earphone: langsung jalan. Hermes mendengarkan lewat subscription privat, dan saat seseorang mengirim pesan ke bot, ia merespons melalui Chat REST API. Tidak ada port yang terbuka, tidak ada aturan firewall, tidak ada panik tengah malam karena “URL-ku kenapa down?”

Yang Kamu Butuhkan

Proyek Google Cloud (paket gratis sudah cukup)
Akun Google Workspace (pribadi atau kantor, dengan hak admin)
Sekitar 15 menit

Langkah 1: Buat Proyek Google Cloud

Buka console.cloud.google.com dan buat proyek. Catat project ID—kamu akan menggunakannya di mana-mana. Anggap saja itu alamat rumah bot kamu.

Langkah 2: Aktifkan Dua API

Di APIs & Services → Library, aktifkan:

Google Chat API
Cloud Pub/Sub API

Keduanya gratis untuk lalu lintas bot pribadi. Klik, aktifkan, selesai.

Langkah 3: Buat Service Account (Kartu Identitas Bot)

Masuk ke IAM & Admin → Service Accounts → Create Service Account. Beri nama hermes-chat-bot. Lewati permission tingkat proyek—kamu tidak membutuhkannya.

Lalu buat JSON key dan unduh. Simpan di tempat yang aman:

mkdir -p ~/.hermes
mv ~/Downloads/hermes-chat-bot-key.json ~/.hermes/google-chat-sa.json
chmod 600 ~/.hermes/google-chat-sa.json

Kesalahan umum: mencari peran IAM “Chat Bot Caller”. Itu tidak ada. Kewenangan bot kamu berasal dari ditambahkan ke sebuah space, bukan dari peran IAM. Jangan dipikir berlebihan.

Langkah 4: Buat Topik dan Subscription Pub/Sub

Di Pub/Sub → Topics → Create topic, gunakan hermes-chat-events sebagai topic ID. Lalu buat pull subscription:

Subscription ID: hermes-chat-events-sub
Tipe pengiriman: Pull
Retensi pesan: 7 hari

Subscription inilah tempat Google Chat menjatuhkan pesan masuk. Hermes menariknya dari sini, seperti memeriksa kotak surat.

Langkah 5: Hubungkan Hermes Agent

Sekarang bagian ajaibnya. Jalankan:

hermes gateway setup

Pilih Google Chat, dan wizard akan memandumu melewati sisanya. Ia akan meminta project ID, nama subscription, dan path ke file JSON service account kamu. Itu saja.

Hasilnya

Sekarang kamu punya bot AI di dalam Google Chat. Timmu bisa me-@mention bot, mengajukan pertanyaan, memicu otomatisasi, atau mendelegasikan tugas—semua tanpa meninggalkan jendela chat. Tanpa tunnel, tanpa IP publik, tanpa perpanjangan sertifikat.

Ringkasan & Tips Praktis

Hermes Agent mengubah Google Chat menjadi pusat komando untuk alur kerja AI kamu. Pengaturannya memang sengaja dibuat sederhana: service account untuk identitas, subscription untuk mendengarkan, dan REST API untuk membalas.

Tips praktis: Setelah selesai setup, uji dengan satu pesan langsung ke bot kamu sebelum menambahkannya ke space grup. Jika ia membalas, kamu aman. Jika tidak, periksa apakah service account kamu punya peran roles/pubsub.subscriber pada subscription—itu penyebab nomor satu bot diam membisu.

Sekarang, waktunya memberi timmu rekan kerja AI yang benar-benar hadir di rapat.