← Commit history

Document that webhooks are per-space (one per space)

John Lauer ·1185444ffe ·4mo ago ·parent e9692ab
1 file changed +14−4
README.md+14−4
@@ -39,12 +39,22 @@ adom-gchat health  ## Setting up for your org -1. Open your Google Chat space → **Settings → Apps & integrations → Webhooks**+> **Webhooks are per-space.** A Google Chat incoming webhook is created *inside a+> single space* and can only post to that space. To post to multiple spaces, you+> create **one webhook per space** — e.g. a `#deploys` space and a `#general`+> space need two separate webhooks. `adom-gchat setup` loops so you can add as+> many as you like, and `--space <name>` selects which webhook a message uses.++**For each space you want to post to:**++1. Open *that* Google Chat space → **Settings → Apps & integrations → Webhooks** 2. Create a webhook — name it "Kel", use this avatar URL:    `https://wiki.adom.inc/blob/app/adom-gchat/icons/kel/png/256x256.png`-3. Copy the webhook URL Google gives you-4. Run `adom-gchat setup` and paste the URL when prompted-5. Test with `--dry-run`, then post for real+3. Copy the webhook URL Google gives you (it's unique to that space)++Then, once, run `adom-gchat setup` — it walks you through pasting a name ++webhook URL for each space, your org name, and the attribution template.+Test with `adom-gchat send --space <name> --dry-run "hello"`, then post for real.  Your webhook URLs stay private to your org in `~/.config/gchat-webhooks.json`.