> 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

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

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

</Accordion>