docs: document workflow_run in-place message updates

This commit is contained in:
RhenCloud 2026-08-03 09:51:40 +08:00
parent 38ea820606
commit 2dcb684e94
No known key found for this signature in database
GPG key ID: A574A617378C4E0B
2 changed files with 10 additions and 2 deletions

View file

@ -10,7 +10,7 @@ WebHooker supports 23 GitHub webhook event types, each with a dedicated formatte
| `pull_request` | PR opened/closed/merged/edited | PR title, branch, diff stats, labels |
| `issues` | Issue opened/closed/edited | Issue title, labels, assignees |
| `issue_comment` | Comment on issue or PR | Comment body, issue reference |
| `workflow_run` | CI/CD workflow completed | Workflow status, conclusion, duration |
| `workflow_run` | CI/CD workflow phase updated | Workflow status, conclusion, duration; phases update a single message in place |
| `release` | Release published/edited | Tag, body, assets, pre-release flag |
| `create` | Branch or tag created | Ref name, ref type |
| `delete` | Branch or tag deleted | Ref name, ref type |
@ -55,6 +55,10 @@ Any event type without a dedicated formatter falls through to the generic format
- Repository name
- Raw payload as code block (truncated to 1000 chars)
## In-Place Message Updates
`workflow_run` events (queued → running → success/failure) are sent once and then **edited in place** for each subsequent phase instead of posting a new message. The original message's link preview, author, and field layout are preserved; only the status, conclusion emoji, duration, and title are refreshed. Supported on both Discord (`editMessage`) and Telegram (`editMessageText` / `editMessageCaption`).
## Filter Compatibility
See the [Filter Tutorial](../guide/filters) for a hands-on guide with worked examples.