8000 elevenlabs/post-call-transcripts: post-call transcripts through Hookdeck with a live topology pane and a shared scene kit by leggetter · Pull Request #47 · hookdeck/hookdeck-demos · GitHub
[go: up one dir, main page]

Skip to content

elevenlabs/post-call-transcripts: post-call transcripts through Hookdeck with a live topology pane and a shared scene kit - #47

Merged
leggetter merged 31 commits into
mainfrom
feat/elevenlabs-post-call-transcripts
Nov 18, 2026
Merged

leggetter merged 31 commits into
mainfrom
feat/elevenlabs-post-call-transcripts

Conversation

@leggetter
@leggetter leggetter commented Nov 16, 2026 •
Copy link
Copy Markdown
Collaborator

Adds elevenlabs/post-call-transcripts: ElevenLabs post-call webhooks through a Hookdeck ELEVENLABS source into an app that stores each conversation, with a live topology view of every webhook. Also adds two shared pieces other demos can use, _shared/scenes and _shared/topology-pane.

The demo

  • Setup (npm run setup): the Hookdeck source, CLI destination and connection (dedup on body.type + body.data.conversation_id, linear retry), the ElevenLabs workspace webhook, and a dedicated agent, "Hookdeck demo: post-call transcripts", with a first message, a salon booking prompt, data collection and a booking_made criterion. It sets the signing secret on the source; npm run probe proves verification is on.
  • The page: you are the customer calling the Hookdeck Hair booking line (browser voice call); a diary fills a slot from each successful booking's requested_time (unreadable times go to an Unscheduled row); the conversations with transcript, analysis and audio; a Retry demo (fail the next N deliveries); and a compact deliveries row with the SDK constructEvent check. Explanations sit behind ⓘ dialogs and hover tips.
  • Salon theme (default; System, Light and Dark remain): restyles main only, never the Data flow pane, via _shared/theme.
  • Live topology in the bottom pane, open by default: ElevenLabs agent → Event Gateway (verify, store, dedup, retry) → hookdeck listen → the app, with packets moving as real webhooks arrive. Tabs play four scripted scenarios (delivery, duplicate dropped, bad signature, app down then retry). Clicking a packet shows that webhook's attempts and a View in Hookdeck link.
  • Captures: MP4s of the four scenarios, landscape and square, in scenes/captures/.

Shared pieces

  • _shared/scenes: the animated-topology scene kit (TypeScript, SVG, GSAP): scripted scenes with captions and phone layouts, a live driver, and frame-exact MP4 capture. hookdeck.com's voice-ai diagram set syncs its scenes from here (hookdeck/website#994).
  • _shared/topology-pane: the bottom pane host.
  • _shared/flow-drawer comes in byte-identical from vapi/agency-routing: per-client Vapi call routing with an async tool via Hookdeck #44 for its server-side state; the demo doesn't use its client.

Live-run facts

A real voice call sent post_call_transcription (53 KB) and post_call_audio (3.5 MB) about 1 s after hang-up. A bad signature gets HTTP 200 and a VERIFICATION_FAILED request record with no event. A duplicate is dropped by the dedup rule; a 500 from the app is retried 10 s later and succeeds.

Merging

Checks

node scripts/sync-shared.mjs --check and typecheck pass. npm test (47 tests, including the diary, theme copy, scene parity and the pane) passes at the branch head.

Update 2026-11-18: Salon theme, roles, the booking diary and ⓘ dialogs (a5a83e5..2925f33). No code the tutorial (hookdeck/website#994) shows changed; src/samples.ts gains requested_time.

Review fixes: 4233440..195d877: the app binds to 127.0.0.1 and rejects foreign Host headers, state-changing POSTs need an x-demo header, event fields are checked and coerced on write (400 for a bad event), stored fields are escaped in the page, the diary no longer reads a day of the month as an hour, state.json is written atomically, and stored conversations are capped at 50. No code the tutorial shows changed.

Merge readiness (e87a810): root README shared rows; HOST, ALLOWED_HOSTS and HOOKDECK_CLI documented; the latest pane and feed polling is synced from _shared; the theme test reads the demo's own theme.js so npm test passes in a standalone copy.

🤖 Generated with Claude Code

Posted by an AI agent with human oversight.

leggetter and others added 19 commits November 12, 2026 11:11
Receives ElevenLabs Agents post-call webhooks through a Hookdeck ELEVENLABS source
(signature verification, deduplication on type + conversation_id, retries) and stores
and shows each conversation. Includes setup, listen, call and sample-sender scripts
and tests with signed sample payloads.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…he API, add Start call button and probe

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…t record

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…its buttons; Clear stored data moves to the Conversations header

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… collapse the deliveries table

The drawer (_shared/flow-drawer, synced) shows each webhook from ElevenLabs through Event Gateway
and every delivery attempt, including failures and retries, to the app. The deliveries table becomes a
collapsed summary with the SDK check result; conversations list scrolls.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…uest gets (ELEVENLABS is verified after ingestion)

Brings _shared/flow-drawer's rejectedStatus option over from feat/vapi-agency-routing, byte-identical.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…t that greets first

The agent used before had no first message or prompt, so callers heard silence and then the
7-second turn-timeout nudge. Setup now creates or updates "Hookdeck demo: post-call transcripts"
with a greeting, a salon booking prompt that never promises lookups, a 10s turn timeout,
data collection and a booking_made criterion, and writes ELEVENLABS_AGENT_ID to .env.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ipted scenes, capture)

