Planned event categories
Conversations
Created, updated, resolved, assigned, or handed off.
Messages
Customer, operator, or agent message created.
Customers
Customer created, updated, or identity linked.
Issues
Issue created, updated, linked, or resolved.
Knowledge
Source scan completed, failed, or changed coverage.
Agent
Agent answer created, handoff requested, or low-confidence event recorded.
Future delivery docs should include
| Topic | Needed detail |
|---|---|
| Event names | Stable event type strings. |
| Payload schemas | IDs, timestamps, workspace scope, and included resource fields. |
| Signing | How to verify the webhook came from Woes. |
| Retries | Retry schedule, timeout behavior, and terminal failure state. |
| Idempotency | How receivers should dedupe deliveries. |
| Ordering | Whether events are ordered per workspace, resource, or delivery attempt. |