Skip to content

[RealtimeKit] add documentation for webhooks#31203

Open
ToxicityMax wants to merge 9 commits into
productionfrom
ToxicityMax/rtk-webhooks
Open

[RealtimeKit] add documentation for webhooks#31203
ToxicityMax wants to merge 9 commits into
productionfrom
ToxicityMax/rtk-webhooks

Conversation

@ToxicityMax
Copy link
Copy Markdown
Contributor

Summary

Add documentation for realtimekit webhooks

Screenshots (optional)

Documentation checklist

  • Is there a changelog entry (guidelines)? If you don't add one for something awesome and new (however small) — how will our customers find out? Changelogs are automatically posted to RSS feeds, the Discord, and X.
  • The change adheres to the documentation style guide.
  • If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes.
  • Files which have changed name or location have been allocated redirects.

@cloudflare-docs-bot
Copy link
Copy Markdown

cloudflare-docs-bot Bot commented Jun 3, 2026

Review

⏸️ Automatic reviews for this PR are paused.

This PR has already received 2 automatic reviews. To run another review, a codeowner can comment /review or /full-review.

Tip: Keep PRs in draft mode until they are ready for review — the bot skips draft PRs automatically.


✅ No style-guide issues found in commit 70a874b.

Commands

Only codeowners can run commands. Post a comment with the command to trigger it.

Command Description
/review Runs a review now. Incremental if a prior review exists, full if not.
/full-review Re-reviews the entire PR diff from scratch, ignoring incremental history. Useful after a rebase, when you want a fresh review, or if the bot gets out of sync and reports issues that no longer exist.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 3, 2026

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/docs/realtime/ @cloudflare/product-owners, @cloudflare/realtime, @cloudflare/RealtimeKit, @roerohan, @ravindra-cloudflare

@ask-bonk ask-bonk Bot changed the title [Realtimekit]: add documentation for webhooks [RealtimeKit] add documentation for webhooks Jun 3, 2026
@ask-bonk ask-bonk Bot added documentation Documentation edits content:new Request for new/missing content triage Waiting for a docs team review. pcx_team_review labels Jun 3, 2026
Copy link
Copy Markdown
Contributor

@ask-bonk ask-bonk Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

4 issues need fixing before merge. Posted 6 inline suggestions and 2 comments.

MEDIUM

  • src/content/docs/realtime/realtimekit/webhooks.mdx:17-21 — Procedure must use <Steps>.
  • src/content/docs/realtime/realtimekit/webhooks.mdx:29 — Workers example must use <TypeScriptExample>.
  • src/content/docs/realtime/realtimekit/webhooks.mdx:123 — Workers example must use <TypeScriptExample>.

LOW

  • src/content/docs/realtime/realtimekit/webhooks.mdx:65 — curl blocks must use $VARIABLE_NAME placeholders.
  • src/content/docs/realtime/realtimekit/webhooks.mdx:224 — curl blocks must use $VARIABLE_NAME placeholders.
  • src/content/docs/realtime/realtimekit/recording-guide/monitor-status.mdx:32 — curl blocks must use $VARIABLE_NAME placeholders.

Consider adding a changelog entry for the new webhooks page.

Comment thread src/content/docs/realtime/realtimekit/webhooks.mdx
Comment thread src/content/docs/realtime/realtimekit/webhooks.mdx

Your webhook endpoint must accept JSON `POST` requests. The endpoint can handle multiple event types by switching on the `event` field in the request body.

```javascript
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Workers examples must use <TypeScriptExample>, not bare javascript fences. Convert this example to TypeScript and wrap it with the component.


Verify `rtk-signature` against the raw request body. Do not reserialize parsed JSON before verification because changes in whitespace or key order can change the signed bytes.

```javascript
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Workers examples must use <TypeScriptExample>, not bare javascript fences. Convert this example to TypeScript and wrap it with the component.

Comment thread src/content/docs/realtime/realtimekit/webhooks.mdx Outdated
Comment thread src/content/docs/realtime/realtimekit/webhooks.mdx Outdated
Comment thread src/content/docs/realtime/realtimekit/webhooks.mdx Outdated
Comment thread src/content/docs/realtime/realtimekit/webhooks.mdx Outdated
Comment thread src/content/docs/realtime/realtimekit/recording-guide/monitor-status.mdx Outdated
Comment thread src/content/docs/realtime/realtimekit/recording-guide/monitor-status.mdx Outdated
@ask-bonk
Copy link
Copy Markdown
Contributor

ask-bonk Bot commented Jun 3, 2026

Review completed for PR #31203.

What the PR changes

  • Adds a new webhooks.mdx page with full RealtimeKit webhook documentation: how to create an endpoint, register webhooks via API/ dashboard, verify RSA-SHA256 signatures, retry behavior, supported events, and complete JSON payloads for all nine event types.
  • Updates existing AI docs (ai/index.mdx, ai/summary.mdx, ai/transcription.mdx) to link to the new webhooks page instead of the generic API reference, and updates payload examples to wrap meeting metadata in a meeting object.
  • Updates recording-guide/monitor-status.mdx with a curl example for registering a recording.statusUpdate webhook and links to the new webhooks page.

Actions taken

  • Applied labels: documentation, content:new, triage, pcx_team_review.
  • Updated PR title to [RealtimeKit] add documentation for webhooks.
  • Posted a review with 6 inline suggestions and 2 comments.

Issues flagged

  • MEDIUM: The "How webhooks work" ordered list is a procedure and must be wrapped in the <Steps> component. Also added the missing component import.
  • MEDIUM: Two Workers-style export default { fetch } examples use bare javascript fences. They must use <TypeScriptExample> (TypeScript input with auto-generated JS tab).
  • LOW: Three curl blocks use <account_id> / <api_token> placeholders instead of the required $VARIABLE_NAME shell-variable format.
  • Optional: Consider adding a changelog entry for the new webhooks page.

github run

ToxicityMax and others added 8 commits June 3, 2026 17:37
Co-authored-by: ask-bonk[bot] <249159057+ask-bonk[bot]@users.noreply.github.com>
Co-authored-by: ask-bonk[bot] <249159057+ask-bonk[bot]@users.noreply.github.com>
Co-authored-by: ask-bonk[bot] <249159057+ask-bonk[bot]@users.noreply.github.com>
Co-authored-by: ask-bonk[bot] <249159057+ask-bonk[bot]@users.noreply.github.com>
Co-authored-by: ask-bonk[bot] <249159057+ask-bonk[bot]@users.noreply.github.com>
Co-authored-by: ask-bonk[bot] <249159057+ask-bonk[bot]@users.noreply.github.com>
…status.mdx

Co-authored-by: ask-bonk[bot] <249159057+ask-bonk[bot]@users.noreply.github.com>
…status.mdx

Co-authored-by: ask-bonk[bot] <249159057+ask-bonk[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

content:new Request for new/missing content documentation Documentation edits pcx_team_review product:realtime size/l triage Waiting for a docs team review.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants