api/java/telnyx-voice-media-java/SKILL.md
Play audio files, use text-to-speech, and record calls. Use when building IVR systems, playing announcements, or recording conversations. This skill provides Java SDK examples.
npx skillsauth add team-telnyx/telnyx-toolkit telnyx-voice-media-javaInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
// See https://github.com/team-telnyx/telnyx-java for Maven/Gradle setup
import com.telnyx.sdk.client.TelnyxClient;
import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;
TelnyxClient client = TelnyxOkHttpClient.fromEnv();
All examples below assume client is already initialized as shown above.
Play an audio file on the call.
POST /calls/{call_control_id}/actions/playback_start
import com.telnyx.sdk.models.calls.actions.ActionStartPlaybackParams;
import com.telnyx.sdk.models.calls.actions.ActionStartPlaybackResponse;
ActionStartPlaybackResponse response = client.calls().actions().startPlayback("call_control_id");
Stop audio being played on the call.
POST /calls/{call_control_id}/actions/playback_stop
import com.telnyx.sdk.models.calls.actions.ActionStopPlaybackParams;
import com.telnyx.sdk.models.calls.actions.ActionStopPlaybackResponse;
ActionStopPlaybackResponse response = client.calls().actions().stopPlayback("call_control_id");
Pause recording the call.
POST /calls/{call_control_id}/actions/record_pause
import com.telnyx.sdk.models.calls.actions.ActionPauseRecordingParams;
import com.telnyx.sdk.models.calls.actions.ActionPauseRecordingResponse;
ActionPauseRecordingResponse response = client.calls().actions().pauseRecording("call_control_id");
Resume recording the call.
POST /calls/{call_control_id}/actions/record_resume
import com.telnyx.sdk.models.calls.actions.ActionResumeRecordingParams;
import com.telnyx.sdk.models.calls.actions.ActionResumeRecordingResponse;
ActionResumeRecordingResponse response = client.calls().actions().resumeRecording("call_control_id");
Start recording the call.
POST /calls/{call_control_id}/actions/record_start — Required: format, channels
import com.telnyx.sdk.models.calls.actions.ActionStartRecordingParams;
import com.telnyx.sdk.models.calls.actions.ActionStartRecordingResponse;
ActionStartRecordingParams params = ActionStartRecordingParams.builder()
.callControlId("call_control_id")
.channels(ActionStartRecordingParams.Channels.SINGLE)
.format(ActionStartRecordingParams.Format.WAV)
.build();
ActionStartRecordingResponse response = client.calls().actions().startRecording(params);
Stop recording the call.
POST /calls/{call_control_id}/actions/record_stop
import com.telnyx.sdk.models.calls.actions.ActionStopRecordingParams;
import com.telnyx.sdk.models.calls.actions.ActionStopRecordingResponse;
import com.telnyx.sdk.models.calls.actions.StopRecordingRequest;
ActionStopRecordingParams params = ActionStopRecordingParams.builder()
.callControlId("call_control_id")
.stopRecordingRequest(StopRecordingRequest.builder().build())
.build();
ActionStopRecordingResponse response = client.calls().actions().stopRecording(params);
Convert text to speech and play it back on the call.
POST /calls/{call_control_id}/actions/speak — Required: payload, voice
import com.telnyx.sdk.models.calls.actions.ActionSpeakParams;
import com.telnyx.sdk.models.calls.actions.ActionSpeakResponse;
ActionSpeakParams params = ActionSpeakParams.builder()
.callControlId("call_control_id")
.payload("Say this on the call")
.voice("female")
.build();
ActionSpeakResponse response = client.calls().actions().speak(params);
The following webhook events are sent to your configured webhook URL.
All webhooks include telnyx-timestamp and telnyx-signature-ed25519 headers for verification (Standard Webhooks compatible).
| Event | Description |
|-------|-------------|
| callPlaybackStarted | Call Playback Started |
| callPlaybackEnded | Call Playback Ended |
| callSpeakEnded | Call Speak Ended |
| callRecordingSaved | Call Recording Saved |
| callRecordingError | Call Recording Error |
| callRecordingTranscriptionSaved | Call Recording Transcription Saved |
| callSpeakStarted | Call Speak Started |
tools
Build cross-platform VoIP calling apps with React Native using Telnyx Voice SDK. High-level reactive API with automatic lifecycle management, CallKit/ConnectionService integration, and push notifications. Use for mobile VoIP apps with minimal setup.
tools
Build browser-based VoIP calling apps using Telnyx WebRTC JavaScript SDK. Covers authentication, voice calls, events, debugging, call quality metrics, and AI Agent integration. Use for web-based real-time communication.
tools
Build VoIP calling apps on iOS using Telnyx WebRTC SDK. Covers authentication, making/receiving calls, CallKit integration, PushKit/APNS push notifications, call quality metrics, and AI Agent integration. Use when implementing real-time voice communication on iOS.
tools
Build cross-platform VoIP calling apps with Flutter using Telnyx WebRTC SDK. Covers authentication, making/receiving calls, push notifications (FCM + APNS), call quality metrics, and AI Agent integration. Works on Android, iOS, and Web.