> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.
# Registro de alterações
## October 12, 2026
### ElevenAgents
- **Merge and search triage tickets**: [Merge tickets](/docs/api-reference/triage-tickets/merge) folds up to 50 open tickets from the same agent into one target ticket. Merged tickets keep the status `merged` and reference the target through `merged_into_ticket_id`. [List tickets](/docs/api-reference/triage-tickets/list) and [List workspace tickets](/docs/api-reference/triage-tickets/list-for-workspace) add a case-insensitive `search` parameter that matches ticket titles, descriptions, comments and turn comments, and each result includes a `search_match` excerpt showing where the query matched.
- **Workflow End node outcomes**: Workflow End nodes accept an `outcome` of `success` (default) or `failure`, so a workflow can record whether a conversation ended successfully. The conversation error type adds `workflow_end_failure`.
- **Call queueing enabled for new agents**: New agents are created with [call queueing](/docs/eleven-agents/guides/call-queueing) enabled unless `platform_settings.queueing_config.enabled` is set explicitly. Existing agents keep their current setting.
- **Post-call audio webhook retries**: When **Enable retries** is on, `post_call_audio` [webhooks](/docs/eleven-agents/workflows/post-call-webhooks) are retried on the same schedule as transcription webhooks. Audio payloads over 50 MiB are not retried, and queued audio retries are capped at 400 MiB per webhook.
- **Strict tool overrides**: The conversation override `tool_ids_strict` makes an overridden `tool_ids` list the complete set of tools available in the conversation, including tools on workflow nodes. It is ignored when set on the agent itself.
- **Widget end confirmation**: The widget can ask users to confirm before ending a chat or call. Enable it with `end_confirmation_enabled` in the widget configuration or the `end-confirmation` attribute.
### Text to Speech
- **Audio effects**: [Text to Speech](/docs/api-reference/text-to-speech/convert) and [Text to Dialogue](/docs/api-reference/text-to-dialogue/convert) requests accept an optional `audio_effects` object. It applies a filter preset, perceived distance, a reverb environment, a looped background noise bed and stereo panning to the generated audio. List valid preset, environment and background noise IDs with `GET /v1/audio-effects/catalog`. Reverb and non-zero panning produce stereo audio and are rejected for `ulaw_*`, `alaw_*` and `pcm_*` output formats. Effects do not change the cost of a request.
### Speech to Text
- **Turn prediction commit strategy**: The [realtime Speech to Text WebSocket](/docs/api-reference/speech-to-text/v-1-speech-to-text-realtime) adds `turn_prediction` as a `commit_strategy` value. In addition to silence-based segmentation, it commits a segment as soon as the model predicts the speaker has finished their turn. It is the default for models that predict turns, and partial transcripts from those models include `turn_probability`. See [transcripts and commit strategies](/docs/eleven-api/guides/how-to/speech-to-text/realtime/transcripts-and-commit-strategies).
### Voices
- **Voice collections API**: Voice collections can now be managed through the API. Create, list, update and delete collections, and add or remove voices. See [List voice collections](/docs/api-reference/voices/collections/list).
### Workspaces
- **Basic seat fallback**: [Update member](/docs/api-reference/workspace/members/update) accepts `allow_downgrade_to_basic_seat`. When unlocking a user whose original seat type has no seats available, the user is moved to a basic seat instead of the request failing.
- **Workspace ID on user**: [Get user](/docs/api-reference/user/get) returns the `workspace_id` of the workspace the API key belongs to.
### SDK releases
#### JavaScript SDK
- [v2.72.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.72.0) - Added clients for voice collections, the audio effects catalog and triage ticket merging. Text to Speech and Text to Dialogue methods accept `audio_effects`, triage ticket list methods add search and filters, and the realtime Speech to Text client adds the `turn_prediction` commit strategy.
#### Python SDK
- [v2.72.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.72.0) - Added clients for voice collections, the audio effects catalog and triage ticket merging. Text to Speech and Text to Dialogue methods accept `audio_effects`, triage ticket list methods add search and filters, and the realtime Speech to Text client adds the `turn_prediction` commit strategy. `play()` and `save()` now accept any iterable of audio chunks, such as a list or tuple. `RealtimeEvents.CLOSE` handlers receive a dictionary with the WebSocket close `code` and `reason`; handlers without parameters continue to work.
#### ElevenLabs CLI
- [v1.5.0](https://github.com/elevenlabs/cli/releases/tag/v1.5.0) - Regenerated API commands, adding voice collections, the audio effects catalog, triage ticket merging and agent merge proposals.
#### Packages
- [@elevenlabs/client@1.27.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.27.0) and [@elevenlabs/react@1.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.17.0) - Added a `previousText` option to `Scribe.connect()` and `useScribe()` in microphone mode. The text is sent with the first audio chunk to give the model context, such as existing document text, for casing, punctuation and sentence continuation. `MediaDeviceOutput` now receives `libsampleratePath`, so output resampling uses the same custom libsamplerate bundle path as `MediaDeviceInput`.
- [@elevenlabs/react-native@1.2.29](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.29) - Updated to `@elevenlabs/client@1.27.0` and `@elevenlabs/react@1.17.0`.
- [@elevenlabs/convai-widget-core@0.19.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.19.0) and [@elevenlabs/convai-widget-embed@0.19.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.19.0) - Added an optional confirmation dialog before ending a chat or call, enabled with the `end-confirmation` attribute or `end_confirmation_enabled` config, with customizable text. Added carousel rich content with scrollable item cards that can include an image, subtitle, description and actions. Carousels remain in the transcript after a reply, without their actions. Rich content is now shown during voice calls when the transcript is visible.
### API
## New endpoints
### ElevenAgents
- [Merge tickets](/docs/api-reference/triage-tickets/merge) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/merge` - Merge open tickets into the target ticket. Requires `source_ticket_ids` (string array, 1–50 items) and returns the target ticket.
### Voices
- [List voice collections](/docs/api-reference/voices/collections/list) - `GET /v1/voices/collections` - List the voice collections the caller can access, sorted by title.
- [Create voice collection](/docs/api-reference/voices/collections/create) - `POST /v1/voices/collections` - Create a collection with required `title` and `icon` (string, maximum 1,000 characters each).
- [Get voice collection](/docs/api-reference/voices/collections/get) - `GET /v1/voices/collections/{collection_id}` - Retrieve a collection with its `title`, `icon` and the caller's `permission_on_resource` (`admin`, `editor`, `commenter` or `viewer`).
- [Update voice collection](/docs/api-reference/voices/collections/update) - `PATCH /v1/voices/collections/{collection_id}` - Update the optional `title` or `icon`.
- [Delete voice collection](/docs/api-reference/voices/collections/delete) - `DELETE /v1/voices/collections/{collection_id}`
- [Add voice to collection](/docs/api-reference/voices/collections/add-voice) - `POST /v1/voices/collections/{collection_id}/voice/{voice_id}`
- [Remove voice from collection](/docs/api-reference/voices/collections/remove-voice) - `DELETE /v1/voices/collections/{collection_id}/voice/{voice_id}`
### Audio effects
- `GET /v1/audio-effects/catalog` - List the available `filter_presets`, `environments` and `background_noises`. Each entry has an ID, a `name` and a nullable `description`.
## Updated endpoints
### ElevenAgents
- [Create agent](/docs/api-reference/agents/create), [Get agent](/docs/api-reference/agents/get) and [Update agent](/docs/api-reference/agents/update)
- Workflow End nodes add `outcome` (`success` or `failure`, default `success`). The field is required in responses.
- Standalone workflow agent nodes and agent transfer configurations add nullable `branch_id` (string) to target a specific branch of the destination agent. When unset, the transfer follows the target agent's traffic deployment. Transfer tool results add a `configured` branch reason.
- Prompt override configurations add `tool_ids_strict` (boolean, default `false`).
- TTS configuration `effects` add `pan` (number, -1 to 1, default `0`). The `seed` field is deprecated and has no effect.
- [Get widget config](/docs/api-reference/widget/get) - Added `end_confirmation_enabled` (boolean, default `false`).
- [List tickets](/docs/api-reference/triage-tickets/list)
- Added optional `search` (string, maximum 200 characters) and `merged_into_ticket_id` (string) query parameters.
- Ticket responses add nullable `merged_into_ticket_id` and nullable `search_match` with `field` (`title`, `description`, `comment` or `turn_comment`), `snippet`, `highlight_start`, `highlight_end` and nullable `turn_index`.
- [List workspace tickets](/docs/api-reference/triage-tickets/list-for-workspace) - Added optional `agent_id`, `sources`, `priorities`, `sort_by` (`created_at` or `priority`, default `created_at`), `owner_user_id`, `issue_type`, `label`, `merged_into_ticket_id` and `search` query parameters.
- [List tests](/docs/api-reference/tests/list) - Added optional `created_by_user_id` (string). Use `@me` for the authenticated user.
- [List test invocations](/docs/api-reference/tests/test-invocations/list) - Added optional `test_id` (string), `version_id` (string), `start_time` and `end_time` (integer, Unix seconds, inclusive) query parameters.
- [Update agent branch](/docs/api-reference/agents/branches/update) - Added optional `auto_rebase` (boolean). Branch responses add `auto_rebase` (boolean, default `false`).
- [Get conversation details](/docs/api-reference/conversations/get)
- Twilio, SIP trunk and Exotel phone call metadata add nullable `call_result` with `answered`, `voicemail`, `busy`, `no_answer` and `failed` values.
- Batch call metadata adds nullable `cold_attempt` (integer) and nullable `conversation_type` (`initial`, `retry`, `callback` or `redirect`).
- The conversation error type adds `workflow_end_failure`.
- Knowledge base auto-sync `auto_discover` is deprecated and no longer has any effect.
### Text to Speech
- [Create speech](/docs/api-reference/text-to-speech/convert), [Stream speech](/docs/api-reference/text-to-speech/stream), [Create speech with timing](/docs/api-reference/text-to-speech/convert-with-timestamps) and [Stream speech with timing](/docs/api-reference/text-to-speech/stream-with-timestamps)
- Added optional nullable `audio_effects` with `filter_preset_id` (string), `distance` (number, 0–1, default `0`), `environment_id` (string), `background_noise_id` (string), `send_level` (number, 0–1, default `1`) and `pan` (number, -1 to 1, default `0`).
- Unknown effect IDs return `404`. Stereo effects return `400` for `ulaw_*`, `alaw_*` and `pcm_*` output formats.
### Text to Dialogue
- [Create dialogue](/docs/api-reference/text-to-dialogue/convert), [Stream dialogue](/docs/api-reference/text-to-dialogue/stream), [Create dialogue with timestamps](/docs/api-reference/text-to-dialogue/convert-with-timestamps) and [Stream dialogue with timestamps](/docs/api-reference/text-to-dialogue/stream-with-timestamps) - Added optional nullable `audio_effects`, matching the Text to Speech endpoints.
### Speech to Text
- [Realtime Speech to Text](/docs/api-reference/speech-to-text/v-1-speech-to-text-realtime)
- The `commit_strategy` query parameter adds `turn_prediction`, alongside `manual` and `vad`.
- `partial_transcript` messages add optional `turn_probability` (number), sent only for models that predict turns.
### Music
- `POST /v1/music/video-to-music` - Responses add a `song-id` header with the ID of the generated song.
### History
- [List generated items](/docs/api-reference/history/list) - The history item `source` enum adds `VoicePreview`.
### Workspace and user
- [Update member](/docs/api-reference/workspace/members/update) - Added optional `allow_downgrade_to_basic_seat` (boolean, default `false`).
- [Get user](/docs/api-reference/user/get) - Added required `workspace_id` (string).
- Service account API key permissions add `voice_collections_read` and `voice_collections_write`.
## October 5, 2026
### ElevenAgents
- **Structured procedures compile on save and publish**: [Update agent](/docs/api-reference/agents/update) and [Create agent draft](/docs/api-reference/agents/drafts/create) now compile and validate [structured procedures](/docs/eleven-agents/customization/procedures/structured-procedures) automatically. Integrations no longer need to call the compile endpoint or manually update the generated workflow. Invalid procedures return per-procedure errors as `400 procedure_validation_failed`. Agents without structured procedures are unaffected.
- **Compile procedures endpoint is legacy**: [Compile procedures](/docs/api-reference/agents/procedures/compile) is marked legacy and should not be used by new integrations. It remains available for existing callers.
- **Merge proposals**: Merge proposals are available in alpha. Teams can open a proposal for an agent branch, review configuration changes and test results, leave comments or approval decisions, and merge approved changes into a target branch. See [Merge proposals](/docs/eleven-agents/operate/merge-proposals).
### SDK releases
#### JavaScript SDK
- [v2.71.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.71.0) - Added clients for agent merge proposals, deployment history, test invocation cancellation and Speech Engine duplication. The release also adds triage ticket priorities and sorting, batch call export limits, `gpt-6.1-sol`, `claude-sonnet-5-5`, Eleven v4 agent voice models and current agent configuration types.
#### Python SDK
- [v2.71.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.71.0) - Added clients for agent merge proposals, deployment history, test invocation cancellation and Speech Engine duplication. The release also adds triage ticket priorities and sorting, batch call export limits, `gpt-6.1-sol`, `claude-sonnet-5-5`, Eleven v4 agent voice models and current agent configuration types.
#### Swift SDK
- [v3.4.0](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.4.0) - Dynamic variables now preserve native JSON types when sent in conversation initiation data.
#### Packages
- [@elevenlabs/client@1.26.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.26.0), [@elevenlabs/react@1.16.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.16.0), [@elevenlabs/react-native@1.2.28](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.28) and [@elevenlabs/types@0.24.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.24.0) - Added realtime Speech to Text transcript editing through `transcriptEdit`, the `edited_transcript` event and React's `onEditedTranscript` callback. React now forwards `filterBackgroundAudio` to realtime sessions. The client also exports `MessagePayload` and uses stable response IDs to prevent duplicate agent replies.
- [@elevenlabs/convai-widget-core@0.18.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.18.3) and [@elevenlabs/convai-widget-embed@0.18.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.18.3) - Added image previews and download links for agent message attachments, including attachment-only replies. Stable response IDs prevent duplicate replies, and text-only conversations now use a stop control with an **End chat** tooltip.
### API
## New endpoints
### ElevenAgents
- [Create a merge proposal](/docs/api-reference/agents/merge-proposals/create) - `POST /v1/convai/agents/{agent_id}/merge-proposals` - Create a proposal with required `source_branch_id`, `target_branch_id` and `title` fields, plus an optional description, reviewer IDs and triage ticket ID.
- [List merge proposals](/docs/api-reference/agents/merge-proposals/list) - `GET /v1/convai/agents/{agent_id}/merge-proposals` - List proposals with status, source branch, target branch and text filters, plus cursor pagination.
- [Get a merge proposal](/docs/api-reference/agents/merge-proposals/get) - `GET /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}` - Retrieve a proposal and its review, comment and outcome details.
- [Update a merge proposal](/docs/api-reference/agents/merge-proposals/update) - `PATCH /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}` - Update its title, description or requested reviewers, or close it without merging.
- [Review a merge proposal](/docs/api-reference/agents/merge-proposals/submit-review) - `POST /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}/reviews` - Submit an `approved` or `changes_requested` decision with an optional comment.
- [Comment on a merge proposal](/docs/api-reference/agents/merge-proposals/add-comment) - `POST /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}/comments` - Add a Markdown comment of up to 4,096 characters.
- [Merge a merge proposal](/docs/api-reference/agents/merge-proposals/merge) - `POST /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}/merge` - Merge the source branch and optionally control forced conflict resolution and source branch archival.
- [List agent deployments](/docs/api-reference/agents/deployments/list) - `GET /v1/convai/agents/{agent_id}/deployments` - List current and historical branch traffic splits with page-based pagination.
- [Cancel a test invocation](/docs/api-reference/tests/test-invocations/cancel) - `POST /v1/convai/test-invocations/{test_invocation_id}/cancel` - Cancel a running test invocation.
### Speech Engine
- [Duplicate a Speech Engine](/docs/api-reference/speech-engine/duplicate) - `POST /v1/speech-engine/{speech_engine_id}/duplicate` - Duplicate a Speech Engine and optionally assign the copy a new `name`.
## Updated endpoints
### ElevenAgents
- [Create agent](/docs/api-reference/agents/create), [Get agent](/docs/api-reference/agents/get) and [Update agent](/docs/api-reference/agents/update)
- Added `gpt-6.1-sol` and `claude-sonnet-5-5` to the `LLM` enum.
- Added `eleven_v4` and `eleven_v4_turbo` to the conversational TTS model options. The default changed from `eleven_flash_v2` to `eleven_v4_turbo`.
- Agent transfers and standalone workflow agent nodes add optional `preserve_voice_settings` (boolean, default `false`) to retain the base voice, TTS model and voice settings after a transfer.
- Skip-turn tool configurations add optional `wait_timeout_secs` (number, default `-1`). A value of `-1` keeps the agent silent until the caller speaks.
- Post-call webhook configurations add optional `exclude_transcript` (boolean, default `false`) to omit turn-by-turn transcripts from JSON transcription webhooks.
- Conversation history redaction configurations add optional `excluded_data_collection_ids` (string array, maximum 50) to preserve selected extracted values while redacting their rationales.
- Client tool `response_timeout_secs` now accepts `-1` to wait indefinitely when `expects_response` is enabled.
- [List tickets](/docs/api-reference/triage-tickets/list)
- Added optional `priorities` (array) with `low`, `medium`, `high` and `urgent` values.
- Added `sort_by` with `created_at` and `priority` values; the default is `created_at`.
- Ticket responses now require `title`, nullable `priority`, and a `priority_changes` array. Ticket creation and update requests can set `priority`, and ticket status adds `cancelled`.
- [List tools](/docs/api-reference/tools/list) - Added optional nullable `used_by_agent_id` (string) to return tools referenced by an agent's main branch.
- [Export batch call results](/docs/api-reference/batch-calling/export) - Added optional nullable `limit` (integer, minimum `1`) to export only the first recipients as a column preview.
- [List test invocations](/docs/api-reference/tests/test-invocations/list) and [Get test invocation](/docs/api-reference/tests/test-invocations/get)
- Test invocation summaries add required `cancelled_count` (integer) and optional `cancelled` (boolean, default `false`).
- Test run status adds `cancelled`.
- [Get conversation details](/docs/api-reference/conversations/get) - Transcript entries add optional nullable `platform_event` with `user_turn_timeout` and `skip_turn_wait_elapsed` values.
- [Get agent version metadata](/docs/api-reference/agents/versions/get) - Added optional nullable `merged_authors`, an array describing the people who published changes merged into the main branch.
- [Get crawl job](/docs/api-reference/knowledge-base/get-crawl-job) - Removed the deprecated `max_depth` response field.
## September 28, 2026
import { YoutubeEmbed } from "../../../components/YoutubeEmbed";
### Eleven v4 and Eleven v4 Turbo
[Eleven v4 and Eleven v4 Turbo](/docs/overview/capabilities/text-to-speech/eleven-v4) are now available. Eleven v4 provides higher-quality, more expressive speech and improved voice cloning across more than 90 languages. Eleven v4 Turbo provides the same model family for real-time applications, with median inference latency of approximately 100 ms.
Use `eleven_v4` through the Text to Dialogue API for content creation and long-form audio. Use `eleven_v4_turbo` through the Text to Dialogue WebSocket for agents and interactive applications.
Compare the two model variants, voice cloning behavior, settings and supported languages.
Generate high-quality dialogue with Eleven v4.
Stream Eleven v4 Turbo dialogue over a WebSocket connection.
### Speech to Text
- **Transcript editing**: Batch and realtime transcription now accept a natural-language edit instruction of up to 2,000 characters. Batch responses return the result in `edited_transcript`, while realtime sessions emit an `edited_transcript` event. See the [batch](/docs/eleven-api/guides/how-to/speech-to-text/batch/transcript-editing) and [realtime](/docs/eleven-api/guides/how-to/speech-to-text/realtime/transcript-editing) guides for incompatibilities, response handling and pricing.
### ElevenAgents
- **Agent models**: Added `gpt-6-sol`, `gpt-6-luna`, `glm-52`, `deepseek-v41-flash`, `claude-opus-5` and `claude-opus-5-5` to the supported agent LLM options.
- **Agent test usage**: Test invocation summaries can include total credits and USD price. Individual test runs can include credits and a charging breakdown.
### Flows
- **Template API**: Added endpoints to list and retrieve published Flows templates, start template runs and retrieve run results. Runs can target a published version and send their terminal result to a configured webhook.
### Text to Dialogue
- **Generation continuity**: Text to Dialogue requests can use preceding or following text and request IDs to maintain continuity across generations.
- **Professional voice mode**: Text to Dialogue requests can use the Instant Voice Clone version of a Professional Voice Clone to reduce latency or improve expressiveness.
### SDK releases
#### JavaScript SDK
- [v2.70.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.70.0) - Added batch and realtime Speech to Text transcript editing types, `branchId` filtering and cost fields for test invocation summaries, knowledge base auto-discovery, Text to Dialogue `usePvcAsIvc` and the `deepseek-v41-flash` agent model.
#### Python SDK
- [v2.70.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.70.0) - Added batch and realtime Speech to Text transcript editing types, `branch_id` filtering and cost fields for test invocation summaries, knowledge base auto-discovery, Text to Dialogue `use_pvc_as_ivc` and the `deepseek-v41-flash` agent model.
#### ElevenLabs CLI
- [v1.4.0](https://github.com/elevenlabs/cli/releases/tag/v1.4.0) - Fixed requests with an explicit API key so they no longer also send stored OAuth credentials, which caused authentication failures. Added descriptions for the feedback command group and instructions for reporting missing capabilities to generated agent skills. Regenerated the API client with Flows template endpoints and current schema types.
### API
## New endpoints
### Flows
- [List templates](/docs/api-reference/flows/templates/list) - `GET /v1/flows/templates` - List published templates and their runnable versions.
- [Get template](/docs/api-reference/flows/templates/get) - `GET /v1/flows/templates/{template_id}` - Retrieve a template and its runnable versions.
- [Create template run](/docs/api-reference/flows/templates/runs/create) - `POST /v1/flows/templates/{template_id}/runs` - Start a template run with input values, an optional version and an optional webhook.
- [List template runs](/docs/api-reference/flows/templates/runs/list) - `GET /v1/flows/templates/{template_id}/runs` - List template runs with cursor pagination and optional version filtering.
- [Get template run](/docs/api-reference/flows/templates/runs/get) - `GET /v1/flows/templates/{template_id}/runs/{run_id}` - Retrieve a template run and its output status.
## Updated endpoints
### Speech to Text
- [Convert speech to text](/docs/api-reference/speech-to-text/convert) - `POST /v1/speech-to-text`
- Added optional nullable `transcript_edit` (string), which accepts a natural-language edit instruction of up to 2,000 characters.
- Responses add optional nullable `edited_transcript`. A successful edit contains required `kind: "transcript"` and `text` fields. A failed edit contains required `kind: "error"`, `error_type: "edit_failed"` and `message` fields.
- [Realtime Speech to Text](/docs/api-reference/speech-to-text/v-1-speech-to-text-realtime) accepts `transcript_edit` (string) and emits `edited_transcript` events with required `text` and `edited_text` fields.
### ElevenAgents
- [Create agent](/docs/api-reference/agents/create), [Get agent](/docs/api-reference/agents/get) and [Update agent](/docs/api-reference/agents/update)
- Added `gpt-6-sol`, `gpt-6-luna`, `glm-52`, `deepseek-v41-flash`, `claude-opus-5` and `claude-opus-5-5` to the `LLM` enum.
- Alerting monitors add optional nullable `enabled` (boolean) to control whether a monitor can send notifications.
- [List conversations](/docs/api-reference/conversations/list) and [Text search](/docs/api-reference/conversations/messages/text-search)
- `data_collection_params` and `dynamic_variable_params` add `neq` and `in` operators. Values for `in` use a pipe delimiter.
- `evaluation_params` accepts `success`, `failure` or `unknown` as the result value.
- [Smart search](/docs/api-reference/conversations/messages/search) - `GET /v1/convai/conversations/messages/smart-search`
- Added optional nullable `branch_id` (string).
- [List test invocations](/docs/api-reference/tests/test-invocations/list) - `GET /v1/convai/test-invocations`
- Added optional nullable `branch_id` (string).
- Test invocation summaries add optional nullable `credits_used` (integer) and `total_price` (number).
- [Get test invocation](/docs/api-reference/tests/test-invocations/get) - `GET /v1/convai/test-invocations/{test_invocation_id}`
- Individual test runs add optional nullable `credits_used` (integer) and `charging` (`ConversationChargingCommonModel`).
- [Simulate conversation](/docs/api-reference/agents/simulate-conversation) and [Simulate conversation stream](/docs/api-reference/agents/simulate-conversation-stream)
- Changed the optional `new_turns_limit` default from `10,000` to `100` and set its maximum to `100`.
- [Create crawl job](/docs/api-reference/knowledge-base/create-crawl-job) and [Get crawl job](/docs/api-reference/knowledge-base/get-crawl-job)
- Added optional `auto_discover` (boolean, default `false`) to follow links and add newly discovered pages during auto-sync. This requires `enable_auto_sync: true`.
- [Refresh knowledge base document](/docs/api-reference/knowledge-base/refresh) - `POST /v1/convai/knowledge-base/{documentation_id}/refresh`
- `AutoSyncInfo` adds optional `auto_discover` (boolean, default `false`) to indicate whether refreshes crawl and add newly discovered pages.
- [List MCP server tools](/docs/api-reference/mcp/list-tools) - `GET /v1/convai/mcp-servers/{mcp_server_id}/tools`
- Responses add optional `tool_approval_statuses` (array). Each item contains required `tool_id` (string) and `state` (`up_to_date`, `needs_review` or `not_approved`), with optional approval policy and approved-definition fields.
### Text to Dialogue
- [Convert text to dialogue](/docs/api-reference/text-to-dialogue/convert), [Stream text to dialogue](/docs/api-reference/text-to-dialogue/stream), [Convert with timestamps](/docs/api-reference/text-to-dialogue/convert-with-timestamps) and [Stream with timestamps](/docs/api-reference/text-to-dialogue/stream-with-timestamps)
- Added optional `use_pvc_as_ivc` (boolean, default `false`) to use the Instant Voice Clone version of a Professional Voice Clone.
- Added optional nullable `previous_text` and `future_text` (strings, maximum 100 characters) and `previous_request_ids` and `next_request_ids` (string arrays, maximum 3 IDs) for generation continuity.
- The optional `settings` object adds nullable `similarity` (number, 0–1, default `0.75`).
### Text to Speech
- [Convert text to speech](/docs/api-reference/text-to-speech/convert), [Stream text to speech](/docs/api-reference/text-to-speech/stream), [Convert with timestamps](/docs/api-reference/text-to-speech/convert-with-timestamps) and [Stream with timestamps](/docs/api-reference/text-to-speech/stream-with-timestamps)
- The existing `use_pvc_as_ivc` field is no longer deprecated.
### Flows
- [Create image generation](/docs/api-reference/flows/image/create), [Create video generation](/docs/api-reference/flows/video/create) and [Create template run](/docs/api-reference/flows/templates/runs/create)
- Webhook targets now require an explicit `type` discriminator (`all` or `ids`). The previous defaults were removed.
### Voice Design
- [Create voice from preview](/docs/api-reference/text-to-voice/create), [Create voice previews](/docs/api-reference/legacy/voices/create-previews), [Design a voice](/docs/api-reference/text-to-voice/design) and [Remix a voice](/docs/api-reference/text-to-voice/remix)
- Added a `409` response when a generation for the preview is already in progress. Retry the request after receiving this response.
### Workspaces
- [Create service account API key](/docs/api-reference/service-accounts/api-keys/create) - `POST /v1/service-accounts/{service_account_user_id}/api-keys`
- Added optional nullable `tts_concurrency_limit`, `music_concurrency_limit` and `dubbing_concurrency_limit` (integers) for enterprise service account API keys.
- [Update service account API key](/docs/api-reference/service-accounts/api-keys/update) - `PATCH /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id}`
- Added optional `tts_concurrency_limit`, `music_concurrency_limit` and `dubbing_concurrency_limit`. Each field accepts an integer, `clear`, `no_update` or `null` and defaults to `no_update`.
### Models
- [List models](/docs/api-reference/models/list) - `GET /v1/models`
- Deprecated required `max_characters_request_free_user` and `max_characters_request_subscribed_user`. These fields are not enforced; use `maximum_text_length_per_request` instead.
## September 23, 2026
### Imagem e Vídeo
- **Sora 2 e Sora 2 Pro descontinuados**: A OpenAI descontinuará a API Sora em 24 de setembro de 2026. Ambos os modelos foram removidos do seletor de modelos de Imagem e Vídeo e deixarão de gerar nessa data. As gerações existentes continuarão disponíveis no seu histórico. Flows e modelos que usam um nó do Sora precisam ser alterados para outro modelo de vídeo, como o [Gemini Omni 1.1 Flash](/docs/pt/overview/capabilities/image-video), antes de poderem ser executados novamente.
- **Seedance 1.5 Pro descontinuado**: A ByteDance descontinuará o Seedance 1.5 Pro em 11 de novembro de 2026. O modelo não é mais oferecido para novas gerações e deixará de funcionar nessa data. Use um [modelo Seedance 2.0](/docs/pt/overview/capabilities/image-video) em vez disso.
## September 21, 2026
### ElevenAgents
- **Chamadas paralelas de ferramentas**: A configuração de prompt do agente agora inclui `enable_parallel_tool_calls` (booleano, padrão `true`). Quando ativado, os modelos compatíveis podem executar várias ferramentas em um turno.
- **Modelos de agente**: Adicionado `gpt-6-astra` às opções de LLM do agente.
- **Alertas**: Os alertas do agente agora oferecem suporte a canais do Slack, além de notificadores do PagerDuty e webhooks.
- **Busca de números de telefone**: Adicionado um endpoint de números de telefone com paginação por cursor e filtros de provedor, suporte a chamadas de saída, agente e ramificação atribuídos, rótulo e número de telefone.
### Imagem e vídeo
- **Modelos GPT Image 2.5**: A [geração de imagens](/docs/pt/api-reference/flows/image/create) agora oferece suporte a `gpt-image-2.5-flare` e `gpt-image-2.5-sunburst`. Ambos os modelos aceitam até 10 imagens de referência, níveis de qualidade até `max`, 14 proporções fixas mais `auto` e saída em 1K, 2K ou 4K.
### Speech Engine
- **Tempo limite de cascata**: As solicitações de criação e atualização do Speech Engine agora aceitam `cascade_timeout_seconds` (número, 2–15, padrão `4`) para controlar por quanto tempo a ElevenLabs aguarda um mecanismo de voz upstream antes de tentar novamente.
### Text to Speech
- **Limites de turno em múltiplos contextos**: O marcador `is_final_audio_for_turn` agora é emitido após cada byte armazenado em buffer para aquele turno, incluindo saídas MP3 e Opus. Os clientes podem usar o marcador como um limite exato de turno sem precisar mudar para PCM.
### Lançamentos de SDKs
#### SDK JavaScript
- [v2.69.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.69.0) - Adicionado `transcriptEdit` ao wrapper de Speech to Text em tempo real, com texto editado entregue por eventos `edited_transcript`. Corrigida a verificação de JWT do Speech Engine para chaves de API com sufixos de residência de dados. Adicionados `phoneNumbers.listV2` e métodos de modelos do Flows para listar e obter modelos, além de listar, criar e obter execuções. Clientes e tipos regenerados para GPT Image 2.5, alertas de agente no Slack, chamadas paralelas de ferramentas, `gpt-6-astra`, limites de simultaneidade de chaves de API de contas de serviço, retenção zero de Música, filtros de conversa e status de aprovação de ferramentas MCP.
#### SDK Python
- [v2.69.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.69.0) - Adicionado `transcript_edit` ao wrapper de Speech to Text em tempo real, com texto editado entregue por eventos `edited_transcript`. Corrigida a verificação de JWT do Speech Engine para chaves de API com sufixos de residência de dados, e `play` agora gera um erro quando `ffplay` falha. Adicionados `phone_numbers.list_v2` e métodos de modelos do Flows para listar e obter modelos, além de listar, criar e obter execuções. Clientes e tipos regenerados para GPT Image 2.5, alertas de agente no Slack, chamadas paralelas de ferramentas, `gpt-6-astra`, limites de simultaneidade de chaves de API de contas de serviço, retenção zero de Música, filtros de conversa e status de aprovação de ferramentas MCP.
#### CLI da ElevenLabs
- [v1.3.2](https://github.com/elevenlabs/cli/releases/tag/v1.3.2) - Adicionados metadados opcionais `--intent` para coletar feedback sobre o uso da CLI. Adicionado `elevenlabs feedback missing-capability` para relatar workflows que a CLI não oferece suporte.
### API
## Novos endpoints
### ElevenAgents
- [Listar página de números de telefone](/docs/pt/api-reference/phone-numbers/list-v-2) - `GET /v1/convai/v2/phone-numbers`
- Adicionados parâmetros de paginação `page_size` (inteiro, 1–1.000, padrão `100`) e `cursor` (string anulável) opcionais.
- Adicionados filtros opcionais `search`, `label`, `phone_number`, `provider`, `supports_outbound`, `agent_id`, `branch_id`, `sort_by` e `sort_direction`. `sort_by` aceita `label` ou `phone_number`; `sort_direction` tem como padrão `asc`.
- A resposta contém `phone_numbers` (array) obrigatório, `next_cursor` (string) anulável e opcional, e `has_more` (booleano, padrão `false`).
## Endpoints atualizados
### ElevenAgents
- [Criar agente](/docs/pt/api-reference/agents/create), [Obter agente](/docs/pt/api-reference/agents/get) e [Atualizar agente](/docs/pt/api-reference/agents/update)
- A configuração de prompt adiciona `enable_parallel_tool_calls` (booleano, padrão `true`). As substituições de workflow aceitam um booleano anulável.
- A enumeração `LLM` adiciona `gpt-6-astra`, incluindo substituições de início de conversa.
- Os notificadores de integração de alertas agora usam `integration_type` para selecionar `pagerduty` ou `slack`. Os notificadores do Slack exigem `connection_id` e `channel_id` (strings); `channel_id` aceita de 1 a 64 caracteres.
- [Listar conversas](/docs/pt/api-reference/conversations/list) e [Resolver referência de conversa](/docs/pt/api-reference/conversations/resolve)
- `data_collection_params` não aceita mais o operador `missing`. Use um valor vazio para encontrar conversas nas quais o campo não foi coletado.
- Um valor vazio em `dynamic_variable_params` encontra conversas em que a variável não foi definida.
- [Criar Speech Engine](/docs/pt/api-reference/speech-engine/create), [Obter Speech Engine](/docs/pt/api-reference/speech-engine/get) e [Atualizar Speech Engine](/docs/pt/api-reference/speech-engine/update)
- Adicionado `cascade_timeout_seconds` (número, 2–15). As solicitações de criação usam `4` como padrão, as solicitações de atualização aceitam um valor anulável e as respostas exigem o campo.
### Imagem e vídeo
- [Criar geração de imagem](/docs/pt/api-reference/flows/image/create) - `POST /v1/flows/image`
- Adicionadas variantes de solicitação para `gpt-image-2.5-flare` e `gpt-image-2.5-sunburst`.
- Ambas as variantes exigem `prompt` e `model_id`, aceitam até 10 `images` e adicionam `resolution` (`1K`, `2K` ou `4K`, padrão `1K`).
- `quality` aceita `low`, `medium`, `high`, `xhigh` ou `max` e tem como padrão `high`. `aspect_ratio` aceita `auto` e 14 proporções fixas, e tem como padrão `16:9`.
### Dublagem
- [Criar projeto de dublagem](/docs/pt/api-reference/dubbing/create-project) - `POST /v1/dubbing/project`
- O `keyterms` multipart aceita campos repetidos ou um único array JSON.
- O `webhook_ids` multipart aceita campos repetidos, um único array JSON ou uma string separada por vírgulas.
- [Obter recurso do workspace](/docs/pt/api-reference/workspace/resources/get), [Compartilhar recurso do workspace](/docs/pt/api-reference/workspace/resources/share) e [Remover compartilhamento de recurso do workspace](/docs/pt/api-reference/workspace/resources/unshare)
- `WorkspaceResourceType` adiciona `dubbing_project`.
### Base de conhecimento
- [Criar tarefa de rastreamento](/docs/pt/api-reference/knowledge-base/create-crawl-job) - `POST /v1/convai/knowledge-base/crawl`
- `max_depth` (inteiro, padrão `3`) foi descontinuado. O campo agora não tem efeito e não possui mais restrições mínimas ou máximas.
- Os metadados da tarefa de rastreamento não exigem mais `max_depth`.
### Usuário
- [Obter usuário](/docs/pt/api-reference/user/get) e [Obter assinatura](/docs/pt/api-reference/user/subscription/get)
- As enumerações de moeda adicionam `gbp`.
## Alterações de esquema
### Text to Speech
- As mensagens WebSocket `audio` e `final` de múltiplos contextos agora definem `is_final_audio_for_turn` como ocorrendo após a entrega de todos os bytes armazenados em buffer para o turno.
## September 14, 2026
### ElevenAgents
- **Fila de chamadas e áudio de espera**: Adicionamos [fila de chamadas](/docs/pt/eleven-agents/guides/call-queueing) para agentes que atingiram o limite de simultaneidade. Quem liga e entra na fila ouve áudio de espera e recebe eventos `queue_status` até ser atendido ou o tempo se esgotar. Novos métodos da API permitem enviar ou excluir áudio de espera personalizado.
- **Metadados de versão de teste**: Os resultados de teste do agente agora identificam a versão do agente usada e se incluíam alterações de rascunho. Os resumos de invocação também indicam quando reenvios parciais foram executados em versões diferentes.
- **Metadados de modelo e conta**: A configuração de LLM do agente agora aceita `gemini-3.8-flash`. As respostas de contas do WhatsApp identificam se a conta usa a Cloud API ou o fluxo de cadastro coexistente.
### Música
- **Suporte à API Music v2.5**: Os endpoints e SDKs de Música agora aceitam `music_v2_5`. Os blocos de geração de planos de composição suportam até 6.132 caracteres, com até 30 linhas de 200 caracteres cada.
### Lançamentos de SDKs
#### SDK JavaScript
- [v2.68.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.68.0) - Adicionados métodos para enviar e excluir áudio de espera do agente. Tipos regenerados para fila de chamadas, referências de procedimentos, criação de ramificação de rascunho, limites de consultas RAG, metadados de versão de teste, `gemini-3.8-flash` e `music_v2_5`.
#### SDK Python
- [v2.68.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.68.0) - Adicionados métodos síncronos e assíncronos para enviar e excluir áudio de espera do agente. Tipos regenerados para fila de chamadas, procedimentos, criação de ramificação de rascunho, limites de consultas RAG, metadados de versão de teste, `gemini-3.8-flash` e `music_v2_5`. O wrapper `compose_detailed` agora aceita todos os IDs de modelo de música gerados e planos de composição baseados em prompt e em blocos.
#### SDK iOS
- [v3.3.1](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.3.1) - Reconcilia mensagens do agente por `response_id` em vez de `event_id`, preservando várias respostas durante chamadas de ferramentas e evitando que partes transmitidas ou correções sejam associadas à mensagem errada.
#### CLI da ElevenLabs
- [v1.3.0](https://github.com/elevenlabs/cli/releases/tag/v1.3.0) - Adicionados metadados opcionais `--intent` aos comandos de API gerados. Adicionado `elevenlabs feedback missing-capability` para relatar workflows que a CLI não oferece suporte.
#### Pacotes
- [@elevenlabs/convai-widget-core@0.18.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.18.2) e [@elevenlabs/convai-widget-embed@0.18.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.18.2) - Corrigidas respostas duplicadas do agente após chamadas de ferramentas e procedimentos. As respostas de texto transmitidas mantêm a formatação Markdown, e conversas por voz não exibem mais partes de chat transmitidas que não foram faladas. O pacote embed também limita os eventos `user_activity` a uma vez por segundo e remove o limite quando uma sessão termina.
### API
## Novos endpoints
### ElevenAgents
- [Enviar áudio de espera do agente](/docs/pt/api-reference/agents/hold-audio/create) - `POST /v1/convai/agents/{agent_id}/hold-audio`
- Aceita o campo obrigatório `hold_audio_file` (binário) como dados de formulário multipart. O arquivo deve ser MP3 ou WAV, de até 40 MB e 180 segundos.
- Retorna `agent_id` (string) e `hold_audio` (`AgentHoldAudioConfig`) obrigatórios. O objeto de áudio de espera exige `audio_path`, `audio_url`, `original_filename` (strings), `duration_secs` (número) e `size_bytes` (inteiro).
- [Excluir áudio de espera do agente](/docs/pt/api-reference/agents/hold-audio/delete) - `DELETE /v1/convai/agents/{agent_id}/hold-audio`
- Remove o clipe personalizado para que quem está na fila ouça o tom de espera padrão.
- Retorna `agent_id` (string) obrigatório.
## Endpoints atualizados
### ElevenAgents
- [Criar agente](/docs/pt/api-reference/agents/create), [Obter agente](/docs/pt/api-reference/agents/get) e [Atualizar agente](/docs/pt/api-reference/agents/update)
- Adicionado `platform_settings.queueing_config` (`AgentQueueingConfig`) opcional com `enabled` (booleano, padrão `false`) e `wait_timeout_seconds` (inteiro, 1–1.800, padrão `180`).
- As respostas de configuração de fila incluem `hold_audio` (`AgentHoldAudioConfig`) anulável e somente leitura. As respostas do agente também incluem `default_hold_audio_url` (string) opcional.
- [Obter conversa](/docs/pt/api-reference/conversations/get) - `GET /v1/convai/conversations/{conversation_id}`
- Os metadados adicionam `queue_wait_secs` (número) anulável e opcional. O tempo na fila não é incluído em `call_duration_secs` nem no tempo cobrado.
- [Criar ramificação do agente](/docs/pt/api-reference/agents/branches/create) - `POST /v1/convai/agents/{agent_id}/branches`
- Adicionado `include_draft` (booleano, padrão `false`) opcional. Quando `true`, uma ramificação criada a partir da ponta da ramificação inclui o conjunto de procedimentos em rascunho de quem fez a chamada.
- [Listar procedimentos](/docs/pt/api-reference/agents/procedures/list) e endpoints de criação, obtenção e rascunho de procedimentos
- Os itens da lista adicionam `referenced_tool_ids`, `referenced_kb_ids`, `referenced_procedure_ids` e `referenced_dynamic_variables` (arrays de strings) opcionais.
- As respostas do agente e da prévia de mesclagem adicionam `procedures` opcional, um mapa indexado por ID de procedimento.
- [Listar invocações de teste](/docs/pt/api-reference/tests/test-invocations/list) - `GET /v1/convai/test-invocations`
- Adicionado `search` (string) anulável e opcional para filtrar testes e pastas por nome.
- [Executar testes no agente](/docs/pt/api-reference/tests/run-tests) e [Obter invocação de teste](/docs/pt/api-reference/tests/test-invocations/get)
- As respostas de invocação de conjunto de testes e execução de teste unitário adicionam `version_id` (string) anulável e opcional, além de `ran_against_draft` (booleano, padrão `false`) opcional.
- Os resumos de invocação também adicionam `runs_diverged_from_version` (booleano, padrão `false`) opcional.
- `POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query`
- O corpo da solicitação adiciona as substituições específicas da consulta `max_documents_length` (inteiro, 1–50.000) e `max_retrieved_rag_chunks_count` (inteiro, 1–20), opcionais e anuláveis.
- [Obter conta do WhatsApp](/docs/pt/api-reference/whats-app/accounts/get) - `GET /v1/convai/whatsapp-accounts/{phone_number_id}`
- Adicionado `account_type` (`WhatsAppAccountType`, padrão `cloud_api`) opcional. Os valores são `cloud_api` e `coexistence`.
- [Calcular uso esperado de LLM](/docs/pt/api-reference/agents/calculate) - `POST /v1/convai/agent/{agent_id}/llm-usage/calculate`
- `LLMUsageCalculatorLLMResponseModel` adiciona `price_per_message` (número) obrigatório.
### Música
- `MusicModelID` adiciona `music_v2_5` para `POST /v1/music/video-to-music`, `POST /v1/music/plan`, [Compor música](/docs/pt/api-reference/music/compose), `POST /v1/music/detailed`, `POST /v1/music/detailed/stream`, `POST /v1/music/stream`, `POST /v1/music/upload` e `POST /v1/music/finetunes`.
- `GenerationChunk.text` aumenta `maxLength` de 6.000 para 6.132 caracteres para `POST /v1/music/plan`, `POST /v1/music`, `POST /v1/music/detailed`, `POST /v1/music/detailed/stream`, `POST /v1/music/stream` e `POST /v1/music/upload`. Os nomes das seções podem conter de 1 a 100 caracteres, e os blocos podem conter até 30 linhas com 200 caracteres por linha.
## Alterações de esquema
### ElevenAgents
- Os eventos do servidor em tempo real adicionam `queue_status`. O `queue_status_event.status` obrigatório aceita `waiting`, `admitted` ou `timed_out`; `timed_out` precede o código de encerramento WebSocket `4300`. O áudio de espera continua chegando como eventos regulares de `audio`.
- A enumeração `LLM` adiciona `gemini-3.8-flash`, incluindo substituições de início de conversa.
- As uniões de resultados das ferramentas do sistema de conversa adicionam `start_procedure_success`, `start_procedure_error`, `end_procedure_success` e `end_procedure_error`.
- `FeaturesUsageCommonModel` adiciona status de recurso opcionais `freeform_procedure` e `structured_procedure`.
## September 11, 2026
### Scribe v2 Medical
O [Scribe v2 Medical](/docs/pt/overview/models#scribe-v2-medical) agora está disponível para todos. É um modelo de reconhecimento de fala em lote especializado em áudio médico e clínico, cobrado na mesma tarifa do Scribe v2.
Passe `scribe_v2_medical` como `model_id` em [Criar transcrição](/docs/pt/api-reference/speech-to-text/convert). Prompting de termos-chave, detecção de entidades, diarização de locutores e modo sem transcrição literal funcionam da mesma forma que no Scribe v2.
ID do modelo, recursos e quando usar o Scribe v2 Medical.
Transcreva áudio com `model_id` definido como `scribe_v2_medical`.
## September 7, 2026
### ElevenAgents
- **Tickets de conversa em todo o espaço de trabalho**: Adicionado [Listar tickets do espaço de trabalho](/docs/pt/api-reference/triage-tickets/list-for-workspace) para recuperar tickets de triagem de conversas entre os agentes acessíveis. Filtre por status ou responsável e use paginação por cursor para recuperar até 100 tickets por página.
- **Filtros de conversa por variáveis dinâmicas**: [Listar conversas](/docs/pt/api-reference/conversations/list) e [Pesquisar mensagens de conversa por texto](/docs/pt/api-reference/conversations/messages/text-search) agora aceitam filtros `dynamic_variable_params` repetíveis. Use `name:op:value` com `eq`, `gt`, `gte`, `lt` ou `lte`; os operadores de comparação exigem valores numéricos.
- **Detecção de secretária eletrônica da Twilio**: As configurações de telefonia de saída e de chamadas em lote agora oferecem suporte a `twilio_machine_detection` opcional. Escolha `enable` para uma identificação antecipada de pessoa ou máquina, ou `detect_message_end` para aguardar a conclusão da saudação da caixa postal. Os resultados chegam pelo novo evento de webhook `answering_machine_detection`.
- **Restrições de valores na coleta de dados**: As propriedades de coleta de dados agora podem usar `allowed_values` para nomear uma variável dinâmica que contém os valores permitidos. O campo anterior `allowed_values_dynamic_variable` está obsoleto.
- **Metadados do agente**: As respostas de [Listar ramificações de agentes](/docs/pt/api-reference/agents/branches/list) agora indicam quando um rascunho foi criado e se ele é anterior à ponta da ramificação. Os resumos de Agente e Speech Engine agora exigem `voice_id`.
- **URLs de origem da base de conhecimento**: Os trechos de consulta RAG do agente agora incluem `source_url` anulável e obrigatório, contendo a URL rastreada para documentos de URL.
- **Anexos de resposta do agente**: Os eventos WebSocket `agent_response` agora incluem `attachments` opcional. Cada anexo exige `url` e `name` e pode incluir `mime_type`.
### Espaços de trabalho
- **Limites de plataforma para chaves de API**: As respostas de chave de API da conta de serviço agora podem incluir `platform_limits` empresariais para créditos, Clones de Voz Profissionais e simultaneidade de TTS, Dublagem e Música.
### Lançamentos de SDKs
#### SDK JavaScript
- [v2.67.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.67.0) - Adicionado `dynamicVariableParams` às solicitações de listagem e pesquisa de texto de conversas. Tipos regenerados para detecção de secretária eletrônica da Twilio, restrições de valores na coleta de dados, limites de plataforma de chaves de API, metadados de rascunho de ramificações de agentes e URLs de origem da base de conhecimento.
#### SDK Python
- [v2.67.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.67.0) - Adicionado `dynamic_variable_params` aos métodos síncronos e assíncronos de listagem de conversas e pesquisa de texto. Tipos regenerados para detecção de secretária eletrônica da Twilio, restrições de valores na coleta de dados, limites de plataforma de chaves de API, metadados de rascunho de ramificações de agentes e URLs de origem da base de conhecimento. O cliente de conversão de texto em fala em tempo real não envia mais o sentinela interno de omissão para a conexão.
#### CLI da ElevenLabs
- [v1.2.0](https://github.com/elevenlabs/cli/releases/tag/v1.2.0) - Adicionado o comando `elevenlabs say` e sua habilidade de agente, regenerados os bindings de comandos da API e definido `eleven_v3` como o modelo TTS padrão.
#### Pacotes
- [@elevenlabs/client@1.25.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.25.0), [@elevenlabs/react@1.15.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.15.2), [@elevenlabs/react-native@1.2.27](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.27), [@elevenlabs/convai-widget-core@0.18.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.18.1) e [@elevenlabs/convai-widget-embed@0.18.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.18.1) - `MessageAttachment` foi reexportado de `@elevenlabs/client` para que os consumidores possam importar o tipo diretamente.
- [@elevenlabs/client@1.24.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.24.0), [@elevenlabs/types@0.23.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.23.0), [@elevenlabs/react@1.15.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.15.1), [@elevenlabs/react-native@1.2.26](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.26), [@elevenlabs/convai-widget-core@0.18.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.18.0) e [@elevenlabs/convai-widget-embed@0.18.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.18.0) - Encaminhados anexos de arquivos de respostas do agente para `onMessage` e adicionada a configuração de sessão opcional `webRtc.singlePeerConnection`. O widget também localiza botões de saudação e corrige respostas de chat de texto perdidas ou duplicadas.
### API
## Novos endpoints
### ElevenAgents
- [Listar tickets do espaço de trabalho](/docs/pt/api-reference/triage-tickets/list-for-workspace) - `GET /v1/convai/triage-tickets`
- Lista tickets de triagem de conversas em todos os agentes aos quais o solicitante tem acesso, ordenados do mais recentemente criado para o mais antigo.
- Adicionados os parâmetros de consulta opcionais `page_size` (inteiro, 1–100, padrão `100`), `status` (`AgentConversationTicketStatus`), `assignee_user_id` (string ou `unassigned`) e `cursor` (string).
- Retorna `GetAgentConversationTicketsPageResponseModel`.
## Endpoints atualizados
### ElevenAgents
- [Listar conversas](/docs/pt/api-reference/conversations/list) - `GET /v1/convai/conversations`
- Adicionado `dynamic_variable_params` opcional e anulável (array de strings repetível). Cada valor usa `name:op:value`, em que `op` é `eq`, `gt`, `gte`, `lt` ou `lte`.
- [Pesquisar mensagens de conversa por texto](/docs/pt/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
- Adicionado `dynamic_variable_params` opcional e anulável (array de strings repetível) com a mesma sintaxe.
- [Chamada de saída da Twilio](/docs/pt/api-reference/twilio/outbound-call), [Chamada de saída via tronco SIP](/docs/pt/api-reference/sip-trunk/outbound-call), [Chamada de saída da Exotel](/docs/pt/api-reference/exotel/outbound-call) e [Enviar chamadas em lote](/docs/pt/api-reference/batch-calling/submit)
- `telephony_call_config` agora usa esquemas separados de entrada e saída.
- Adicionado `twilio_machine_detection` opcional e anulável (`TwilioMachineDetectionConfig`). Seu `mode` aceita `enable` ou `detect_message_end` e o padrão é `enable`. A configuração é ignorada para provedores que não são Twilio e chamadas recebidas.
- [Importar número de telefone](/docs/pt/api-reference/phone-numbers/create) - `POST /v1/convai/phone-numbers`
- Adicionado `account_auth_token` opcional e anulável (string) para importações de chaves de API da Twilio validarem assinaturas de webhooks recebidos.
## Alterações de esquema
### ElevenAgents
- `WebhookEventType` adiciona `answering_machine_detection`.
- `AgentBranchSummary` adiciona `draft_created_at` opcional e anulável (inteiro) e `draft_is_behind_tip` opcional (booleano, padrão `false`).
- `AgentKnowledgeBaseRagChunkResponseModel` adiciona `source_url` obrigatório e anulável (string).
- `AgentSummaryResponseModel` e `SpeechEngineSummaryResponse` adicionam `voice_id` obrigatório (string).
- `AnalysisProperty` adiciona `name` opcional e anulável (string) e `allowed_values` (`AllowedValues`). `LiteralJsonSchemaProperty` também adiciona `allowed_values`. Ambos tornam `allowed_values_dynamic_variable` obsoleto.
- `DataCollectionResultCommonModel` adiciona `name` opcional e anulável (string).
- `WorkspaceApiKeyResponseModel` adiciona `platform_limits` opcional e anulável (`PlatformLimits`).
- A ferramenta MCP `Icon` adiciona `theme` opcional e anulável (`light` ou `dark`).
- `SMBToolConfig` adiciona as variantes de parâmetro `send_custom_email`, `create_service_quote_request` e `create_product_quote_request`.
- Os esquemas de parâmetros de consulta de webhook e a configuração de chamadas de telefonia agora usam modelos separados de entrada e saída.
- Os eventos WebSocket `agent_response` adicionam `attachments` opcional (array). Cada item exige `url` e `name` (strings) e aceita `mime_type` opcional (string).
### ElevenCreative
- `ReferenceVideo.studio_clip` agora usa `StudioClipLocator` em vez de `StudioClipReference`. Os campos e o formato de transmissão permanecem inalterados.
## August 31, 2026
### ElevenAgents
- **Entrada pelo teclado do telefone**: A configuração de conversa do agente agora oferece suporte a `dtmf_input_settings` opcional para [entrada DTMF](/docs/pt/eleven-agents/customization/multimodal-input#dtmf-input). Configure o tempo limite dos dígitos, use `#` como terminador e oculte as entradas do teclado em transcrições, logs e análises.
- **Histórico de anexos da conversa**: As entradas de transcrição de [Obter conversa](/docs/pt/api-reference/conversations/get) agora incluem `file_inputs`, um array que contém o ID, o nome, o tipo MIME e a URL de cada arquivo anexado.
- **Filtragem por tags de agentes**: [Listar agentes](/docs/pt/api-reference/agents/list) agora aceita um parâmetro de consulta `tags` opcional. Repita o parâmetro para encontrar agentes com qualquer uma das tags fornecidas.
- **Contexto de campanha em lote**: [Obter conversa](/docs/pt/api-reference/conversations/get) agora identifica chamadas em lote com metadados `campaign` anuláveis contendo os obrigatórios `campaign_id` e `campaign_lead_id`.
### Música
- **Dados visuais de forma de onda**: [Gerar música detalhada](/docs/pt/api-reference/music/compose-detailed), [Transmitir música com detalhes](/docs/pt/api-reference/music/compose-detailed-stream) e [Enviar música](/docs/pt/api-reference/music/upload) agora aceitam `with_waveform_visual` opcional (booleano, padrão `false`). As respostas com essa opção ativada retornam um array de inteiros `waveform_visual` de baixa resolução, com quatro amostras por segundo.
### Dublagem
- **Comportamento de paginação de projetos**: [Listar projetos de Dubbing](/docs/pt/api-reference/dubbing/list-projects) e [Listar idiomas de destino](/docs/pt/api-reference/dubbing/language-targets/list-language-targets) agora limitam `page_size` a 1–100. A filtragem de status do projeto inclui `queued`, e ambos os endpoints documentam o uso de `next_cursor` para buscar a próxima página.
### Lançamentos de SDKs
#### SDK JavaScript
- [v2.66.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.66.0) - Adicionado `fileIds` a `sendMultimodalMessage`, permitindo que uma mensagem inclua vários anexos de arquivo.
#### SDK Python
- [v2.66.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.66.0) - Adicionado `file_ids` a `send_multimodal_message`, permitindo que uma mensagem inclua vários anexos de arquivo.
#### SDK Android
- [v0.12.2](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.12.2) - Preservado o callback `onUnhandledClientToolCall` ao conectar eventos de sessão. Chamadas não tratadas de ferramentas do cliente que esperam uma resposta agora recebem a resposta automática de erro, em vez de permanecerem sem resolução.
#### CLI da ElevenLabs
- [v1.1.0](https://github.com/elevenlabs/cli/releases/tag/v1.1.0) - Regenerados os bindings de comandos da API e adicionada atribuição de solicitações por comando para workflows do ElevenAgents. Esses comandos acrescentam `cmd/` ao `User-Agent` da CLI, permitindo distinguir solicitações de workflows como `agents push` e `agents create`.
#### Pacotes
- [@elevenlabs/client@1.23.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.23.0), [@elevenlabs/react@1.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.15.0), [@elevenlabs/types@0.22.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.22.1), [@elevenlabs/react-native@1.2.25](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.25), [@elevenlabs/convai-widget-core@0.17.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.17.1) e [@elevenlabs/convai-widget-embed@0.17.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.17.1) - Adicionado `fileIds` a `sendMultimodalMessage`. O cliente envia os campos `file` e `files` para compatibilidade, e o React expõe a API de cliente atualizada.
### API
## Endpoints atualizados
### ElevenAgents
- [Listar agentes](/docs/pt/api-reference/agents/list) - `GET /v1/convai/agents`
- Adicionado `tags` opcional e anulável (array de strings). Repita o parâmetro de consulta para encontrar qualquer tag fornecida.
- [Criar agente](/docs/pt/api-reference/agents/create), [Obter agente](/docs/pt/api-reference/agents/get) e [Atualizar agente](/docs/pt/api-reference/agents/update)
- Adicionado `conversation_config.conversation.dtmf_input_settings` opcional e anulável (`DTMFInputConfig`). Ele oferece suporte a `dtmf_input_timeout` (número, 0,5–10 segundos, padrão `2`), `hash_terminator` (booleano, padrão `true`) e `redact_input` (booleano, padrão `false`).
- Adicionado `sip_refer_play_dialtone` opcional (booleano, padrão `true`) à configuração de transferência de número de telefone. Defina como `false` para manter a etapa original da chamada silenciosa enquanto uma transferência SIP REFER é concluída.
- As ferramentas de sistema de procedimento inicial e final agora aceitam um `ProcedureVersionRef` ou um `ProcedureDraftRef`. Referências de rascunho exigem `procedure_id` (string) e definem `version_id` como `null`.
- [Obter conversa](/docs/pt/api-reference/conversations/get) - `GET /v1/convai/conversations/{conversation_id}`
- Adicionado `file_inputs` (array de `ConversationHistoryTranscriptFileInputResponseModel`) às entradas de transcrição. Cada item exige `file_id`, `original_filename`, `mime_type` e `file_url` (strings).
- Adicionado `campaign` opcional e anulável (`BatchCallingCampaignInformation`) aos metadados de chamadas em lote. O objeto exige `campaign_id` e `campaign_lead_id` (strings).
- Adicionado `dtmf` a `ChatSourceMedium`.
- Os tipos de problema dos tickets de triagem de conversas adicionam `incorrect_information`, `documentation_gap`, `platform_bug` e `wrong_action`.
### Música
- [Gerar música detalhada](/docs/pt/api-reference/music/compose-detailed) (`POST /v1/music/detailed`) e [Transmitir música com detalhes](/docs/pt/api-reference/music/compose-detailed-stream) (`POST /v1/music/detailed/stream`)
- Adicionado `with_waveform_visual` opcional (booleano, padrão `false`).
- As respostas detalhadas adicionam `waveform_visual` anulável (array de inteiros), amostrado quatro vezes por segundo de `-1000` a `1000`.
- [Enviar música](/docs/pt/api-reference/music/upload) - `POST /v1/music/upload`
- Adicionados `with_waveform_visual` opcional (booleano, padrão `false`) e `waveform_visual` anulável (array de inteiros) na resposta.
### ElevenCreative
- [Criar projeto no Estúdio](/docs/pt/api-reference/studio/add-project) e [Criar podcast](/docs/pt/api-reference/studio/create-podcast)
- `quality_preset` agora aceita `null`, e o padrão do esquema `standard` foi removido.
### Dublagem
- [Listar projetos de Dubbing](/docs/pt/api-reference/dubbing/list-projects) - `GET /v1/dubbing/project`
- `page_size` continua sendo um inteiro opcional com padrão `20`, mas os valores agora são limitados a 1–100 em vez de rejeitados.
- O filtro `status` agora documenta `queued`, `preparing`, `ready` e `failed`.
- Passe o `next_cursor` da resposta anterior em `cursor`; omita-o na primeira página.
- [Listar idiomas de destino](/docs/pt/api-reference/dubbing/language-targets/list-language-targets) - `GET /v1/dubbing/project/{project_id}/language`
- `page_size` continua sendo um inteiro opcional com padrão `20`, mas os valores agora são limitados a 1–100 em vez de rejeitados.
- O filtro `status` oferece suporte a `queued`, `processing`, `completed`, `stale` e `failed`.
- Passe o `next_cursor` da resposta anterior em `cursor`; omita-o na primeira página.
## Alterações de esquema
### Espaço de trabalho
- `PendingSubscriptionSwitchResponseModel.next_tier` adiciona `grant`.
## August 24, 2026
import { YoutubeEmbed } from "../../../components/YoutubeEmbed";
### CLI da ElevenLabs
A [CLI da ElevenLabs v1.0.0](https://github.com/elevenlabs/cli/releases/tag/v1.0.0) já está disponível. Todas as operações da API da ElevenLabs estão disponíveis como subcomandos, com saída em JSON, tabela, YAML e CSV, paginação automática e preenchimento de comandos no shell.
A CLI também oferece workflows de configuração local para o ElevenAgents. Armazene configurações de agentes, ferramentas e testes como arquivos, sincronize-as com comandos push e pull, gerencie branches, execute testes, instale componentes de interface da ElevenLabs e selecione uma região de residência de dados.
Instale a CLI, autentique-se e gerencie agentes como código.
### Procedimentos
Os procedimentos agora estão disponíveis de forma geral no ElevenAgents. Um procedimento contém instruções específicas para uma tarefa e um gatilho que determina quando elas se aplicam. Durante uma conversa, o agente carrega o procedimento relevante, permitindo que um agente execute tarefas distintas sem incluir todas as instruções no prompt de sistema.
Use procedimentos de formato livre quando o agente puder adaptar a redação ou a ordem das instruções. Use procedimentos estruturados quando as etapas precisarem ser executadas em uma ordem definida. Os dois tipos podem ser usados junto com workflows no mesmo agente.
Saiba quando usar procedimentos e como eles se comparam a prompts e workflows.
Escreva instruções em linguagem natural que o agente pode adaptar à conversa.
Defina etapas tipadas que o agente segue em uma ordem consistente.
### ElevenAgents
- **Tickets de triagem de conversas**: adicionamos APIs para criar tickets sobre o desempenho de agentes, criar tickets manuais de acompanhamento, listar tickets, atribuir membros do workspace, atualizar status e responsável, além de adicionar comentários no nível do ticket ou do turno.
- **Observabilidade de conversas**: os clientes em tempo real podem receber um evento `context_usage` após cada turno concluído do agente. O evento informa o modelo, a contagem de tokens do prompt e o limite de contexto do modelo.
### Lançamentos de SDKs
#### SDK JavaScript
- [v2.65.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.65.0) - Adicionados clientes e tipos para tickets de triagem de conversas e resumos leves de conversas. As APIs de conversa adicionam filtros de procedimento, chamada de ferramenta inválida e ordenação; as APIs de procedimento adicionam seleção de versão do agente; as APIs de tópicos adicionam controles de detalhes de avaliação e ordenação por frustração. O lançamento também adiciona campos de frequência de atualização da base de conhecimento, ambiente de teste e integração de alertas, além de tipos de mensagens de Dubbing em tempo real.
#### SDK Python
- [v2.65.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.65.0) - Adicionados clientes e tipos para tickets de triagem de conversas e resumos leves de conversas. As APIs de conversa adicionam filtros de procedimento, chamada de ferramenta inválida e ordenação; as APIs de procedimento adicionam seleção de versão do agente; as APIs de tópicos adicionam controles de detalhes de avaliação e ordenação por frustração. O lançamento também adiciona campos de frequência de atualização da base de conhecimento, ambiente de teste e integração de alertas, além de preservar campos multipart repetidos para `keyterms` do Speech to Text e `webhook_ids` do Dubbing.
#### SDK Swift
- [v3.3.0](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.3.0) - Adicionados parsing tipado de erros do cliente, tratamento de `expects_response` e resultados de ferramentas com segurança de tipos. A inicialização do WebRTC agora fica pronta quando o agente entra, em vez de aguardar a assinatura da faixa de áudio. O lançamento também reforça o tratamento de URLs, elimina o ruído de eventos desconhecidos e remove a alocação de threads em tempo real do processamento de silenciamento por software.
#### Pacotes
- [@elevenlabs/client@1.19.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.19.1), [@elevenlabs/react@1.12.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.3), [@elevenlabs/react-native@1.2.21](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.21), [@elevenlabs/convai-widget-core@0.16.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.2) e [@elevenlabs/convai-widget-embed@0.16.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.2) - A captura de saída do WebRTC agora usa caminhos AudioWorklet auto-hospedados sob políticas rígidas de segurança de conteúdo. O cache de worklets inclui a fonte solicitada, impedindo que uma URL inline anterior substitua um caminho auto-hospedado. Os erros de configuração do React Native agora apontam para `@elevenlabs/react-native`.
- [@elevenlabs/client@1.20.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.20.0), [@elevenlabs/react@1.12.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.4), [@elevenlabs/react-native@1.2.22](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.22), [@elevenlabs/convai-widget-core@0.16.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.3) e [@elevenlabs/convai-widget-embed@0.16.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.3) - Adicionada a opção `webRtc.iceTransportPolicy`. Defina-a como `relay` para restringir os candidatos ICE do WebRTC a retransmissores TURN em redes que bloqueiam tráfego UDP direto.
- [@elevenlabs/client@1.21.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.21.0), [@elevenlabs/react@1.13.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.13.0), [@elevenlabs/types@0.21.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.21.1), [@elevenlabs/react-native@1.2.23](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.23), [@elevenlabs/convai-widget-core@0.16.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.4) e [@elevenlabs/convai-widget-embed@0.16.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.4) - Adicionados o callback `onContextUsage` e o tipo `ContextUsageEvent`. O React expõe o callback por meio de `useConversation`. O React Native agora é resolvido pela condição de exportação do pacote, em vez da detecção de variáveis globais do navegador.
- [@elevenlabs/client@1.22.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.22.0), [@elevenlabs/react@1.14.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.14.0), [@elevenlabs/types@0.22.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.22.0), [@elevenlabs/react-native@1.2.24](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.24), [@elevenlabs/convai-widget-core@0.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.17.0) e [@elevenlabs/convai-widget-embed@0.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.17.0) - Adicionado conteúdo avançado na primeira mensagem com respostas de botões atribuídas, `onExternalAgentDisconnected` e `onMCPToolApprovalRequest`. O WebRTC agora usa o dispositivo de entrada selecionado, preserva o estado de silenciamento ao trocar de microfone e falha na configuração caso os dados de inicialização não possam ser enviados. O widget adiciona o status da fila de concorrência, seleção opcional de idioma no acionador recolhido e renderização da primeira mensagem para agentes compatíveis com texto e voz.
### API
## Novos endpoints
### ElevenAgents
- Adicionados nove endpoints de tickets de triagem de conversas:
- [Criar ticket de conversa](/docs/pt/api-reference/triage-tickets/create-agent-conversation-ticket-route) - `POST /v1/convai/triage-tickets`. A solicitação requer `conversation_id` (string) e aceita `qa_comment` (string anulável, de 1 a 10.000 caracteres) e até 200 comentários de turno.
- [Listar tickets](/docs/pt/api-reference/triage-tickets/list-agent-conversation-tickets-route) - `GET /v1/convai/agents/{agent_id}/triage-tickets`, com paginação por cursor.
- [Criar ticket manual](/docs/pt/api-reference/triage-tickets/create-manual-agent-ticket-route) - `POST /v1/convai/agents/{agent_id}/triage-tickets`. A solicitação requer `qa_comment` (string, de 1 a 10.000 caracteres).
- [Listar usuários atribuíveis](/docs/pt/api-reference/triage-tickets/get-assignable-users-route) - `GET /v1/convai/agents/{agent_id}/triage-tickets/assignable-users`. A resposta lista membros do workspace que não são contas de serviço e indica se cada membro tem acesso ao agente.
- [Obter ticket](/docs/pt/api-reference/triage-tickets/get-agent-conversation-ticket-route) - `GET /v1/convai/triage-tickets/{agentqa_ticket_id}`.
- [Atualizar ticket](/docs/pt/api-reference/triage-tickets/update-agent-conversation-ticket-route) - `PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}`. A solicitação aceita `status` opcional e `assignee_user_id` anulável.
- [Excluir ticket](/docs/pt/api-reference/triage-tickets/delete-agent-conversation-ticket-route) - `DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}`.
- [Adicionar comentário](/docs/pt/api-reference/triage-tickets/add-ticket-comment-route) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments`. A solicitação requer `comment` (string, de 1 a 10.000 caracteres).
- [Adicionar comentário de turno](/docs/pt/api-reference/triage-tickets/add-turn-comment-route) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments`. A solicitação requer `turn_index` com base zero (inteiro) e `comment` (string, de 1 a 10.000 caracteres).
## Endpoints atualizados
### ElevenAgents
- [Obter URL assinada](/docs/pt/api-reference/conversations/get-signed-url) - `GET /v1/convai/conversation/get-signed-url`
- Adicionado `debug_events_request` opcional (booleano, padrão `false`). Eventos de depuração exigem acesso de editor ao agente.
- [Obter token WebRTC](/docs/pt/api-reference/conversations/get-webrtc-token) - `GET /v1/convai/conversation/token`
- Adicionado `debug_events_request` opcional (booleano, padrão `false`). A rota legada `GET /v1/convai/conversation/get_signed_url` aceita o mesmo parâmetro.
- [Listar conversas](/docs/pt/api-reference/conversations/list) - `GET /v1/convai/conversations`
- Adicionado `triggered_procedure_ids` opcional (array de strings anulável, máximo de 50) para corresponder a conversas em que qualquer procedimento especificado foi executado.
- Adicionado `include_invalid_tool_calls` opcional (booleano, padrão `false`) para incluir chamadas de ferramentas que não foram executadas.
- Adicionado `sort_direction` opcional (`asc` ou `desc`, padrão `desc`) para o horário de início da chamada.
- [Pesquisar mensagens de conversa por texto](/docs/pt/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
- Adicionado `triggered_procedure_ids` opcional (array de strings anulável, máximo de 50).
- Adicionado `include_invalid_tool_calls` opcional (booleano, padrão `false`).
- [Obter tópicos de conversa do agente](/docs/pt/api-reference/conversations/topics/get) - `GET /v1/convai/agents/{agent_id}/topics`
- Adicionado `include_evaluation_criteria` opcional (booleano, padrão `true`).
- Adicionado `frustration` a `sort_by`.
- As respostas de tópicos adicionam `success_rate` anulável (número), enquanto a resposta geral adiciona `aggregated_run_count` (inteiro, padrão `0`).
- `from_unix_secs` é arredondado para baixo até o início do dia UTC correspondente. Um intervalo limitado agrega execuções diárias de descoberta concluídas; omitir ambos os limites retorna a execução mais recente.
- [Listar procedimentos](/docs/pt/api-reference/agents/procedures/list) (`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures`) e [Obter procedimento](/docs/pt/api-reference/agents/procedures/get) (`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}`)
- Adicionado `agent_version_id` opcional anulável (string) para recuperar procedimentos de uma versão específica do agente.
- [Criar teste](/docs/pt/api-reference/tests/create) e [Atualizar teste](/docs/pt/api-reference/tests/update)
- Adicionado `environment` opcional anulável (string) aos esquemas de teste unitário de resposta, simulação e chamada de ferramenta. O valor seleciona URLs, cabeçalhos e conexões de autenticação específicos do ambiente; o padrão é `production`.
- [Criar documento a partir de URL](/docs/pt/api-reference/knowledge-base/create-from-url), [Criar tarefa de rastreamento](/docs/pt/api-reference/knowledge-base/create-crawl-job) e [Criar pasta](/docs/pt/api-reference/knowledge-base/create-folder)
- Adicionado `minimum_frequency_days` opcional anulável (inteiro, de 1 a 180) para sincronização automática. O padrão é `7`, e uma frequência mais restritiva da pasta pai tem precedência.
### Música
- [Listar Finetunes de música](/docs/pt/api-reference/music/finetunes/list) - `GET /v1/music/finetunes`
- Aumentado o máximo de `page_size` de 100 para 150. O padrão permanece 50.
## Alterações no esquema
### ElevenAgents
- As solicitações de atualização de agente adicionam `procedures` opcional anulável (`object`). Cada valor requer `procedure_id` e `version_id` (strings). Um objeto vazio remove todos os procedimentos.
- A configuração de inicialização de conversa adiciona `enable_procedure_ids_from_client` (booleano, padrão `false`). Os dados de inicialização adicionam `procedure_ids` opcional anulável (array de strings); um array vazio desativa todos os procedimentos para o agente inicial.
- `ClientEvent` adiciona `context_usage`.
- As substituições de tempo limite flexível adicionam `additional_soft_timeout_messages` opcional anulável (array de strings).
- Valores constantes nos modelos de análise e substituição de esquema agora aceitam `null`.
- Os padrões da configuração do widget para `mic_muting_enabled` e `transcript_enabled` foram alterados de `false` para `true`. Defina-os explicitamente como `false` para preservar o comportamento anterior.
### Workspace
- As respostas de [Obter usuário](/docs/pt/api-reference/user/get) removeram `xi_api_key` de `UserResponseModel`.
- `ResourceMetadataResponseModel.role_to_group_ids` agora aceita IDs de função personalizados como chaves, em vez de restringir as chaves a `admin`, `editor`, `commenter` e `viewer`.
- As respostas de publicação direta adicionam `restricted_to_user_email_domains` opcional anulável (array de strings).
- As respostas de alteração de assinatura pendente adicionam `go` a `next_tier`.
## August 22, 2026
### Servidor MCP
- **Servidor MCP local descontinuado**: O [servidor MCP da ElevenLabs](https://github.com/elevenlabs/elevenlabs-mcp) local e o [player MCP](https://github.com/elevenlabs/elevenlabs-mcp-player) foram descontinuados em favor do [servidor MCP hospedado](/docs/pt/eleven-agents/operate/hosted-mcp). Ambos os repositórios foram arquivados e não receberão mais atualizações. O servidor hospedado está disponível em `https://api.elevenlabs.io/v1/mcp`, permite entrar com sua conta ElevenLabs via OAuth e não exige instalação local nem chave de API. Consulte a [documentação do servidor MCP hospedado](/docs/pt/eleven-agents/operate/hosted-mcp) para ver instruções de configuração para Claude, Cursor e outros clientes MCP.
## August 17, 2026
### ElevenCreative
- **APIs de geração de imagem, vídeo e fala**: As novas APIs assíncronas de Flows criam, listam e recuperam gerações de vídeo, imagem e fala. As respostas de geração expõem os estados `pending`, `generating`, `completed` e `failed`, e as solicitações podem incluir um destino de webhook para eventos de conclusão.
- **Ativos de mídia reutilizáveis**: As novas APIs de ativos fazem upload, listam, recuperam e excluem mídias do espaço de trabalho. Referências de imagem, vídeo e áudio podem usar um ativo enviado, uma geração anterior ou dados base64 inline, permitindo encadear tarefas de geração. Consulte [Referências e ativos](/docs/pt/eleven-api/guides/how-to/image-and-video/references).
### ElevenAgents
- **Resumos leves de conversas**: [Obter resumo da conversa](/docs/pt/api-reference/conversations/get-summary) retorna o título gerado, o resumo da transcrição, o resultado da chamada e mensagens simples do usuário ou agente sem carregar a transcrição completa. O parâmetro de consulta opcional `max_messages` é um inteiro de 1 a 200 (padrão `40`); conversas mais longas definem `messages_omitted` como `true`. Útil para agentes que precisam preservar o contexto.
- **Paginação e ordenação de tópicos de conversa**: [Obter tópicos de conversa do agente](/docs/pt/api-reference/conversations/topics/get) adiciona paginação e ordenação opcionais por cursor. Use `page_size` (inteiro, 1–100), `cursor` (string), `sort_by` (`conversations`, `sentiment` ou `success_rate`) e `sort_direction` (`asc` ou `desc`). As respostas adicionam `has_more` e `next_cursor` anulável.
- **Filas de espera por concorrência**: As configurações da plataforma de agentes adicionam `queueing` opcional (`AgentQueueingConfig`). Defina `enabled` como `true` para manter as pessoas que ligam em espera quando o agente atingir o limite de concorrência; `wait_timeout_seconds` é um inteiro de até 1.800 (padrão `180`).
- **Controles de turnos e workflows**: A configuração de turnos adiciona `merge_with_default_ignore_terms` (booleano, padrão `false`) para combinar termos de interrupção personalizados com padrões selecionados. Os tempos limite flexíveis adicionam `disable_until_first_user_message` (booleano, padrão `false`), e os localizadores de ferramentas de workflow adicionam `schema_overrides` opcional para substituições de parâmetros por nó.
- **Padrões de áudio de fundo**: `BackgroundSoundConfig.volume` agora tem como padrão `0.15`, em vez de `0.6`, e `crossfade_loop` agora tem como padrão `true`, em vez de `false`. Defina esses campos explicitamente para manter o comportamento anterior.
### Lançamentos de SDKs
#### SDK JavaScript
- [v2.64.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.64.0) - Adicionados `client.assets` para enviar, listar, recuperar e excluir ativos, além de `client.flows` para geração assíncrona de vídeo, imagem e fala. A configuração de turnos adiciona `mergeWithDefaultIgnoreTerms`. Removidos `CustomToolApiSchemaConfig` e `scimExternalId` de `WorkspaceGroupResponseModel`.
#### SDK Python
- [v2.64.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.64.0) - Adicionados clientes de ativos e Flows para geração assíncrona de vídeo, imagem e fala, além de `merge_with_default_ignore_terms` na configuração de turnos. A configuração de sessão on-premise adiciona `extra_setup_config` para transmitir campos adicionais de mensagens de configuração.
#### Pacotes
- [@elevenlabs/client@1.18.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.18.0), [@elevenlabs/react@1.12.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.1), [@elevenlabs/types@0.20.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.20.0), [@elevenlabs/react-native@1.2.19](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.19), [@elevenlabs/convai-widget-core@0.16.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.0) e [@elevenlabs/convai-widget-embed@0.16.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.0) - Adicionadas sessões experimentais de orquestrador hospedado pelo próprio usuário e eventos de conteúdo avançado. Os worklets de áudio do Scribe agora podem ser hospedados pelo próprio usuário para políticas rígidas de segurança de conteúdo. O tratamento de desconexão agora alcança `disconnected` de forma consistente e evita que callbacks tardios limpem uma sessão mais recente. O widget renderiza respostas rápidas e links inline, restaura Markdown em transcrições de voz e corrige o posicionamento do menu de idiomas em layouts com container queries.
- [@elevenlabs/client@1.19.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.19.0), [@elevenlabs/react@1.12.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.2), [@elevenlabs/types@0.21.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.21.0), [@elevenlabs/react-native@1.2.20](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.20) e [@elevenlabs/convai-widget-core@0.16.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.1) - Adicionadas opções de Speech to Text em tempo real para idiomas secundários, detecção de entidades e filtragem de áudio de fundo. Adicionados eventos de transcrição final, entidade detectada e solicitação inválida; alinhados os tipos de palavras com marcação de tempo ao esquema ao vivo; e corrigidas falhas de permissão do microfone que impediam a reconexão de `useScribe`.
### API
## Novos endpoints
### ElevenCreative
- [Criar geração de vídeo](/docs/pt/api-reference/flows/video/create) - `POST /v1/flows/video`
- [Listar gerações de vídeo](/docs/pt/api-reference/flows/video/list) - `GET /v1/flows/video`
- [Obter geração de vídeo](/docs/pt/api-reference/flows/video/get) - `GET /v1/flows/video/{generation_id}`
- [Criar geração de imagem](/docs/pt/api-reference/flows/image/create) - `POST /v1/flows/image`
- [Listar gerações de imagem](/docs/pt/api-reference/flows/image/list) - `GET /v1/flows/image`
- [Obter geração de imagem](/docs/pt/api-reference/flows/image/get) - `GET /v1/flows/image/{generation_id}`
- [Criar geração de fala](/docs/pt/api-reference/flows/text-to-speech/create) - `POST /v1/flows/text-to-speech`
- [Listar gerações de fala](/docs/pt/api-reference/flows/text-to-speech/list) - `GET /v1/flows/text-to-speech`
- [Obter geração de fala](/docs/pt/api-reference/flows/text-to-speech/get) - `GET /v1/flows/text-to-speech/{generation_id}`
- [Enviar ativo](/docs/pt/api-reference/assets/create) - `POST /v1/assets`
- [Listar ativos](/docs/pt/api-reference/assets/list) - `GET /v1/assets`
- [Obter ativo](/docs/pt/api-reference/assets/get) - `GET /v1/assets/{asset_id}`
- [Excluir ativo](/docs/pt/api-reference/assets/delete) - `DELETE /v1/assets/{asset_id}`
### ElevenAgents
- [Obter resumo da conversa](/docs/pt/api-reference/conversations/get-summary) - `GET /v1/convai/conversations/{conversation_id}/summary`
- Aceita `max_messages` opcional (inteiro, 1–200, padrão `40`)
- Retorna `GetConversationSummaryResponseModel` com `conversation_id`, `agent_id`, `status`, `message_count` e `note` obrigatórios
- As `messages` simples contêm apenas `role` (`user` ou `agent`) e `message`; conversas acima do limite retornam `messages_omitted: true`
## Endpoints atualizados
### ElevenAgents
- [Obter contagem ao vivo](/docs/pt/api-reference/analytics/get) - `GET /v1/convai/analytics/live-count`
- Adicionado `agent_ids` opcional (matriz de strings, máximo de 25), que tem precedência sobre `agent_id`
- [Obter tópicos de conversa do agente](/docs/pt/api-reference/conversations/topics/get) - `GET /v1/convai/agents/{agent_id}/topics`
- Adicionados `page_size` opcional (inteiro, 1–100), `cursor` (string), `sort_by` (`conversations`, `sentiment` ou `success_rate`) e `sort_direction` (`asc` ou `desc`)
- As respostas adicionam `has_more` (booleano, padrão `false`) e `next_cursor` anulável (string)
## Alterações de esquema
### ElevenAgents
- Adicionado `queueing` opcional (`AgentQueueingConfig`) às configurações da plataforma de agentes. Ele contém `enabled` (booleano, padrão `false`) e `wait_timeout_seconds` (inteiro maior que 0 e no máximo 1.800, padrão `180`)
- Adicionado `schema_overrides` opcional a `WorkflowToolLocator`; substituições por nó de constante, variável dinâmica, LLM ou omissão têm precedência sobre substituições no nível da ferramenta
- Adicionado `merge_with_default_ignore_terms` (booleano, padrão `false`) à configuração de turnos e aos esquemas de substituição relacionados
- Adicionado `disable_until_first_user_message` (booleano, padrão `false`) à configuração de tempo limite flexível e aos esquemas de substituição relacionados
- Adicionado `status` obrigatório e somente leitura (`success`, `error`, `blocked` ou `skipped`) aos eventos de resposta de ferramentas de agentes em tempo real
- Adicionado `avaya` às fontes de início de conversa e `avaya_api_key` aos métodos de autorização
- Adicionados `gemini-3.6-flash` e `gemini-3.7-flash` aos valores de LLM de agente compatíveis
- Alterado o padrão de `BackgroundSoundConfig.volume` de `0.6` para `0.15` e o padrão de `crossfade_loop` de `false` para `true`
- Removido `CustomToolApiSchemaConfig`; usuários do SDK gerado que importam esse tipo devem remover a importação
- Removido `scim_external_id` de `WorkspaceGroupResponseModel`
## August 10, 2026
import { YoutubeEmbed } from "../../../components/YoutubeEmbed";
### API de Dubbing v2
O Dubbing v2 já está disponível pela API. Ele traduz áudio e vídeo para mais de 90 idiomas, preservando a voz, o tom e o ritmo de cada pessoa que fala.
A nova API baseada em projetos mantém transcrições e traduções de origem como JSON editável. Crie um projeto a partir de um arquivo ou URL, adicione um ou mais idiomas de destino, edite segmentos individuais da transcrição ou traduções e, depois, gere novamente apenas as regiões que foram alteradas. Siga o [guia rápido de Dubbing](/docs/pt/eleven-api/guides/cookbooks/dubbing) para criar sua primeira dublagem.
Crie seu primeiro projeto de Dubbing v2 e gere uma faixa de áudio traduzida.
Edite transcrições e traduções de origem e, depois, gere novamente as regiões alteradas.
Explore os endpoints de projeto, idioma e transcrição do Dubbing.
### ElevenAgents
- **Filtros de guardrails de conversa**: [Listar conversas](/docs/pt/api-reference/conversations/list) adiciona os parâmetros de consulta opcionais `guardrail_types` (`GuardrailType[]`) e `custom_guardrail_names` (matriz de strings). A hierarquia de conversas existente agora pode ser filtrada com o parâmetro opcional `parent_conversation_id` (string).
- **Status de divergência de ramificação**: [Listar ramificações do agente](/docs/pt/api-reference/agents/branches/list) adiciona o parâmetro opcional `include_commit_status` (booleano, padrão `false`). Quando ativado, os resumos das ramificações incluem os campos anuláveis `commits_ahead`, `commits_behind` e `merged_into_branch_id`.
- **Controles de conversa e ferramentas**: As substituições de cliente agora oferecem suporte a `max_duration_seconds` e `pronunciation_dictionary_locators`. A configuração do servidor MCP adiciona `request_meta` para transmitir valores MCP `_meta` a chamadas de ferramentas, e os tempos limite das ferramentas de webhook agora aceitam até 300 segundos.
- **Uso de análise pós-chamada**: A cobrança de conversas adiciona uma divisão de `analysis` com totais acumulados por recurso e snapshots de execução. As mensagens da transcrição adicionam `triggered_guardrails`, e os turnos de conversa adicionam `producing_llm` opcional.
### Vozes
- **Filtros de busca de vozes**: [Obter todas as vozes v2](/docs/pt/api-reference/voices/search) adiciona os parâmetros de consulta opcionais `gender`, `age`, `language`, `accent`, `use_cases`, `min_notice_period_days`, `include_custom_rates`, `include_live_moderated` e `high_quality`.
### Lançamentos de SDKs
#### SDK JavaScript
- [v2.63.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.63.0) - Adicionadas opções de Speech to Text em tempo real para idiomas secundários, detecção de idioma e entidades, filtragem de áudio de fundo, registros e autenticação com token de uso único. Adicionados eventos de transcrição final, entidade e solicitação inválida; corrigidos o envio de termos não aceitos, parâmetros `audio_format` duplicados e limites VAD inclusivos.
- [v2.62.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.62.0) - Adicionados métodos de atualização em massa de transcrições de Dubbing e `DubbingRegenerateResponse`; adicionados filtros de guardrail de conversa, status de commit de ramificações de agente, alertas de agente e suporte a MCP `requestMeta`. A criação de idioma de destino não aceita mais `modelId`.
- [v2.61.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.61.0) - Adicionados filtragem de hierarquia de conversas, cobrança de análise pós-chamada, metadados de guardrails acionados, detalhes de conflitos de mesclagem de ramificações, ocultação de entrada DTMF e uploads de transcrições de Dubbing. Removidos os tipos exportados de sessão em tempo real da OpenAI e as variantes de resultado de ferramenta `run_subagent_*`.
#### SDK Python
- [v2.63.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.63.0) - Adicionadas opções de Speech to Text em tempo real para idiomas secundários, detecção de idioma e entidades, filtragem de áudio de fundo, registros e autenticação com token de uso único. Adicionados eventos de transcrição final, entidade e solicitação inválida; corrigido o envio de termos não aceitos e agora são rejeitadas conexões sem uma chave de API ou token.
- [v2.62.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.62.0) - Adicionados métodos `update_segments` de Dubbing e `DubbingRegenerateResponse`; adicionados suporte a `guardrail_types`, `custom_guardrail_names`, `include_commit_status` e MCP `request_meta`. As atualizações de segmentos de Dubbing agora usam modelos de corpo de solicitação, e a criação de idioma de destino não aceita mais `model_id`.
- [v2.61.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.61.0) - Adicionados `parent_conversation_id`, cobrança de análise, metadados de guardrails acionados, conflitos de mesclagem de ramificações, ocultação de entrada DTMF e uploads de transcrições de Dubbing. Removidos os tipos de sessão em tempo real da OpenAI e os modelos de resultado `run_subagent_*`.
#### SDK Android
- [v0.12.1](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.12.1) - Corrigido o relato de desconexões intencionais de sessões apenas de texto como `ConversationStatus.ERROR`.
- [v0.12.0](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.12.0) - Adicionado `ConversationConfig.useMediaStream` para rotear o áudio da conversa pelo fluxo de mídia do Android. Fechamentos normais remotos de WebSocket agora informam `DisconnectionDetails.Agent`, enquanto fechamentos iniciados localmente informam `DisconnectionDetails.User`.
#### Servidor MCP
- [v0.12.2](https://github.com/elevenlabs/elevenlabs-mcp/releases/tag/v0.12.2) - Corrigido um problema de travessia de caminho.
### API
## Novos endpoints
### Dubbing
- [Atualizar segmentos de origem em lote](/docs/pt/api-reference/dubbing/source-transcript/batch-update-source-segments) - `PATCH /v1/dubbing/project/{project_id}/transcript/segments`
- Requer `DubbingBulkSegmentUpdateRequest`
- Atualiza atomicamente o texto, a pessoa que fala ou a temporização dos segmentos de origem
- Retorna `DubbingBulkSourceSegmentUpdateResponse` com os `segments` e a `revision` atualizados
- [Atualizar segmentos de destino em lote](/docs/pt/api-reference/dubbing/target-transcript/batch-update-target-segments) - `PATCH /v1/dubbing/project/{project_id}/language/{language_id}/transcript/segments`
- Requer `DubbingBulkTargetSegmentUpdateRequest`
- Atualiza atomicamente as traduções de vários segmentos de destino
- Retorna `DubbingBulkTargetSegmentUpdateResponse` com os `segments` e a `revision` atualizados
## Endpoints atualizados
### ElevenAgents
- [Listar conversas](/docs/pt/api-reference/conversations/list) - `GET /v1/convai/conversations`
- Adicionado `parent_conversation_id` opcional (string)
- Adicionados `guardrail_types` repetível opcional (`GuardrailType[]`) e `custom_guardrail_names` opcional (matriz de strings)
- [Listar ramificações do agente](/docs/pt/api-reference/agents/branches/list) - `GET /v1/convai/agents/{agent_id}/branches`
- Adicionado `include_commit_status` opcional (booleano, padrão `false`)
- Os resumos das ramificações adicionam `commits_ahead` (inteiro), `commits_behind` (inteiro) e `merged_into_branch_id` (string) anuláveis
### Vozes
- [Obter todas as vozes v2](/docs/pt/api-reference/voices/search) - `GET /v2/voices`
- Adicionados filtros opcionais `gender`, `age` e `accent` (string)
- Adicionados filtros opcionais `language` e `use_cases` (matriz de strings)
- Adicionados filtros opcionais `min_notice_period_days` (inteiro), `include_custom_rates`, `include_live_moderated` e `high_quality` (booleano)
## Alterações de esquema
### ElevenAgents
- Os esquemas de substituição do cliente adicionam `max_duration_seconds` (inteiro) e `pronunciation_dictionary_locators` (matriz)
- Os esquemas de entrada e saída do servidor MCP adicionam mapas `request_meta`
- As configurações da plataforma de agentes adicionam `alerting`; a detecção de idioma adiciona `only_at_conversation_start` (booleano)
- `AnalysisCharging.last_run` agora é obrigatório e não anulável; os totais acumulados adicionam `runs` obrigatório (inteiro)
- As respostas de blocos RAG agora exigem `content_format` e `document_type`
## August 3, 2026
### ElevenAgents
- **Mocks de ferramentas específicos para testes**: Simulações de agentes e testes unitários agora podem definir `tool_mock_overrides`, indexados por ID de ferramenta, para substituir mocks compartilhados em um único teste. `ToolResponseMockConfig` também adiciona `is_error` opcional (booleano, padrão `false`) para que um mock possa testar caminhos de falha de ferramentas.
- **Mensagens de workflow traduzidas**: Mensagens literais de nós Say adicionam `text_translations`, um mapa de chaves de idioma para objetos `TranslatedString`. O campo é opcional na entrada e obrigatório na saída, portanto validadores estritos de resposta devem aceitá-lo.
- **Filtros de versão de conversa**: [Listar conversas](/docs/pt/api-reference/conversations/list) e [Pesquisar mensagens de conversa por texto](/docs/pt/api-reference/conversations/messages/text-search) adicionam o parâmetro de consulta opcional `version_id` (string) para filtrar resultados por versão do agente.
- **Ferramenta de sistema da base de conhecimento**: A configuração do agente adiciona uma ferramenta de sistema `knowledge_base` com `enabled_strategies` (`SearchStrategy[]`) configurável. As consultas RAG da base de conhecimento do agente adicionam `use_agent_defaults` opcional (booleano, padrão `true`); defina-o como `false` para usar configurações de recuperação neutras, mantendo o modelo de embedding do agente.
- **Detecção de atividade de voz do agente**: Os esquemas de criação, atualização, resposta e substituição de workflow de agentes adicionam a configuração `vad`. Atualmente, `VADConfig` oferece suporte a `background_voice_detection` (booleano, padrão `false`).
- **LLMs personalizados por WebSocket**: `CustomLLMAPIType` adiciona `websocket`.
- **Controles de memória para arquivos**: A configuração de entrada de arquivos do widget adiciona `max_files_in_memory` (inteiro, 1–30, padrão `10`). Arquivos além do limite são resumidos e liberados da memória; `max_files_per_conversation` deve ser `-1` ou, no mínimo, o limite de memória.
- **Redação de entrada DTMF**: `DTMFInputConfig` adiciona `redact_input` opcional (booleano, padrão `false`) para substituir dígitos do teclado do chamador em transcrições, registros de conversa e análises. Dígitos repetidos pelo agente ou transmitidos para ferramentas permanecem inalterados.
### Speech to Text
- **Detecção de entidades em tempo real**: O Scribe v2 Realtime adiciona a opção de consulta `entity_detection`. Ela aceita `all`, um tipo ou categoria de entidade, ou um array de tipos e categorias, e emite entidades detectadas em eventos `committed_transcript_entities`. Veja as categorias compatíveis no [guia de detecção de entidades](/docs/pt/eleven-api/guides/how-to/speech-to-text/batch/entity-detection).
### Vozes
- **Replicação de voz entre residências de dados**: Adicionamos `POST /v1/voices/{voice_id}/replicate-to-isolated-environment` para copiar uma voz do Instant Voice Clone ou Voice Design para um workspace no mesmo grupo de faturamento consolidado. As solicitações exigem `target_workspace_id` (string) e aceitam `preserve_voice_id` (booleano, padrão `true`); as respostas retornam o `voice_id` de destino.
- **Metadados de personagens**: As respostas de personagens adicionam `recommended_voice_ids` (array de strings, padrão `[]`), os metadados adicionam `role` anulável (`CharacterRole`) e `CharacterAge` substitui `middle-aged` por `middle_aged`.
### Lançamentos de SDKs
#### Pacotes
- [@elevenlabs/client@1.16.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.16.0), [@elevenlabs/react@1.11.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.11.0), [@elevenlabs/types@0.18.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.18.0), [@elevenlabs/react-native@1.2.17](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.17) e [@elevenlabs/convai-widget-core@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.15.0) - Adicionamos `onAgentReasoningResponsePart`, que recebe eventos de raciocínio do agente por streaming com os tipos `start`, `delta` e `stop`.
- [@elevenlabs/convai-widget-core@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.15.0) e [@elevenlabs/convai-widget-embed@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.15.0) - Adicionamos `show_resize_button` e o atributo de incorporação `show-resize-button`. Defina qualquer um como `false` para ocultar o controle de expandir e recolher do cabeçalho do widget.
- [@elevenlabs/client@1.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.17.0), [@elevenlabs/react@1.12.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.0), [@elevenlabs/types@0.19.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.19.0), [@elevenlabs/react-native@1.2.18](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.18) e [@elevenlabs/convai-widget-core@0.15.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.15.1) - Adicionamos a opção `enableLogging` a `Scribe.connect` e `useScribe`. Defini-la como `false` inicia uma sessão empresarial sem retenção. O tipo `session_started` do Scribe agora informa `enable_logging`; o campo não utilizado `disable_logging` foi removido.
#### Servidor MCP
- [v0.12.1](https://github.com/elevenlabs/elevenlabs-mcp/releases/tag/v0.12.1) - Inclui as atualizações de ferramentas da v0.11 e uma atualização de dependências que resolve 44 alertas de segurança.
- [v0.11.0](https://github.com/elevenlabs/elevenlabs-mcp/releases/tag/v0.11.0) - Adicionamos `simulate_conversation` com comportamento configurável de usuário simulado, critérios de avaliação, saída de transcrição e análise de aprovação/reprovação. A ferramenta `speech_to_text` agora usa `scribe_v2` por padrão, e `voice_clone` agora envia o conteúdo de arquivos de áudio em vez de strings de caminho.
### API
## Novos endpoints
### Vozes
- `POST /v1/voices/{voice_id}/replicate-to-isolated-environment`
- Replica uma voz do Instant Voice Clone ou Voice Design no ambiente isolado de outro workspace
- Exige `target_workspace_id` (string)
- Aceita `preserve_voice_id` opcional (booleano, padrão `true`)
- Retorna `voice_id` obrigatório (string)
## Endpoints atualizados
### ElevenAgents
- [Listar conversas](/docs/pt/api-reference/conversations/list) - `GET /v1/convai/conversations`
- Adicionado parâmetro de consulta opcional `version_id` (string)
- [Pesquisar mensagens de conversa por texto](/docs/pt/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
- Adicionado parâmetro de consulta opcional `version_id` (string)
- `POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query`
- Adicionado campo de solicitação opcional `use_agent_defaults` (booleano, padrão `true`)
## Alterações de esquema
### ElevenAgents
- As cargas de simulação e testes unitários adicionam mapas opcionais `tool_mock_overrides`; `ToolResponseMockConfig` adiciona `is_error` opcional (booleano, padrão `false`)
- `SayNodeLiteralMessage` adiciona `text_translations` (mapa de `TranslatedString`); o campo é opcional na entrada e obrigatório na saída
- A configuração do agente adiciona `knowledge_base` (`KnowledgeBaseToolConfig`) e `vad` (`VADConfig`)
- `CustomLLMAPIType` adiciona `websocket`
- `FileInputConfig` adiciona `max_files_in_memory` (inteiro, 1–30, padrão `10`)
- `DTMFInputConfig` adiciona `redact_input` opcional (booleano, padrão `false`)
- A configuração de agente em tempo real agora usa `eleven_realtime_v1_mini` por padrão
### Vozes
- As respostas de personagens adicionam `recommended_voice_ids` (array de strings, padrão `[]`)
- Os metadados de personagens adicionam `role` anulável (`CharacterRole`)
- Incompatível: `CharacterAge` substitui `middle-aged` por `middle_aged`; clientes que enviam o valor antigo devem migrar
### Text to Speech
- Incompatível: removidos `AudioFilterId` e `audio_filter` dos esquemas de configuração de Text to Speech do ElevenAgents
## July 27, 2026
### ElevenAgents
- **Substituições de branch e ambiente no WhatsApp**: [Mensagens de WhatsApp enviadas](/docs/pt/api-reference/whats-app/outbound-message) e [chamadas realizadas](/docs/pt/api-reference/whats-app/outbound-call) agora respeitam `branch_id` e `environment` enviados em `conversation_initiation_client_data`. As substituições são validadas antes de qualquer envio — uma branch ou ambiente desconhecido é rejeitado com um erro — e persistem durante a conversa, para que a resposta de um cliente seja retomada na [branch](/docs/pt/eleven-agents/operate/versioning) e no [ambiente](/docs/pt/eleven-agents/integrate/environment-variables) solicitados. Veja exemplos no [guia do WhatsApp](/docs/pt/eleven-agents/whatsapp).
- **APIs de procedimentos**: Adicionamos oito operações públicas com escopo de branch para gerenciar [procedimentos](/docs/pt/eleven-agents/customization/procedures). Você pode criar, listar, recuperar e remover procedimentos; criar, recuperar ou descartar alterações em rascunho; e compilar rascunhos de procedimentos em um workflow de agente. A criação de procedimentos aceita `name`, `content`, `type` e `trigger`. Um `trigger` vazio cria um subprocedimento, enquanto um gatilho omitido ou `null` é derivado do conteúdo do procedimento.
- **Tarefas de rastreamento da base de conhecimento**: Adicionamos APIs para criar, listar, inspecionar e cancelar tarefas de rastreamento. As solicitações de criação exigem `url` (string) e oferecem suporte a profundidade de rastreamento, limites de páginas, padrões de URL, URLs de sitemap, posicionamento em pastas, sincronização automática e remoção de documentos indisponíveis.
- **Gerenciamento em massa da base de conhecimento**: Adicionamos [verificações de dependências em massa](/docs/pt/api-reference/knowledge-base/dependent-agents-multiple) e [exclusão em massa](/docs/pt/api-reference/knowledge-base/bulk-delete) para 1–20 IDs únicos de documentos ou pastas. As verificações de dependências oferecem suporte a paginação e `dependent_type`; a exclusão retorna sucesso ou falha independentes para cada ID. Definir `force: true` também remove dependências e exclui recursivamente pastas não vazias.
- **Exportação de resultados de chamadas em lote**: Adicionamos [Exportar resultados de chamadas em lote](/docs/pt/api-reference/batch-calling/export) para baixar destinatários e resultados de conversas de um lote concluído como CSV.
- **Filtros de conversa e dados de análise**: [Listar conversas](/docs/pt/api-reference/conversations/list) e [Pesquisar mensagens de conversa por texto](/docs/pt/api-reference/conversations/messages/text-search) adicionam os filtros opcionais de array `visited_agent_ids` e `visited_agent_branch_ids`, cada um limitado a 50 valores. As solicitações de listagem também aceitam `data_collection_ids` e `evaluation_criteria_ids` para incluir os resultados correspondentes em cada resumo de conversa. Os resumos adicionam `data_collection_results`, `evaluation_criteria_results` e `tag_ids` opcionais.
- **Configuração de análise por referência**: As configurações da plataforma de agentes adicionam o campo opcional e anulável `analysis_items`, tipado como `AgentAnalysisItems`, para anexar itens de avaliação e coleta de dados por referência. Um valor `null` indica que o agente ainda usa os campos inline legados; um valor vazio indica um agente migrado sem itens anexados.
- **Metadados de dependência de procedimentos**: As referências a procedimentos adicionam `trigger` (string) e arrays para `referenced_tool_ids`, `referenced_kb_ids`, `referenced_procedure_ids` e `referenced_dynamic_variables`.
- **Resposta de token WebRTC**: As respostas de [Obter token WebRTC](/docs/pt/api-reference/conversations/get-webrtc-token) agora exigem `conversation_id` (string), além de `token`. Esta é uma alteração incompatível de esquema para clientes que validam ou desserializam o formato da resposta.
- **Resultados de RAG da base de conhecimento**: `KnowledgeBaseRagToolResultModel` adiciona `chunks` (`KnowledgeBaseRagChunkModel[]`) para o modo de resultado de RAG no resultado da ferramenta.
### Estúdio
- **Status de projeto em rascunho**: `ProjectCreationMetaResponseModel.status` adiciona `draft`. O tipo de criação de projeto agora usa o enum compartilhado `ProjectCreationMetaType` com os mesmos valores existentes.
### Vozes
- **Sotaques de voz**: Adicionamos `GET /v1/voices/accents` para listar os sotaques disponíveis na biblioteca de vozes compartilhada. Os resultados podem ser filtrados por `language` e `model_id`, e cada sotaque retorna `accent`, `language`, `code` e `name` legível por humanos. O valor de `accent` pode ser passado para o parâmetro de consulta `accent` em [Obter vozes compartilhadas](/docs/pt/api-reference/voices/voice-library/get-shared) para filtrar vozes compartilhadas.
### Workspaces
- **Relatórios de uso de webhooks**: `WebhookUsageType` adiciona `Flows`.
### Lançamentos de SDKs
#### SDK JavaScript
- [v2.60.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.60.0) - Adicionamos `voices.accents.get` para listar sotaques de voz na biblioteca de vozes compartilhada, além das APIs de procedimentos do ElevenAgents, tarefas de rastreamento da base de conhecimento, gerenciamento em massa e configuração de análise por referência do esquema mais recente.
#### SDK Python
- [v2.60.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.60.0) - Adicionamos as APIs de sotaques de voz, procedimentos do ElevenAgents, tarefas de rastreamento da base de conhecimento e gerenciamento em massa do esquema mais recente. Também corrigimos a inicialização de `AsyncConversation` para que ela não bloqueie mais e ajustamos os campos multipart de listas de primitivas para serem enviados como campos de formulário repetidos.
#### Pacotes
- [@elevenlabs/client@1.15.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.15.2) - Corrigimos `onAudioAlignment` em transportes WebRTC encaminhando metadados de alinhamento de mensagens de áudio e mantendo a reprodução de áudio na faixa LiveKit.
- [@elevenlabs/react@1.10.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.10.2), [@elevenlabs/react-native@1.2.16](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.16), [@elevenlabs/convai-widget-core@0.14.12](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.12) e [@elevenlabs/convai-widget-embed@0.14.12](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.12) - Atualizamos as dependências para incluir a correção de alinhamento WebRTC do `@elevenlabs/client@1.15.2`.
### API
## Novos endpoints
### ElevenAgents
- `POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures`
- Cria um procedimento e retorna seu `procedure_id` (string)
- Aceita `name` opcional (string, máximo de 200 caracteres), `content` (string), `type` (`ProcedureType`, padrão `free_form`) e `trigger` (string anulável)
- `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures`
- Lista procedimentos da branch com `procedure_id`, `version_id`, `name`, `type`, `trigger` e `has_draft`
- Exclui o conteúdo dos procedimentos; recupere um procedimento individual para ler seu conteúdo
- `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}`
- Aceita `version_id` opcional (string); caso contrário, retorna a versão no topo da branch
- Retorna `name`, `content`, `type` e `trigger`
- `DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}`
- Remove o procedimento do conjunto de trabalho em rascunho da branch
- `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft`
- Retorna o rascunho atual do procedimento
- `PATCH /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft`
- Cria ou atualiza um rascunho
- Exige `name` (string, máximo de 200 caracteres), `content` (string, máximo de 50.000 caracteres) e `type` (`ProcedureType`); aceita `trigger` opcional (string anulável)
- `DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft`
- Descarta as alterações do rascunho e redefine o procedimento para a versão confirmada
- `POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/compile`
- Compila rascunhos de procedimentos em um `AgentWorkflowResponseModel`
- [Criar tarefa de rastreamento](/docs/pt/api-reference/knowledge-base/create-crawl-job) - `POST /v1/convai/knowledge-base/crawl`
- Exige `url` (string)
- Aceita `max_depth` opcional (inteiro, 1–5, padrão `3`), `max_pages` (inteiro, 1–10.000, padrão `1000`), `pattern` (string), `sitemap_urls` (array de strings), `parent_folder_id` (string), `enable_auto_sync` (booleano, padrão `false`) e `auto_remove` (booleano, padrão `false`)
- [Listar tarefas de rastreamento](/docs/pt/api-reference/knowledge-base/list-crawl-jobs) - `GET /v1/convai/knowledge-base/crawl`
- Aceita `include_job_ids` opcional (array de strings), `page_size` (inteiro, 1–100, padrão `30`) e `cursor` (string)
- [Obter tarefa de rastreamento](/docs/pt/api-reference/knowledge-base/get-crawl-job) - `GET /v1/convai/knowledge-base/crawl/{crawl_job_id}`
- [Cancelar tarefa de rastreamento](/docs/pt/api-reference/knowledge-base/cancel-crawl-job) - `POST /v1/convai/knowledge-base/crawl/{crawl_job_id}/cancel`
- [Obter agentes dependentes para vários documentos](/docs/pt/api-reference/knowledge-base/dependent-agents-multiple) - `POST /v1/convai/knowledge-base/dependent-agents`
- Exige `document_ids` (array de 1–20 strings únicas)
- Aceita `dependent_type` opcional (`KnowledgeBaseDependentType`, padrão `all`), `page_size` (inteiro, 1–100, padrão `30`) e `cursor` (string)
- [Excluir documentos da base de conhecimento em massa](/docs/pt/api-reference/knowledge-base/bulk-delete) - `POST /v1/convai/knowledge-base/bulk-delete`
- Exige `document_ids` (array de 1–20 strings únicas)
- Aceita `force` opcional (booleano, padrão `false`)
- Retorna um resultado de sucesso ou falha para cada ID de documento
- [Exportar resultados de chamadas em lote](/docs/pt/api-reference/batch-calling/export) - `GET /v1/convai/batch-calling/{batch_id}/export`
- Retorna destinatários e resultados de conversas de lotes concluídos como CSV
### Vozes
- `GET /v1/voices/accents`
- Lista os sotaques disponíveis na biblioteca de vozes compartilhada
- Aceita parâmetros de consulta opcionais `language` (string) e `model_id` (string)
- Cada sotaque retorna `accent`, `language`, `code` e `name`
## Endpoints atualizados
### ElevenAgents
- [Listar conversas](/docs/pt/api-reference/conversations/list) - `GET /v1/convai/conversations`
- Adicionados filtros opcionais de array de strings `visited_agent_ids` e `visited_agent_branch_ids`, cada um limitado a 50 valores
- Adicionados arrays de strings opcionais `data_collection_ids` e `evaluation_criteria_ids` para selecionar resultados de análise para cada resumo
- Os resumos de resposta adicionam os campos de objeto opcionais `data_collection_results` e `evaluation_criteria_results`, além do array de strings `tag_ids`
- [Pesquisar mensagens de conversa por texto](/docs/pt/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
- Adicionados filtros opcionais de array de strings `visited_agent_ids` e `visited_agent_branch_ids`, cada um limitado a 50 valores
- [Obter token WebRTC](/docs/pt/api-reference/conversations/get-webrtc-token) - `GET /v1/convai/conversation/token`
- As respostas agora exigem `conversation_id` (string)
- Incompatível: validadores e desserializadores de resposta estritos devem aceitar o novo campo obrigatório
## Alterações de esquema
### ElevenAgents
- As configurações de solicitação e resposta da plataforma de agentes adicionam o campo opcional e anulável `analysis_items`, tipado como `AgentAnalysisItems`, para configuração de avaliação e coleta de dados por referência
- As referências a procedimentos adicionam `trigger` (string), `referenced_tool_ids` (array de strings), `referenced_kb_ids` (array de strings), `referenced_procedure_ids` (array de strings) e `referenced_dynamic_variables` (array de strings)
- `KnowledgeBaseRagToolResultModel` adiciona `chunks` (`KnowledgeBaseRagChunkModel[]`)
### Estúdio
- `ProjectCreationMetaResponseModel.status` adiciona `draft`
- `ProjectCreationMetaResponseModel.type` agora referencia o enum compartilhado `ProjectCreationMetaType`
### Workspaces
- `WebhookUsageType` adiciona `Flows`
## July 20, 2026
### Música
- **API de Music Finetunes**: Adicionado suporte de API para gerenciar [Music Finetunes](/docs/pt/eleven-creative/products/music/finetunes). Cinco endpoints permitem criar um Finetune a partir de áudio enviado, listar os Finetunes acessíveis, consultar o status de treinamento, atualizar metadados e visibilidade ou excluir um Finetune. Todos os métodos de SDK de geração de música agora expõem `finetune_id`.
### ElevenAgents
- **Resolver referências externas de conversas**: Adicionado `GET /v1/convai/conversations/resolve` para resolver uma URL de mensagem do Slack ou uma URL de ticket do Zendesk para uma conversa. As solicitações exigem os parâmetros de consulta `agent_id` e `reference` (strings).
- **Consultar bases de conhecimento de agentes**: Adicionado `POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query` para consultas RAG somente leitura na base de conhecimento de um agente. A solicitação exige `query` (string), aceita `branch_id` (string) opcional e retorna blocos classificados com metadados de documento, bloco, texto e distância vetorial. Este endpoint é excluído dos SDKs gerados.
- **Formatos de conteúdo da base de conhecimento**: As respostas de arquivo, texto e URL da base de conhecimento adicionam `content_format` (`html` | `markdown`, padrão `html`) opcional.
- **Configuração de voz do agente**: Os esquemas de substituição de TTS adicionam `model_id` (`TTSConversationalModel`) opcional que pode ser substituído pelo cliente. O padrão de `enable_phoneme_tags` muda de `false` para `true`.
- **Cascata de LLM de backup mais rápida**: O padrão de `cascade_timeout_seconds` muda de 8 para 4 segundos. O intervalo permitido continua de 2 a 15 segundos.
- **Fontes de valores de parâmetros de ferramenta**: Os parâmetros de ferramenta do tipo objeto agora podem usar `dynamic_variable`, `constant_value` ou `is_omitted`, correspondendo aos controles existentes de escalares e arrays. As substituições de esquema constante agora aceitam arrays e objetos arbitrários.
- **Guardrails de resposta completa**: Guardrails personalizados adicionam `evaluate_full_response_only` (booleano, padrão `false`) opcional para avaliar uma vez a resposta completa sem TTS. Essa opção exige o modo de bloqueio.
- **Gravação de chamadas do Twilio**: A configuração de chamadas de telefonia adiciona `twilio_call_recording_enabled` (booleano, padrão `false`) opcional. As gravações são armazenadas na conta Twilio conectada, e a configuração é ignorada por outros provedores.
- **Texto de upload de arquivos do widget**: A configuração de texto do widget adiciona rótulos e mensagens de erro opcionais para anexar e remover arquivos, falhas de upload, tipos não compatíveis, arquivos grandes demais, limites de quantidade de arquivos e o indicador de digitação.
- **Status de sincronização da base de conhecimento**: As respostas de arquivo da base de conhecimento adicionam `auto_sync_info` e `refresh_status` (`FileRefreshStatus`) opcionais. As respostas de pasta adicionam `document_count` (inteiro) obrigatório, uma contagem recursiva de documentos que não são pastas, limitada a 1000.
- **Filtros de busca textual de conversas**: [Buscar mensagens de conversa por texto](/docs/pt/api-reference/conversations/messages/text-search) adiciona os parâmetros de consulta de array `exclude_statuses` e `termination_reasons` opcionais.
- **Opções de LLM**: A configuração de LLM do agente adiciona `gpt-5.6-sol`, `gpt-5.6-terra` e `gpt-5.6-luna`. `LLMReasoningEffort` adiciona `max`.
- **Indicadores de digitação do WhatsApp**: Os esquemas de solicitação e resposta da conta do WhatsApp adicionam `enable_typing_indicator` (booleano) opcional.
### Speech to Text
- **Autenticação em lote de uso único**: [Converter fala em texto](/docs/pt/api-reference/speech-to-text/convert) adiciona `token` (string) opcional como alternativa à autenticação por chave de API ou bearer. Crie o token de uso único com `POST /v1/single-use-token/batch_scribe`; ele expira após 15 minutos.
- **Confiabilidade do cliente em tempo real**: `@elevenlabs/client` agora informa erros de configuração do microfone e erros de servidor malformados por meio de `RealtimeEvents.ERROR`, libera recursos do microfone após falhas de configuração e encerramento de conexão, e descarta frames de microfone tardios após o encerramento do socket.
### Text to Speech
- **Dicionários de pronúncia arquivados**: [Listar dicionários de pronúncia](/docs/pt/api-reference/pronunciation-dictionaries/list) adiciona `include_archived` (booleano, padrão `true`) opcional.
### Espaços de trabalho
- **Assinaturas de eventos de webhook**: As solicitações de [Atualizar webhook do espaço de trabalho](/docs/pt/api-reference/webhooks/update) adicionam `events` (`WorkspaceWebhookEventType[]`) opcional com `voice_library_removal_notice`, `speech_to_text` e `agent_qa`. As respostas de webhook podem retornar a lista de eventos assinados.
- **Dimensões de análise de uso**: [Obter uso do espaço de trabalho](/docs/pt/api-reference/analytics/workspace/usage) adiciona `surface` e `actor` aos valores de `group_by`.
- **Limpar limites de conta de serviço**: [Atualizar chave de API da conta de serviço](/docs/pt/api-reference/service-accounts/api-keys/update) aceita `character_limit: "clear"` para remover um limite mensal de caracteres, além de `"no_update"` e valores inteiros.
- **Referências de webhook de alertas**: Os esquemas de notificador de webhook de alertas agora identificam um webhook do espaço de trabalho com `webhook_id` (string) obrigatório, em vez de incorporar `url`, `method` e `headers`.
### Lançamentos de SDK
#### SDK JavaScript
- [v2.59.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.59.0) - Adicionados métodos `music.finetunes` para listar, criar, obter, atualizar e excluir Music Finetunes. Também foram adicionadas resolução de referência de conversa, filtragem de dicionários de pronúncia arquivados e tokens de Speech to Text de uso único.
#### SDK Python
- [v2.59.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.59.0) - Adicionados Music Finetunes e resolução de referências de conversa a partir do esquema de API mais recente. `OnPremInitiationData` também adiciona configurações tipadas de `post_call_transcription_webhook` e `post_call_audio_webhook` com `hmac_secret` opcional para webhooks pós-chamada assinados.
#### Pacotes
- [@elevenlabs/client@1.15.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.15.1) - Melhorada a entrega de erros do Scribe Realtime e a limpeza do microfone durante falhas de configuração, encerramento pelo cliente ou servidor e frames de áudio tardios.
- [@elevenlabs/react@1.10.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.10.1), [@elevenlabs/react-native@1.2.15](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.15), [@elevenlabs/convai-widget-core@0.14.11](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.11) e [@elevenlabs/convai-widget-embed@0.14.11](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.11) - Dependências atualizadas para incluir as correções do Scribe Realtime em `@elevenlabs/client@1.15.1`.
#### SDK Android
- [v0.11.1](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.11.1) - Impediu que R8 e ProGuard ofuscassem campos de eventos WebSocket e WebRTC enviados, como `text` e `type`.
#### CLI
- [@elevenlabs/cli@0.5.6](https://github.com/elevenlabs/cli/releases/tag/%40elevenlabs%2Fcli%400.5.6) - Modelos de agente padrão atualizados para usar `scribe_realtime` em vez do provedor ASR `elevenlabs` removido. Os modelos mínimos continuam usando o padrão do servidor.
### API
## Novos endpoints
### Música
- [Listar Music Finetunes](/docs/pt/api-reference/music/finetunes/list) - `GET /v1/music/finetunes`
- Compatível com paginação por cursor, filtros de visibilidade e criador, e ordenação por hora de criação ou nome
- [Criar Music Finetune](/docs/pt/api-reference/music/finetunes/create) - `POST /v1/music/finetunes`
- Exige `name` e `primary_genre`
- Aceita até 50 arquivos de áudio, tags, visibilidade e `model_id`
- [Obter Music Finetune](/docs/pt/api-reference/music/finetunes/get) - `GET /v1/music/finetunes/{finetune_id}`
- [Atualizar Music Finetune](/docs/pt/api-reference/music/finetunes/update) - `PATCH /v1/music/finetunes/{finetune_id}`
- Atualiza `name`, `tags`, `primary_genre` ou `visibility`
- [Excluir Music Finetune](/docs/pt/api-reference/music/finetunes/delete) - `DELETE /v1/music/finetunes/{finetune_id}`
### ElevenAgents
- `GET /v1/convai/conversations/resolve`
- Exige os parâmetros de consulta `agent_id` (string) e `reference` (string)
- Retorna `GetConversationResponseModel`
- `POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query`
- Exige `query` (string) no corpo da solicitação
- Aceita o parâmetro de consulta `branch_id` (string) opcional
- Retorna `AgentKnowledgeBaseRagQueryResponseModel`
- Excluído dos SDKs gerados
## Endpoints atualizados
### ElevenAgents
- [Buscar mensagens de conversa por texto](/docs/pt/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
- Adicionados os parâmetros de consulta de array `exclude_statuses` e `termination_reasons` opcionais
### Speech to Text
- [Converter fala em texto](/docs/pt/api-reference/speech-to-text/convert) - `POST /v1/speech-to-text`
- Adicionado parâmetro de consulta `token` (string) opcional para um token Scribe em lote de uso único
### Text to Speech
- [Listar dicionários de pronúncia](/docs/pt/api-reference/pronunciation-dictionaries/list) - `GET /v1/pronunciation-dictionaries`
- Adicionado parâmetro de consulta `include_archived` (booleano, padrão `true`) opcional
### Espaços de trabalho
- [Atualizar webhook do espaço de trabalho](/docs/pt/api-reference/webhooks/update) - `PATCH /v1/workspace/webhooks/{webhook_id}`
- Adicionado campo de solicitação `events` (`WorkspaceWebhookEventType[]`) opcional
- [Obter uso do espaço de trabalho](/docs/pt/api-reference/analytics/workspace/usage) - `POST /v1/workspace/analytics/query/usage-by-product-over-time`
- Adicionados `surface` e `actor` ao array `group_by` opcional
- [Atualizar chave de API da conta de serviço](/docs/pt/api-reference/service-accounts/api-keys/update) - `PATCH /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id}`
- Adicionado `"clear"` ao campo `character_limit` opcional
## Alterações de esquema
### ElevenAgents
- Os esquemas de resposta da base de conhecimento do ElevenAgents adicionam `content_format` (`html` | `markdown`, padrão `html`) opcional
- As respostas de arquivo da base de conhecimento adicionam `auto_sync_info` e `refresh_status` (`FileRefreshStatus`) opcionais
- As respostas de pasta da base de conhecimento adicionam `document_count` (inteiro) obrigatório
- Os esquemas de substituição de TTS do agente adicionam `model_id` (`TTSConversationalModel`) opcional
- `enable_phoneme_tags` de TTS do agente agora tem como padrão `true` em vez de `false`
- `cascade_timeout_seconds` da LLM de backup agora tem como padrão 4 em vez de 8 segundos
- A configuração de LLM do agente adiciona `gpt-5.6-sol`, `gpt-5.6-terra` e `gpt-5.6-luna`; `LLMReasoningEffort` adiciona `max`
- Guardrails personalizados adicionam `evaluate_full_response_only` (booleano, padrão `false`) opcional
- A configuração de chamadas de telefonia adiciona `twilio_call_recording_enabled` (booleano, padrão `false`) opcional
- Os parâmetros de ferramenta do tipo objeto adicionam `dynamic_variable`, `constant_value` e `is_omitted`; substituições constantes aceitam valores arbitrários de array e objeto
- A configuração de texto do widget adiciona rótulos opcionais de upload de arquivos e indicador de digitação
- Os esquemas de conta do WhatsApp adicionam `enable_typing_indicator` (booleano) opcional
- Os esquemas de simulação e teste adicionam `AutoGenerationMetadata` e `SimulationLibrarySettings`
### Música
- Adicionados esquemas de solicitação, resposta, paginação, visibilidade, criador, status e motivo de falha de Music Finetune
- Todos os esquemas de solicitação de geração de música expõem `finetune_id` aos SDKs gerados
### Espaços de trabalho
- Os esquemas de solicitação e resposta de webhook do espaço de trabalho adicionam `events` (`WorkspaceWebhookEventType[]`) opcional
- Os esquemas de notificador de webhook de alertas usam `webhook_id` (string) obrigatório em vez de `url`, `method` e `headers`
## July 13, 2026
### ElevenAgents
- **Análise de sentimento por agente**: As configurações da plataforma adicionam `sentiment_analysis` (`SentimentAnalysisSettings`) opcional para configurar a pontuação de sentimento após a chamada por agente.
- **Tradução automática de transcrições**: As configurações da plataforma adicionam `auto_translate_transcript_to_app_language` (booleano) opcional para traduzir transcrições de conversas para o idioma do app do visualizador no histórico.
- **Transferências de agente aninhadas**: Os workflows adicionam operações push, pop e replace para transferências de agente aninhadas.
- **Detecção de interjeições**: Os modelos de turnos de usuário nas transcrições adicionam `ignored_as_backchannel` (booleano) opcional para marcar enunciados filtrados como interjeições.
- **Áudio auxiliar da conversa**: As respostas de [Obter conversa](/docs/pt/api-reference/conversations/get) adicionam `has_auxiliary_audio` (booleano) obrigatório junto às sinalizações de áudio existentes.
- **Escopo de ambiente do MCP**: As rotas de servidores e ferramentas MCP adicionam o parâmetro de consulta `environment` opcional (o padrão é produção) aos endpoints de listar ferramentas, obter ferramenta, criar configuração de ferramenta e atualizar configuração de ferramenta.
- **Substituição do som de chamada de ferramenta**: Os schemas de substituição de ferramentas e MCP permitem `tool_call_sound: "off"` para silenciar os sons de chamadas por ferramenta, mantendo os padrões do servidor quando não definido.
- **Roteamento de SMS da Twilio**: As solicitações de importação de números de telefone da Twilio adicionam `enable_sms` (booleano, ativado por padrão) opcional para controlar o roteamento de SMS recebidos durante a configuração do número.
- **Ordenação por sentimento do usuário**: [Listar usuários](/docs/pt/api-reference/users/list) adiciona `sort_direction` opcional e compatibilidade com ordenação por `average_sentiment_score`.
- **Sincronização externa da base de conhecimento**: Os schemas de sincronização externa renomeiam `ExternalSyncType` para `ExternalSyncProvider`, adicionam enums de acionamento e tipo de tarefa de sincronização com `KbExternalSyncJob`, e as respostas de pasta podem incluir `active_sync_job` para o status de sincronização em andamento ou concluída.
- **Descontinuação da configuração de latência de TTS**: `optimize_streaming_latency` nas configurações de TTS do agente foi marcado como descontinuado e documentado como sem efeito.
### Espaços de trabalho
- **Criar contas de serviço**: Adicionado [Criar conta de serviço](/docs/pt/api-reference/service-accounts/create) (`POST /v1/service-accounts`) com `default_sharing_groups` (`DefaultSharingGroupConfig`) opcional para provisionamento programático de contas de serviço.
- **Listar membros do espaço de trabalho**: Adicionado [Obter membros do espaço de trabalho](/docs/pt/api-reference/workspace/members/list) (`GET /v1/workspace/members`), que retorna entradas `WorkspaceMemberResponseModel` com ID de usuário, e-mail, status de assento e sinalizações de proprietário e bloqueio. Contas de serviço são excluídas.
- **Limites de créditos em convites**: As cargas úteis de convite para espaços de trabalho (individual e em massa) adicionam `usage_limit` opcional para um limite mensal de créditos dos convidados.
### Lançamentos de SDK
#### SDK JavaScript
- [v2.57.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.57.0) - Regenerado a partir do schema OpenAPI mais recente com tipos de ferramenta de sistema `run_subagent`, configurações de análise de sentimento por agente, modelos de workflow de transferência de agente aninhada, tipos de sincronização externa da base de conhecimento e parâmetros de consulta `environment` do MCP.
- [v2.58.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.58.0) - Regenerado a partir do schema OpenAPI mais recente com criação de contas de serviço, listagem de membros do espaço de trabalho, `usage_limit` de convite, `has_auxiliary_audio` de conversa e tipos de mensagens WebSocket de texto para diálogo com vários contextos.
#### SDK Python
- [v2.57.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.57.0) - Regenerado a partir do schema OpenAPI mais recente com modelos de ferramenta de sistema `run_subagent`, configurações de análise de sentimento por agente, modelos de workflow de transferência de agente aninhada, tipos de sincronização externa da base de conhecimento e parâmetros de consulta `environment` do MCP.
- [v2.58.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.58.0) - Regenerado a partir do schema OpenAPI mais recente com criação de contas de serviço, listagem de membros do espaço de trabalho, `usage_limit` de convite, `has_auxiliary_audio` de conversa e tipos de mensagens WebSocket de texto para diálogo com vários contextos.
#### Pacotes
- [@elevenlabs/client@1.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.15.0) - Adicionado callback `onPing` que expõe eventos `ping` e `ping_ms` estimado para monitoramento da latência de conexão.
- [@elevenlabs/react@1.10.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.10.0) - Exposto o callback `onPing` de `@elevenlabs/client@1.15.0` nos hooks do React.
- [@elevenlabs/types@0.17.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.17.1), [@elevenlabs/convai-widget-core@0.14.10](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.10) e [@elevenlabs/convai-widget-embed@0.14.10](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.10) - Alinhamento de dependências com `@elevenlabs/client@1.15.0`.
### API
## Novos endpoints
### Espaços de trabalho
- [Criar conta de serviço](/docs/pt/api-reference/service-accounts/create) - `POST /v1/service-accounts`
- [Obter membros do espaço de trabalho](/docs/pt/api-reference/workspace/members/list) - `GET /v1/workspace/members`
## Endpoints atualizados
### ElevenAgents
- [Obter conversa](/docs/pt/api-reference/conversations/get) - `GET /v1/convai/conversations/{conversation_id}`
- Adicionado `has_auxiliary_audio` (booleano) obrigatório à resposta
- [Listar usuários](/docs/pt/api-reference/users/list) - `GET /v1/convai/users`
- Adicionado parâmetro de consulta `sort_direction` opcional
- Adicionado `average_sentiment_score` como opção de ordenação
- [Obter ferramenta](/docs/pt/api-reference/tools/get) - `GET /v1/convai/tools/{tool_id}`
- Adicionado parâmetro de consulta `environment` opcional
- [Listar ferramentas do servidor MCP](/docs/pt/api-reference/mcp/list-tools) - `GET /v1/convai/mcp-servers/{mcp_server_id}/tools`
- Adicionado parâmetro de consulta `environment` opcional
- [Criar configuração de ferramenta MCP](/docs/pt/api-reference/mcp/tool-configuration/create) - `POST /v1/convai/mcp-servers/{mcp_server_id}/tool-configs`
- Adicionado parâmetro de consulta `environment` opcional
- [Atualizar configuração de ferramenta MCP](/docs/pt/api-reference/mcp/tool-configuration/update) - `PATCH /v1/convai/mcp-servers/{mcp_server_id}/tool-configs/{tool_name}`
- Adicionado parâmetro de consulta `environment` opcional
### Espaços de trabalho
- [Convidar usuário](/docs/pt/api-reference/workspace/invites/create) - `POST /v1/workspace/invites/add`
- Adicionado `usage_limit` opcional para o limite mensal de créditos dos convidados
- [Convidar vários usuários](/docs/pt/api-reference/workspace/invites/create-batch) - `POST /v1/workspace/invites/add/bulk`
- Adicionado `usage_limit` opcional para o limite mensal de créditos dos convidados
## Alterações de schema
### ElevenAgents
- Ferramentas de sistema
- Adicionado `run_subagent` (`RunSubagentToolConfig`) com array `agents` obrigatório
- Configurações da plataforma
- Adicionado `sentiment_analysis` (`SentimentAnalysisSettings`) opcional
- Adicionado `auto_translate_transcript_to_app_language` (booleano) opcional
- Workflows
- Adicionada modelagem aninhada de `AgentTransfer` com push, pop e replace de `AgentTransferOp`
- Transcrições
- Adicionado `ignored_as_backchannel` (booleano) opcional aos modelos de turno de usuário
- Ferramentas e MCP
- Adicionado suporte à substituição `tool_call_sound: "off"` nos modelos de configuração de ferramentas
- `optimize_streaming_latency` descontinuado nas configurações de TTS do agente (sem efeito)
- Telefonia
- Adicionado `enable_sms` (booleano) opcional às solicitações de importação de números de telefone da Twilio
- Base de conhecimento
- Renomeado `ExternalSyncType` para `ExternalSyncProvider`
- Adicionados `KbExternalSyncJob`, enums de acionamento e tipo de tarefa de sincronização
- Adicionado `active_sync_job` opcional às respostas de pasta
- Sentimento
- Expandido `SentimentAggregate` com contagens e pontuações médias de janelas recentes
### Espaços de trabalho
- Contas de serviço
- Adicionado `WorkspaceCreateServiceAccountResponseModel` para respostas de criação
- Adicionado `default_sharing_groups` opcional às solicitações de criação
- Membros
- Adicionado `WorkspaceMemberResponseModel` para respostas de listagem
- Convites
- Adicionado `usage_limit` opcional aos corpos de solicitação de convite individual e em massa
## July 6, 2026
### Música
- **Transmitir música com detalhes**: Adicionamos [Transmitir música com detalhes](/docs/pt/api-reference/music/compose-detailed-stream) (`POST /v1/music/detailed/stream`) para streaming SSE de áudio composto com metadados detalhados, incluindo plano de composição, metadados da música, trechos de áudio em base64 e timestamps opcionais de palavras por meio de `with_timestamps`.
### ElevenAgents
- **Descontinuação de simular conversa**: [Simular conversa](/docs/pt/api-reference/agents/simulate-conversation) e [Transmitir simulação de conversa](/docs/pt/api-reference/agents/simulate-conversation-stream) foram descontinuados em favor de [Criar teste](/docs/pt/api-reference/tests/create) e [Executar testes no agente](/docs/pt/api-reference/tests/run-tests).
- **Modo de interrupção de ferramenta**: `disable_interruptions` foi descontinuado nos esquemas de ferramentas de agentes e servidores MCP. Use `interruption_mode` (`ToolInterruptionMode`: `allow`, `disable_during_tool`, `disable_during_tool_and_turn`) em vez disso, com substituições por ferramenta por meio de `interruption_mode` nos modelos de substituição de ferramentas.
- **Pontuação de avaliação numérica**: Os esquemas de critérios de avaliação adicionam `scoring_mode` opcional (`binary` | `numeric_uniform`), `max_score` opcional (inteiro) e `score_instructions` opcional (string). Os resultados de avaliação adicionam `score` numérico opcional. As cargas de análise de conversa adicionam `call_success_score` e `success_score` opcionais.
- **Raciocínio da conversa**: Os modelos de transcrição e histórico adicionam `reasoning` opcional (`ConversationReasoningModel`), e as respostas de transcrição adicionam `reasoned` opcional (booleano). Os esquemas de prompt de agente e LLM adicionam `enable_reasoning_summary` opcional (booleano).
- **Cobrança da plataforma de conversas**: Os modelos relacionados a conversas adicionam `platform_charge`, `platform_price` e `platform_usage` opcionais, com detalhamento por categoria por meio de `PlatformCategory` e `PlatformCategoryUsage`.
- **Metadados de custo de conversa**: Os metadados do histórico de conversa adicionam `cost_fiat` obrigatório e somente leitura (número, USD).
- **Eventos de webhook sem redação**: `WebhookEventType` adiciona `unredacted_transcript` e `unredacted_audio` para assinaturas de webhook que precisam de cargas sem redação.
- **Limite de UUI para transferência telefônica em workflow**: O comprimento máximo de `UUITransferConfig.data` aumenta de 256 para 8192 caracteres para Informações Usuário a Usuário do RFC 7433 em transferências SIP REFER.
### Mecanismo de fala
- **Ignorar autenticação opcionalmente**: Os SDKs JavaScript e Python v2.56.0 adicionam `disableAuth` / `disable_auth` opcionais nos clientes WebSocket do Mecanismo de fala. Isso é destinado a integrações que protegem a conexão por outros meios, como lista de permissões de IP ou cabeçalhos de autenticação personalizados, em vez de autenticação por chave de API.
### Workspaces
- **Rastreamento de slots de voz profissional**: Os modelos de estilo de assinatura adicionam `professional_voice_slots_used_in_workspace` opcional junto com o `professional_voice_slots_used` esclarecido para todo o grupo, proporcionando visibilidade consolidada de cobrança.
### ElevenCreative Studio
- **Estilo de legendas**: Os modelos de estilo de legenda adicionam campos de desfoque e raio da borda. Os enums de animação de entrada e saída adicionam `slam`, `scale_down` e `slide_in`.
### Lançamentos de SDK
#### SDK JavaScript
- [v2.56.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.56.0) - Adicionado `disableAuth` opcional nos clientes WebSocket do Mecanismo de fala. Regenerado a partir do esquema OpenAPI mais recente com streaming detalhado de música, `interruption_mode` de ferramenta, modos de pontuação de avaliação, campos de raciocínio de conversa e cobrança de plataforma.
#### SDK Python
- [v2.56.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.56.0) - Adicionado `disable_auth` opcional nos clientes WebSocket do Mecanismo de fala. Regenerado a partir do esquema OpenAPI mais recente com streaming detalhado de música, `interruption_mode` de ferramenta, modos de pontuação de avaliação, campos de raciocínio de conversa e cobrança de plataforma.
#### CLI
- [@elevenlabs/cli@0.5.5](https://github.com/elevenlabs/cli/releases/tag/@elevenlabs%2Fcli%400.5.5) - As solicitações de criação e atualização de agentes agora são enviadas como JSON bruto para preservar a fidelidade de ida e volta da configuração.
### API
## Novos endpoints
### Música
- [Transmitir música com detalhes](/docs/pt/api-reference/music/compose-detailed-stream) - `POST /v1/music/detailed/stream`
## Endpoints atualizados
### ElevenAgents
- [Simular conversa](/docs/pt/api-reference/agents/simulate-conversation) - `POST /v1/convai/agents/{agent_id}/simulate-conversation`
- Marcado como descontinuado; use [Criar teste](/docs/pt/api-reference/tests/create) e [Executar testes no agente](/docs/pt/api-reference/tests/run-tests) em vez disso
- [Transmitir simulação de conversa](/docs/pt/api-reference/agents/simulate-conversation-stream) - `POST /v1/convai/agents/{agent_id}/simulate-conversation/stream`
- Marcado como descontinuado; use [Criar teste](/docs/pt/api-reference/tests/create) e [Executar testes no agente](/docs/pt/api-reference/tests/run-tests) em vez disso
## Alterações de esquema
### ElevenAgents
- Ferramentas e MCP
- Descontinuado `disable_interruptions` em favor de `interruption_mode` (`allow`, `disable_during_tool`, `disable_during_tool_and_turn`)
- Adicionadas substituições de `interruption_mode` por ferramenta nos modelos de substituição MCP e de ferramentas
- Avaliação e análise
- Adicionados `scoring_mode`, `max_score` e `score_instructions` opcionais nos critérios de avaliação
- Adicionado `score` numérico opcional nos resultados de avaliação
- Adicionados `call_success_score` e `success_score` opcionais nas cargas de análise de conversa
- Transcrições e raciocínio
- Adicionado `reasoning` opcional (`ConversationReasoningModel`) nos modelos de transcrição e histórico
- Adicionado `reasoned` opcional (booleano) nas respostas de transcrição
- Adicionado `enable_reasoning_summary` opcional (booleano) nos esquemas de prompt de agente e LLM
- Cobrança e metadados
- Adicionados `platform_charge`, `platform_price` e `platform_usage` opcionais nos modelos de conversa
- Adicionado `cost_fiat` obrigatório e somente leitura (USD) nos metadados do histórico de conversa
- Webhooks
- Adicionados `unredacted_transcript` e `unredacted_audio` a `WebhookEventType`
- Workflows
- Aumentado o comprimento máximo de `UUITransferConfig.data` de 256 para 8192 caracteres
### Workspaces
- Cobrança
- Adicionado `professional_voice_slots_used_in_workspace` opcional nos modelos de estilo de assinatura
### ElevenCreative Studio
- Legendas
- Adicionados campos de desfoque e raio da borda nos modelos de estilo de legenda
- Adicionados os tipos de animação `slam`, `scale_down` e `slide_in`
## June 29, 2026
### ElevenAgents
- **Prévia de merge e rebase de branches**: Adicionamos [Prévia da configuração mesclada](/docs/pt/api-reference/agents/branches/preview) (`GET /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge-preview`) e prévia da configuração com rebase (`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/rebase-preview`) para inspecionar a configuração mesclada ou com rebase do agente antes de confirmar. Ambas retornam `MergePreviewResponseModel` com a configuração resultante, `overridden_fields` e `source_identical_to_target`.
- **Métricas de uso de branches**: As respostas de resumo de branches de [Listar branches do agente](/docs/pt/api-reference/agents/branches/list) adicionam `calls_7d` opcional (inteiro), com o volume de chamadas de sete dias por branch.
- **Status da conexão de autenticação**: Os modelos de resposta de conexão de autenticação do workspace substituem o `OAuthConnectionStatus`, exclusivo para OAuth, pelo `AuthConnectionStatus` compartilhado (`active`, `refresh_failed`, `revoked`, `credential_invalid`). As respostas de autenticação Bearer, Basic, mTLS, cabeçalho personalizado, OAuth, OAuth2 JWT, Slack, segredo de URL e WhatsApp adicionam os campos opcionais `status`, `status_detail` e `status_updated_at`.
- **Filtragem de respostas de ferramentas**: Os esquemas de configuração de ferramentas HTTP e de agentes adicionam `response_filter` opcional para reduzir as respostas de ferramentas antes que cheguem ao LLM, com `response_filter_mode` e `response_filters` nos modelos de substituição relacionados.
- **Transferências telefônicas em workflows**: Os nós de transferência de número de telefone em workflows adicionam `uui` opcional (`UUITransferConfig`) para Informações Usuário a Usuário em hexadecimal do RFC 7433 em transferências SIP REFER.
- **Atribuição de agente de telefonia**: Os esquemas de solicitação de importação de números de telefone Twilio, Exotel e tronco SIP adicionam `agent_id` opcional (string) para atribuir um agente durante a configuração do número.
- **Transcrição de turno com interrupções desativadas**: Os esquemas de configuração de turno adicionam `transcribe_on_disabled_interruptions` opcional (booleano, padrão `false`) para controlar se a fala do usuário é transcrita quando as interrupções estão desativadas.
- **Sentimento da conversa**: Os esquemas de resumo de conversa adicionam `sentiment_analysis` opcional. Os modelos de usuário da conversa adicionam `sentiment` opcional com referências a conversas frustradas.
### Speech to Text
- **Saída multicanal combinada**: [Converter fala em texto](/docs/pt/api-reference/speech-to-text/convert) adiciona `multichannel_output_style` opcional (`separate` padrão | `combined`) quando `use_multi_channel` está ativado. Defina `combined` para receber uma única transcrição com todos os canais mesclados e ordenados por tempo, em vez de transcrições por canal. As respostas no nível de palavra incluem `channel_index` em cada palavra quando o modo multicanal está ativo.
### Text to Speech
- **Comportamento de `language_code`**: Os esquemas de solicitação de TTS esclarecem que valores `language_code` não compatíveis são ignorados, em vez de rejeitados, e que `language_code` não é compatível com modelos `multilingual_v2`.
### Workspaces
- **Política de desativação de chaves de API de terceiros**: Adicionamos [Definir política de desativação de terceiros do workspace](/docs/pt/api-reference/api-keys/set-third-party-disabling-policy) (`POST /v1/workspaces/api-keys/third-party-disabling`) para controle em todo o workspace sobre se os titulares de chaves de API podem desativar as próprias chaves pelo endpoint de desativação de terceiros. Os modelos de criação, patch e resposta de chaves de API do workspace adicionam `third_party_disable_allowed` opcional (booleano).
- **Atualizações de conexão de autenticação Bearer**: A união de solicitações de [Atualizar conexão de autenticação do workspace](/docs/pt/api-reference/workspace/auth-connections/update) adiciona `UpdateBearerAuthRequest` para atualizações de credenciais de token Bearer.
- **Permissões do workspace**: Os enums de permissão adicionam `conversation_privacy_manage` e `synthid_detector`. Os modelos de grupo do workspace adicionam `scim_group` opcional (string).
### Lançamentos de SDK
#### SDK JavaScript
- [v2.55.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.55.0) - Regenerado a partir do esquema OpenAPI mais recente com clientes de prévia de merge e rebase de branches, métricas de volume de chamadas por branch, campos de status de conexão de autenticação, tipos de filtragem de respostas de ferramentas, saída multicanal combinada de Speech to Text e política de desativação de chaves de API de terceiros do workspace.
#### SDK Python
- [v2.55.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.55.0) - Regenerado a partir do esquema OpenAPI mais recente com clientes de prévia de merge e rebase de branches, métricas de volume de chamadas por branch, campos de status de conexão de autenticação, modelos de filtragem de respostas de ferramentas, saída multicanal combinada de Speech to Text e política de desativação de chaves de API de terceiros do workspace.
#### Pacotes
- [@elevenlabs/client@1.13.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.13.0) - `sendFeedback(like, eventId?)` aceita um `event_id` opcional para avaliar uma mensagem anterior específica. `canSendFeedback` agora reflete o estado da conexão, para que o feedback possa ser enviado para qualquer mensagem enquanto a sessão estiver ativa.
- [@elevenlabs/client@1.14.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.14.0) - `sendFeedback` aceita `null` como primeiro argumento para limpar o feedback de um evento (`score: null`).
- [@elevenlabs/react@1.8.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.8.0) e [@elevenlabs/react@1.9.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.9.0) - Expuseram nos hooks do React as alterações de `sendFeedback` por mensagem e de limpeza de feedback de `@elevenlabs/client@1.13.0` e `@elevenlabs/client@1.14.0`.
- [@elevenlabs/react-native@1.2.11](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.11) e [@elevenlabs/react-native@1.2.12](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.12) - Alinhamento de dependências com `@elevenlabs/client@1.13.0`–`1.14.0` e `@elevenlabs/react@1.8.0`–`1.9.0`.
- [@elevenlabs/types@0.16.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.16.0), [@elevenlabs/convai-widget-core@0.14.6](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.6)–[0.14.8](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.8) e [@elevenlabs/convai-widget-embed@0.14.6](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.6)–[0.14.8](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.8) - Alinhamento de dependências com `@elevenlabs/client@1.13.0`–`1.14.0`.
#### SDK Android
- [v0.10.0](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.10.0) - Expôs a transcrição de mensagens reconciliada como `StateFlow`. Descontinuou callbacks de texto e agente em favor de variantes com ID de evento.
- [v0.11.0](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.11.0) - Adicionou callback de frame de áudio para inspeção de áudio por frame durante conversas.
#### SDK iOS
- [v3.2.2](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.2.2) - Corrigiu a implementação do método delegado de sala do LiveKit para o processamento correto de eventos da sala.
### API
## Novos endpoints
### ElevenAgents
- `GET /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge-preview` - Prévia da configuração mesclada antes do merge
- `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/rebase-preview` - Prévia da configuração com rebase antes do rebase
### Workspaces
- `POST /v1/workspaces/api-keys/third-party-disabling` - Definir política de desativação de chaves de API de terceiros do workspace
## Endpoints atualizados
### ElevenAgents
- [Listar branches do agente](/docs/pt/api-reference/agents/branches/list) - `GET /v1/convai/agents/{agent_id}/branches`
- As respostas de resumo de branches adicionam `calls_7d` opcional (inteiro)
- [Prévia da configuração mesclada](/docs/pt/api-reference/agents/branches/preview) - `GET /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge-preview`
- Retorna `MergePreviewResponseModel` com a configuração mesclada, `overridden_fields` e `source_identical_to_target`
- Prévia da configuração com rebase - `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/rebase-preview`
- Retorna `MergePreviewResponseModel` com a prévia da configuração com rebase
### Speech to Text
- [Converter fala em texto](/docs/pt/api-reference/speech-to-text/convert) - `POST /v1/speech-to-text`
- Adicionado `multichannel_output_style` opcional (`separate` | `combined`) quando `use_multi_channel` está ativado
- As respostas no nível de palavra incluem `channel_index` por palavra no modo multicanal
### Workspaces
- [Definir política de desativação de terceiros do workspace](/docs/pt/api-reference/api-keys/set-third-party-disabling-policy) - `POST /v1/workspaces/api-keys/third-party-disabling`
- Controla se os titulares de chaves de API podem desativar as próprias chaves pelo fluxo de desativação de terceiros
- [Atualizar conexão de autenticação do workspace](/docs/pt/api-reference/workspace/auth-connections/update) - `PATCH /v1/workspace/auth-connections/{auth_connection_id}`
- A união de solicitações adiciona `UpdateBearerAuthRequest`
## Alterações de esquema
### ElevenAgents
- Conexões de autenticação
- Substituído `OAuthConnectionStatus` por `AuthConnectionStatus` (`active`, `refresh_failed`, `revoked`, `credential_invalid`)
- Adicionados `status`, `status_detail` e `status_updated_at` opcionais nos modelos de resposta de conexão de autenticação
- Ferramentas e workflows
- Adicionado `response_filter` opcional nas configurações de ferramentas HTTP e de agentes
- Adicionado `uui` opcional (`UUITransferConfig`) nos modelos de workflow relacionados a transferências
- Configuração de turno
- Adicionado `transcribe_on_disabled_interruptions` opcional (booleano, padrão `false`)
- Importações de telefonia
- Adicionado `agent_id` opcional nos esquemas de solicitação de importação de Twilio, Exotel e tronco SIP
- Modelos de conversa
- Adicionado `sentiment_analysis` opcional nos tipos de resumo de conversa
- Adicionado `sentiment` opcional nos modelos de usuário da conversa
### Text to Speech
- Esclarecido que `language_code` é ignorado quando não é compatível e não é compatível com `multilingual_v2`
### Workspaces
- Chaves de API
- Adicionado `third_party_disable_allowed` opcional (booleano) nos modelos de criação, patch e resposta
- Permissões
- Adicionados `conversation_privacy_manage` e `synthid_detector`
- Grupos
- Adicionado `scim_group` opcional (string) nos modelos de grupo do workspace
## June 22, 2026
### ElevenAgents
- **Rebase de branch**: Adicionado `POST /v1/convai/agents/{agent_id}/branches/{branch_id}/rebase` para fazer o rebase de uma branch na main mais recente, preservando as alterações específicas da branch. Os modelos pai de versões de agentes adicionam o campo opcional `rebased_from_version_id` (string) para rastrear a versão de origem após um rebase.
- **Filtragem de produto de conversas**: [Listar conversas](/docs/pt/api-reference/conversations/list) e [Pesquisar mensagens de conversas por texto](/docs/pt/api-reference/conversations/messages/text-search) adicionam o parâmetro de consulta opcional `conversation_product_type` (`agents` | `speech_engine`) para filtrar resultados por produto. Os modelos de conversa introduzem `ConversationProduct` para essa distinção.
- **Filtragem de encerramento de conversas**: [Listar conversas](/docs/pt/api-reference/conversations/list) adiciona o parâmetro de consulta opcional `termination_reasons` (array de strings) para filtrar conversas pela forma como foram encerradas.
- **Descoberta de tópicos por agente**: As configurações de plataforma de [Criar agente](/docs/pt/api-reference/agents/create) e [Atualizar agente](/docs/pt/api-reference/agents/update) adicionam o campo opcional `topic_discovery` (`TopicDiscoverySettings`) para configurar a descoberta de tópicos por agente.
- **Configuração de som de fundo**: Os modelos de configuração de plataforma e conversa de agentes adicionam o campo opcional `background_sound` (`BackgroundSoundConfig`) para áudio ambiente durante as conversas.
- **Termos ignorados na interrupção de turnos**: Os esquemas de configuração de turnos adicionam o campo opcional `interruption_ignore_terms` (array de strings) para suprimir a detecção de turnos em frases específicas.
- **Aleatorização de preenchimentos de tempo limite flexível**: A configuração de tempo limite flexível adiciona o campo opcional `randomize_fillers` (boolean) para alternar mensagens de preenchimento entre os tempos limites flexíveis. Os campos de substituição de mensagens de tempo limite flexível e de prompt do LLM agora oferecem suporte a variáveis dinâmicas.
- **Identificadores de usuário em transcrições**: Os modelos de mensagens de transcrição adicionam o campo opcional `user_identifier` (string) em mensagens escritas pelo usuário.
- **Condições de sucesso de simulação**: Os esquemas de teste de simulação de agentes adicionam o campo opcional `success_conditions` (array, com até 30 itens). O campo legado `success_condition` foi descontinuado em favor da forma de array.
- **Limite de repetição de testes de agentes**: [Executar testes no agente](/docs/pt/api-reference/tests/run-tests) aumenta o máximo de `repeat_count` de 20 para 50.
- **Valores permitidos dinâmicos no esquema de ferramentas**: As propriedades do esquema JSON de ferramentas do ElevenAgents adicionam o campo opcional `allowed_values_dynamic_variable` (string) para seleções de valores pelo LLM, verificadas pelo servidor e obtidas de variáveis dinâmicas.
- **Documentação de URL assinada do widget**: [Obter widget](/docs/pt/api-reference/widget/get) atualiza a documentação de `conversation_signature` para fazer referência a `/v1/convai/conversation/get_signed_url`.
### Música
- **Formatos de saída de maior qualidade**: [Gerar música](/docs/pt/api-reference/music/compose), [Gerar música detalhada](/docs/pt/api-reference/music/compose-detailed) e [Transmitir música](/docs/pt/api-reference/music/stream) adicionam `mp3_48000_240` e `mp3_48000_320` aos valores compatíveis de `output_format`. Quando `output_format` é `auto`, os modelos v2 agora usam `mp3_48000_192` como padrão em vez de `mp3_48000_128`.
- **Esclarecimento sobre a flag de duração das seções**: `respect_sections_durations` se aplica apenas com `composition_plan` em `music_v1`. Em `music_v2`, as durações das seções são sempre aplicadas e essa flag é ignorada.
- **Divisão do esquema de plano de composição**: O `composition_plan` de solicitações de música usa uma união `oneOf` de `MusicPrompt` e `CompositionPlan`. O primeiro é usado para planos de composição de `music_v1`, e o segundo para `music_v2`.
### Dublagem
- **Filtros de lista de projetos**: [Listar dublagens](/docs/pt/api-reference/dubbing/list) adiciona os parâmetros de consulta de array opcionais `dubbing_statuses`, `dubbing_models`, `target_language_codes` e `creation_sources` para listagens filtradas. O parâmetro `order_by` agora aceita `name` além de `created_at`.
### Espaços de trabalho
- **Motivos de bloqueio e desativação**: Os modelos de espaço de trabalho e chave de API adicionam `LockReason` e os campos opcionais `disable_reason`. As configurações de grupo do espaço de trabalho adicionam o campo opcional `scim_frozen` (boolean) para o estado de congelamento gerenciado por SCIM.
### ElevenCreative Studio
- **Animações de legendas**: Os enums de animação de entrada e saída de legendas do Estúdio adicionam `pop`, `slide_up` e `slide_down`.
### Lançamentos de SDKs
#### SDK JavaScript
- [v2.54.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.54.0) - Regenerado a partir do esquema OpenAPI mais recente, com suporte do cliente para rebase de branch, filtros `conversation_product_type` e `termination_reasons` para lista e pesquisa por texto de conversas, filtros de múltiplos valores para lista de dublagens, tipos de `output_format` específicos para música, configurações de descoberta de tópicos e remoção de tipos exportados relacionados a coaching.
- [v2.53.1](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.53.1) - Restaurados valores opcionais em registros `DynamicVariablesConfig` que foram restringidos incorretamente na v2.53.0.
#### SDK Python
- [v2.54.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.54.0) - Regenerado a partir do esquema OpenAPI mais recente, com suporte do cliente para rebase de branch, filtros para lista e pesquisa por texto de conversas, filtros de múltiplos valores para lista de dublagens, atualizações de formato de saída de música, configurações de descoberta de tópicos e remoção de tipos exportados relacionados a coaching. `ElevenLabs` e `AsyncElevenLabs` agora aceitam o encaminhamento de `headers` e `follow_redirects` para o cliente base.
#### Pacotes
- [@elevenlabs/client@1.12.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.12.0) - Adicionado suporte a `overrides.asr.keywords` no cliente de navegador para que a priorização de palavras-chave de ASR por conversa possa ser enviada via `conversation_initiation_client_data`.
- [@elevenlabs/react@1.7.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.7.0) - Exposto `includeLanguageDetection` para sessões Scribe em tempo real, incluindo suporte do React `useScribe` para solicitar e ler metadados de idioma detectado.
- [@elevenlabs/react-native@1.2.9](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.9), [@elevenlabs/types@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.15.0), [@elevenlabs/convai-widget-core@0.14.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.4) e [@elevenlabs/convai-widget-embed@0.14.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.4) - Alinhamento de dependências com `@elevenlabs/client@1.12.0` e `@elevenlabs/types@0.15.0`.
- [@elevenlabs/client@1.12.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.12.1) - Exposto o auxiliar de upload de arquivos pelo ponto de entrada interno do Unity.
- [@elevenlabs/react@1.7.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.7.1), [@elevenlabs/react-native@1.2.10](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.10), [@elevenlabs/convai-widget-core@0.14.5](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.5) e [@elevenlabs/convai-widget-embed@0.14.5](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.5) - Alinhamento de dependências com `@elevenlabs/client@1.12.1`.
#### Servidor MCP
- [v0.10.0](https://github.com/elevenlabs/elevenlabs-mcp/releases/tag/v0.10.0) - Adicionados o modelo e endpoints Music v2, anotações de ferramentas MCP para todas as 24 ferramentas, suporte ao Python 3.14, residência de dados em Singapura, aliases abreviados de residência na UE/Índia, tratamento de encerramento seguro para desconexões de clientes e correções para criação de prévias de voz e resolução de caminhos de diretório de saída.
### API
## Novos endpoints
### ElevenAgents
- `POST /v1/convai/agents/{agent_id}/branches/{branch_id}/rebase` - Faz o rebase de uma branch na main mais recente, preservando as alterações específicas da branch
## Endpoints atualizados
### ElevenAgents
- [Listar conversas](/docs/pt/api-reference/conversations/list) - `GET /v1/convai/conversations`
- Adicionado o parâmetro de consulta opcional `conversation_product_type` (`agents` | `speech_engine`)
- Adicionado o parâmetro de consulta opcional `termination_reasons` (array de strings)
- [Pesquisar mensagens de conversas por texto](/docs/pt/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
- Adicionado o parâmetro de consulta opcional `conversation_product_type` (`agents` | `speech_engine`)
- [Obter widget](/docs/pt/api-reference/widget/get) - `GET /v1/convai/agents/{agent_id}/widget`
- Atualizada a documentação de `conversation_signature` para fazer referência a `/v1/convai/conversation/get_signed_url`
- [Executar testes no agente](/docs/pt/api-reference/tests/run-tests) - `POST /v1/convai/agents/{agent_id}/run-tests`
- Aumentado o máximo de `repeat_count` de 20 para 50
### Dublagem
- [Listar dublagens](/docs/pt/api-reference/dubbing/list) - `GET /v1/dubbing`
- Adicionados os parâmetros de consulta opcionais `dubbing_statuses`, `dubbing_models`, `target_language_codes` e `creation_sources`
- `order_by` agora aceita `name` além de `created_at`
### Música
- [Gerar música](/docs/pt/api-reference/music/compose), [Gerar música detalhada](/docs/pt/api-reference/music/compose-detailed) e [Transmitir música](/docs/pt/api-reference/music/stream)
- Adicionados `mp3_48000_240` e `mp3_48000_320` aos valores compatíveis de `output_format`
- O formato de saída `auto` seleciona `mp3_48000_192` para modelos v2 (antes, `mp3_48000_128`)
## Alterações de esquema
### ElevenAgents
- Branches e versões de agentes
- Adicionado o campo opcional `rebased_from_version_id` nos modelos pai de versões de agentes
- Configuração de plataforma e conversa
- Adicionado o campo opcional `topic_discovery` (`TopicDiscoverySettings`) nos modelos de solicitação e resposta de configurações de plataforma
- Adicionado o campo opcional `background_sound` (`BackgroundSoundConfig`)
- Configuração de turnos e tempos limite
- Adicionado o campo opcional `interruption_ignore_terms` (array de strings) nos esquemas de configuração de turnos
- Adicionado o campo opcional `randomize_fillers` (boolean) na configuração de tempo limite flexível
- Transcrições e simulação
- Adicionado o campo opcional `user_identifier` (string) nas mensagens de usuário da transcrição
- Adicionado o campo opcional `success_conditions` (array, máximo de 30); `success_condition` foi descontinuado
- Propriedades do esquema JSON de ferramentas
- Adicionado o campo opcional `allowed_values_dynamic_variable` (string)
### Música
- Planos de composição
- O campo de solicitação `composition_plan` usa `oneOf` (`MusicPrompt` | `CompositionPlan`)
- Esclarecido o comportamento de `respect_sections_durations` para `music_v1` versus `music_v2`
### Espaços de trabalho
- Adicionados o enum `LockReason` e os campos opcionais `disable_reason`
- Adicionado o campo opcional `scim_frozen` (boolean) nas configurações de grupo do espaço de trabalho
### ElevenCreative Studio
- Os enums de animação de legendas adicionam `pop`, `slide_up` e `slide_down`
## Esquemas removidos
### ElevenAgents
- Removidos os esquemas de configuração relacionados a coaching (`CoachedAgentSettings`, `CoachingAgentSettings`, `NoCoachingSettings`)
_Showing the 20 most recent of 100 entries. Append `/llms.txt` to the changelog URL for the complete index._