GudDesk webhooks
GudDesk can POST JSON to your URL when conversations change. Use that to update your own tools, start a workflow, or feed an agent you host.
What it does
- Sends an HTTP POST when a subscribed event fires.
- Signs each body with HMAC SHA-256 in X-GudDesk-Signature.
- Retries failed deliveries (up to 6 attempts with backoff).
- Lets you pick which events each endpoint receives.
Setup
- 1
Open Workspace Settings > Webhooks (or use the agent webhook API if you are wiring a bot).
- 2
Add your HTTPS endpoint URL.
- 3
Subscribe to the events you need.
- 4
Copy the signing secret and verify X-GudDesk-Signature on every request.
- 5
Optional: send a test ping from the dashboard to confirm your server returns 2xx quickly.
If your receiver is on localhost, tunnel with something like ngrok.
Events you can subscribe to
These are the events in code today. A test ping is not a subscription filter.
| Event | Subscription field | Notes |
|---|---|---|
| message.created | onMessageCreated | New message |
| conversation.created | onConversationCreated | New conversation |
| conversation.closed | onConversationClosed | Conversation closed |
| conversation.assigned | onConversationAssigned | Assignment changed |
| ping | (test only) | Dashboard or API test ping. Not a normal subscription filter. |
Limits
- Webhooks are on the Free plan.
- Your endpoint must accept POST and return 2xx quickly. Do heavy work after you reply.
- Signature verification is your responsibility in production.
Add an endpoint when you are ready
Read the webhook docs, or create a free workspace and add an endpoint.