FINDMYAIVOICE • CONVERSATIONAL SANTA IMPLEMENTATION GUIDE

Use the official ElevenLabs walkthrough for the dashboard and React flow:
https://elevenlabs.io/blog/add-a-santa-voice-agent-to-your-react-app-in-minutes
Its Voice section explicitly selects MDLAMJ0jxkpYkjXbmG4t.
The tutorial's open demo setting is not a production deployment pattern.

Configure a private/authenticated agent in YOUR ElevenLabs account.
Select Jerry B - Jolly Santa Claus, exact voice MDLAMJ0jxkpYkjXbmG4t.
An agent ID is a separate resource: do not paste the voice ID as agentId.

Production architecture:
Browser start button -> your authenticated backend -> short-lived ElevenLabs
session credential -> React SDK -> ElevenLabs. Long-lived API key stays on
your server. The microphone permission should follow an explicit user action.

Current SDK and authentication reference:
https://elevenlabs.io/docs/eleven-agents/libraries/react
https://elevenlabs.io/docs/eleven-agents/customization/authentication

The React SDK documents conversation.startSession({ signedUrl }) for a
WebSocket session. Obtain signedUrl on your authenticated server, not with
a long-lived key from the browser. If choosing WebRTC, follow the separate
conversation-token flow in the current SDK docs; do not interchange the two.
End the session on Stop, component cleanup and your configured time limit.

Suggested starting persona (original template; tune and test):
You are a fictional Santa character in a festive entertainment experience.
Be warm, playful and brief. Invite kindness and imagination. Do not ask for
names, addresses, school details, contact information or payment details.
Do not promise real deliveries, purchases or real-world actions. Redirect
inappropriate requests gently. Let users stop at any time. Start with a
friendly Christmas greeting and end with a warm farewell.

Before exposing it publicly:
- Set authentication and a short maximum session duration.
- Enforce per-user quotas, concurrent-session and total spending limits.
- Implement your own identity/access checks before issuing session access.
- Review retention, user notice, moderation and adult consent as applicable.
- Test interruptions, microphone denial, disconnect/reconnect and Stop.
- Measure starts/completions separately from marketplace click-through.
- Do not publish claims of official ElevenLabs endorsement or guaranteed ROI.

No live agent or React app is included or deployed by this guide. It avoids
shipping an unauthenticated, billable public call button. Use the working
TTS example for the first integration test, then follow the current SDK for
your selected transport and application framework.
