菜单
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.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/team-telnyx/telnyx-toolkit --skill telnyx-voice-media-java命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | telnyx-voice-media-java |
| description | 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. |
| metadata | {"author":"telnyx","product":"voice-media","language":"java","generated_by":"telnyx-ext-skills-generator"} |
// 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 |