Ported from the hookdeck-presentations starter: one paused GSAP timeline per scene, framework-free
TS and SVG. Adds design-system CSS-variable colors (light and dark), node cards, per-edge packet
queues with size labels, a live driver, capability and status chips, a flow-feed host and a
frame-exact GIF/MP4 capture script. Synced into demos through the manifest piece "scenes".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… and GIF/MP4 capture

The page's hero view is the ElevenLabs topology (agent, Event Gateway with verify/store/dedup/retry
chips, hookdeck listen, app): packets move as real webhooks arrive, nodes show status badges, and
clicking a node or packet opens the message in the Data flow drawer. Four scripted scenes (delivery,
duplicate dropped, bad signature, app down then retry) have desktop and phone layouts with the same
captions, for the website's steppedDiagram. npm run capture renders them to GIF and MP4.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…dscape and square)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…s, detail strip), and make scene captures MP4 only

The pane replaces a message list with the scene kit's live topology and scripted scenes; clicking a node or packet fills one detail strip (verification, attempts, retry gaps, app answer, dashboard link). createFlowFeed gains onFlow. capture.ts writes MP4 only.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…m pane, replacing the flow drawer

Removes the Live topology card, the Open data flow button and the flow drawer client; the hero points at the pane. /api/flow adds team_id for dashboard links. Adds a pane test.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…square, light) and stop ignoring them

The GIFs were removed in the previous commit; social platforms take MP4 and convert GIFs themselves.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…dow augmentation

The website loads this kit next to the MCP Events kit, which declares its own
Window.__scenes, so astro check failed with TS2717.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…signature captions say what the reader sees

A label wider than its connector draws above the nodes, centered on the connector,
instead of half under a node card ("BAD SI…", "…IPT 53 KB"). The bad-signature captions
no longer explain ingestion order. README: npm run call needs no text-only override.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ctors too

Phone layouts (and square captures) stack nodes with vertical connectors, where the
label sits beside the connector and was half under the next node card.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…et labels and the new bad-signature captions

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… bundle

capture.ts no longer hardcodes the ElevenLabs scene ids, so any demo's scenes (retell-*)
can be captured; page.html's square-capture eyebrow uses HookdeckScenes.brand.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
leggetter and others added 2 commits November 16, 2026 13:31
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…er README)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
leggetter and others added 6 commits November 17, 2026 22:15
…e3f4e), byte-identical; elevenlabs/post-call-transcripts uses it

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ed_time without guessing, and requested_time in the sample payload

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… ⓘ dialogs and hover tips), the customer and the booking assistant on screen, Salon theme, diary above the conversations

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…nario

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…h as an hour (14 November, 11/20, 20-11) and sends ranges to Unscheduled

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ite, answer 400/500 for a bad event, atomic state.json, cap at 50 conversations, collision-free audio names, SDK check after the response

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
leggetter and others added 4 commits November 18, 2026 11:16
…ost headers, require x-demo on state-changing POSTs, JSON error handler, escape and guard stored fields in the page

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… when verified, keep the Hookdeck API key off the CLI command line and out of errors

Cherry-picked from 5fe85ba (feat/vapi-agency-routing) so the shared files stay byte-identical across the demo branches.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… rows, HOST, ALLOWED_HOSTS and HOOKDECK_CLI in .env.example and README, the latest pane and feed polling from _shared, theme test reads the demo's own theme.js

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…call-transcripts

# Conflicts:
#	README.md
#	_shared/manifest.json
8BD0 @leggetter
leggetter marked this pull request as ready for review November 18, 2026 12:27
@leggetter
leggetter merged commit b548064 into main Nov 18, 2026
8 checks passed
@leggetter
leggetter deleted the feat/elevenlabs-post-call-transcripts branch November 18, 2026 12:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

0