> 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.

### 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

<Accordion title="Ver alterações da 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.

</Accordion>