feat(wxcc-second-ringer-widget): WxCC Header Widget playbook for secondary audio alerting

[fortunesmith]

Summary

• Adds a new Webex Contact Center playbook (playbooks/wxcc-second-ringer-widget) demonstrating how to build an Agent Desktop Header Widget that plays a secondary ringtone on a user-selected audio output device when an agent receives an inbound contact or consult request
• Addresses the common webRTC scenario where agents miss inbound calls because audio plays only through the headset output
• No backend server required — widget is a fully static, Vite-built bundle

What's included

File	Description
README.md	All 6 required sections: Use Case, Architecture, Prerequisites, Code Scaffold, Deployment Guide, Known Limitations
APPHUB.yaml	friendly_id: wxcc-second-ringer-widget-playbook, product_types: [contact_center]
diagrams/architecture-diagram.md	Mermaid sequence diagram of the widget lifecycle
src/second-ringer.ts	Main Lit web component; subscribes to @wxcc-desktop/sdk contact events; routes audio via Web Audio API
src/second-ringer_Layout.json	Desktop layout JSON for upload to Control Hub
src/env.template	Documents WIDGET_HOST_URL for deployment
src/assets/ring.mp3	"Model 500 Telephone British ring" — CC BY-SA 3.0, Wikimedia Commons

Tech stack

• @wxcc-desktop/sdk — contact lifecycle events (offered, answered, ended, RONA)
• Lit web components (TypeScript)
• Vite — IIFE bundle output; ring.mp3 handled as a bundled asset import
• Web Audio API — enumerateDevices() + setSinkId() for secondary audio routing

Test plan

• CI validation passes (scripts/ci/validate-playbook-folder.sh playbooks/wxcc-second-ringer-widget)
• README contains all 6 required section headers
• APPHUB.yaml fields valid (friendly_id ends with -playbook, product_types uses allowed value)
• No hardcoded secrets or credentials
• ring.mp3 included and referenced via Vite asset import (not a remote URL)

Audio attribution

ring.mp3 — "Model 500 Telephone British ring" by CianMcCann
Source: https://commons.wikimedia.org/wiki/File:Model_500_Telephone_British_ring.ogg
License: CC BY-SA 3.0 — https://creativecommons.org/licenses/by-sa/3.0/
Attribution noted in src/second-ringer.ts header comment.

Made with Cursor

[github-actions]

Playbook Validation Results

Playbook: playbooks/wxcc-second-ringer-widget

• README.md exists
• README.md contains all 6 required section headers
• APPHUB.yaml exists
• No prohibited competitor as primary integration target (APPHUB metadata)
• All required APPHUB.yaml fields present and non-empty
• APPHUB.yaml categories has at least one value
• APPHUB.yaml friendly_id ends with -playbook
• APPHUB.yaml tag_line is valid (92/128 chars)
• APPHUB.yaml product_types is valid
• /diagrams/ folder exists
• /src/ folder exists
• Folder name is kebab-case

---

Validation passed.

[github-actions]

Playbook Details (from APPHUB.yaml)

Field	Value
Playbook title	Second Ringer Header Widget for Webex Contact Center
Third-party tool
Categories	agent-supervisor-tools, developer-tools, productivity
Estimated implementation time	2-4 hours

---

Auto-generated from APPHUB.yaml.

[github-actions]

Contentstack: Published to integration

wxcc-second-ringer-widget-playbook

• Integration: View in App Hub
• Contentstack: Edit entry

---

Published playbooks are available in the integration environment.