Changelog

Novos endpoints

ElevenAgents

• Adicionados nove endpoints de tickets de triagem de conversas:
  • Criar ticket de conversa - 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 - GET /v1/convai/agents/{agent_id}/triage-tickets, com paginação por cursor.
  • Criar ticket manual - 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 - 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 - GET /v1/convai/triage-tickets/{agentqa_ticket_id}.
  • Atualizar ticket - PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}. A solicitação aceita status opcional e assignee_user_id anulável.
  • Excluir ticket - DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}.
  • Adicionar comentário - 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 - 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 - 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 - 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 - 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 - 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 - 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 (GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures) e Obter procedimento (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 e Atualizar teste
  • 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, Criar tarefa de rastreamento e Criar pasta
  • 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 - 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<string, ProcedureVersionRef>). 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 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.