telnyx-voice-media-java_skill

Overview

This skill demonstrates Telnyx Voice Media operations using Java examples. It shows how to play audio, synthesize speech, and manage call recordings via the Telnyx Java SDK. The examples assume a Telnyx client initialized from environment configuration and focus on common IVR and media control actions.

How this skill works

The skill uses the Telnyx Java client to call Call Control endpoints for playback, speak, and recording actions. Each action maps to a POST request on a call resource (playback_start, speak, record_start, record_stop, etc.) and returns a typed response object. Webhooks notify your application about media events like playback started/ended and recordings saved so you can react to asynchronous events.

When to use it

• Building IVR menus that play prompts or dynamically generated speech.
• Playing announcements or hold music to callers during sessions.
• Recording calls for quality assurance, compliance, or transcription.
• Pausing and resuming recordings mid-call for privacy segments.
• Stopping playback or speech in response to user input or call state changes.

Best practices

• Initialize the Telnyx client from environment variables and reuse it across requests.
• Validate required parameters (call_control_id, payload, voice, format, channels) before calling SDK methods.
• Use webhooks and verify telnyx-signature-ed25519 to handle asynchronous media events reliably.
• Record with appropriate format and channel settings for your downstream processing (e.g., WAV single-channel for speech analysis).
• Gracefully stop playback and recordings when the call ends to avoid orphaned media sessions.

Example use cases

• Play a pre-recorded announcement to every inbound call before routing to agents.
• Use text-to-speech to read dynamic account information to a caller during an IVR flow.
• Start recording a support call at agent pickup and stop or pause when sensitive data is being provided.
• Stream hold music by starting playback and stop it when the caller is connected to an agent.
• Capture recordings and rely on callRecordingSaved webhook to trigger transcription pipelines.