Merge pull request #29 from photon-hq/spectrum-webhook-dashboard-mention

doc(webhook): reference dashboard for spectrum docs

Author: yanxue06

webhooks/managing-webhooks.mdx

@@ -5,10 +5,14 @@ description: Register, list, delete, and rotate webhook signing secrets via the
 
 By now you can receive deliveries, verify them, and survive retries. This page is the operational layer — how you actually create the webhook records, list them, take one offline, or rotate a leaked secret.
 
-There are three HTTP endpoints, all under `https://spectrum.photon.codes/projects/{projectId}/webhooks/`. Every example below uses `curl`, but the same three endpoints are also live in the [interactive API reference](/api-reference/introduction) — paste your project credentials once and run any request from your browser.
+There are three HTTP endpoints, all under `https://spectrum.photon.codes/projects/{projectId}/webhooks/`. Every example below uses `curl` to keep things explicit, but the same three operations are available three other ways:
+
+- The **Webhook** tab of your workspace in the [Spectrum dashboard](https://app.photon.codes/dashboard) — a UI any teammate can use.
+- The [interactive API reference](/api-reference/introduction) — run any request from your browser with your credentials pre-filled.
+- Any HTTP client you like — Postman, Insomnia, your language's SDK, etc.
 
 <Tip>
-**Read this page first, then hit the API reference.** This page explains *what* each endpoint does and *when* you'd reach for it; the API reference is the interactive playground for actually firing the request. The combo is much faster than reading either alone.
+**Read this page for the *what* and *when*, then pick a surface for the *how*.** This page explains what each operation does and when you'd reach for it; the dashboard and API reference are the interactive playgrounds for actually firing the request. The combo is much faster than reading either alone.
 </Tip>
 
 ## Authentication
@@ -193,7 +197,13 @@ list_webhooks() {
 
 ## Working with the dashboard
 
-You can also register, list, and delete webhooks from your project's [dashboard](https://app.photon.codes) under **Settings → Webhooks**. Same operations, no terminal required. The signing secret is shown once at registration time there too — copy it before navigating away.
+If you'd rather not touch a terminal, every operation on this page is also a button click away in the [Spectrum dashboard](https://app.photon.codes/dashboard).
+
+Open your workspace and switch to the **Webhook** tab (next to *Platforms*, *Users*, *Lines*, and *Settings*). You'll see:
+
+- A list of every webhook currently registered — endpoint URL plus the date it was added.
+- An **+ Add webhook** button to register a new URL. After you click it, the signing secret is shown once in a modal — copy it before closing.
+- A **Remove** button next to each row to delete a webhook. Same effect as the `DELETE` endpoint: delivery stops immediately and the signing secret is invalidated.
 
 ## Common workflows
 

webhooks/overview.mdx

@@ -9,7 +9,7 @@ A webhook is the inverse of a normal API call.
 
 In a normal API call, your code reaches out and asks a service for data — you poll, you wait, you parse the response. In a *web*hook, the service reaches out to *you*: a message arrives, an event fires, and the service `POST`s the details to a URL you've published. You're not asking anymore; you're being told.
 
-For Spectrum, that means you write a regular HTTP handler — in whatever framework you already use — register its URL once, and from then on every inbound message across every enabled platform is delivered as a signed JSON `POST`. No long-lived process to babysit, no platform credentials in your runtime, no reconnect logic.
+For Spectrum, that means you write a regular HTTP *handler* — a function in your server that runs whenever a request comes in — and register its URL with us once. From then on, every inbound message across every enabled platform is delivered to that URL as a signed JSON `POST`. No long-lived process to babysit, no platform credentials in your runtime, no reconnect logic.
 
 ```ts
 const app = await Spectrum({ projectId, projectSecret, providers: [imessage.config()] });
@@ -41,7 +41,13 @@ The next six pages build on each other. Skim straight to the topic you need, or
 6. **[Troubleshooting](/webhooks/troubleshooting)** — common symptoms, root causes, and fixes when something goes wrong.
 
 <Tip>
-**Want to poke at the management endpoints before writing any code?** Every one of them is live in the [interactive API reference](/api-reference/introduction) — fill in your project credentials and run `List webhooks`, `Register webhook`, or `Delete webhook` straight from your browser. It's the fastest way to confirm credentials work and sanity-check a URL before wiring up a verifier.
+**Three ways to register and manage webhooks** — pick whichever fits how you work:
+
+- **Dashboard.** Open your workspace at [app.photon.codes/dashboard](https://app.photon.codes/dashboard) and use the **Webhook** tab to add, list, and remove endpoints with point-and-click. No terminal, no auth headers — friendly enough to hand to a non-engineer.
+- **Interactive API reference.** Every endpoint is live in the [API reference](/api-reference/introduction) — paste your project credentials once and fire `List webhooks`, `Register webhook`, or `Delete webhook` straight from your browser. Fastest way to confirm credentials work and sanity-check a URL.
+- **`curl` or any HTTP client.** The terminal flow used throughout this guide and the [Quickstart](/webhooks/quickstart). Scriptable, automatable, CI-friendly.
+
+Same three operations under the hood — just three different surfaces over them.
 </Tip>
 
 ## When to use webhooks

webhooks/quickstart.mdx

@@ -10,7 +10,7 @@ If you already have a deployed HTTPS URL, skip the ngrok step.
 ## Prerequisites
 
 - A Spectrum project with at least one platform enabled. See [Providers](/spectrum-ts/providers) for the current list, or [Getting Started with Spectrum](/spectrum-ts/getting-started) if you don't have a project yet.
-- Your project id and project secret, from the [dashboard](https://app.photon.codes) or `photon projects show`.
+- Your project id and project secret, from the [dashboard](https://app.photon.codes/dashboard) or `photon projects show`.
 - A reachable HTTPS URL — ngrok works for local development.
 
 <Steps>