Changelog

Novos endpoints

Plataforma de Agentes

Configuração de ferramentas MCP

• POST /v1/convai/mcp-servers/{mcp_server_id}/tool-configs - Crie substituições de configuração para uma ferramenta MCP específica.
• GET /v1/convai/mcp-servers/{mcp_server_id}/tool-configs/{tool_name} - Recupere substituições de configuração para uma ferramenta MCP específica.
• PATCH /v1/convai/mcp-servers/{mcp_server_id}/tool-configs/{tool_name} - Atualize substituições de configuração para uma ferramenta MCP específica.
• DELETE /v1/convai/mcp-servers/{mcp_server_id}/tool-configs/{tool_name} - Remova substituições de configuração para uma ferramenta MCP específica.

Text to Dialogue

• POST /v1/text-to-dialogue/with-timestamps - Gere diálogos com alinhamento em nível de caractere e informações de segmentos de voz.
• POST /v1/text-to-dialogue/stream/with-timestamps - Transmita a geração de diálogos com alinhamento em nível de caractere e informações de segmentos de voz.

Tokens

• POST /v1/single-use-token/{token_type} - Gere tokens de uso único com prazo de validade para operações seguras.

API de Música

• POST /v1/music/stem-separation - Separe o áudio em stems individuais (vocais, bateria, baixo, instrumentos). Aceita upload de arquivos multipart e retorna um arquivo ZIP.

Endpoints atualizados

Text to Dialogue

• Text to dialogue com timestamps

  • Adicionado o array voice_segments com o campo obrigatório dialogue_input_index para rastrear a qual entrada de diálogo cada segmento corresponde
  • Esquema de resposta aprimorado com dados de alinhamento em nível de caractere

• Transmitir text to dialogue com timestamps

  • Adicionado suporte a streaming para voice_segments com alinhamento em nível de caractere
  • Inclui dialogue_input_index nos blocos de segmentos de voz

Música

• Endpoints de prompt de música atualizados:
  • Tamanho máximo do prompt aumentado do limite anterior para 4.100 caracteres
  • As linhas das letras agora oferecem suporte a até 200 caracteres por linha

Espaço de trabalho

• Obter recurso do espaço de trabalho
  • Adicionados dashboard e dashboard_configuration ao enum WorkspaceResourceType
  • Alterações no esquema de resposta (quebra de compatibilidade — consulte as notas de migração abaixo)

Faturamento

• Obter assinatura
  • Adicionado o campo next_billing_period (obrigatório) a PendingSubscriptionSwitchResponseModel
  • Adicionados subtotal_cents e tax_cents (anuláveis) a InvoiceResponseModel para uma melhor discriminação da fatura

Plataforma de Agentes

Chamadas em lote

• Enviar chamadas em lote

  • Tornado agent_phone_number_id anulável e opcional
  • Tornado phone_number anulável e opcional nos modelos de destinatário
  • Alterações no esquema de resposta (quebra de compatibilidade — consulte as notas de migração abaixo)

• Obter status de chamadas em lote

  • Tornados phone_number_id e phone_provider anuláveis

• Cancelar chamadas em lote & Tentar novamente chamadas em lote

  • Tornados os campos relacionados ao telefone anuláveis
  • Alterações no esquema de resposta (quebra de compatibilidade — consulte as notas de migração abaixo)

Destinos de transferência

• Endpoints relacionados a transferência agora oferecem suporte a destinos de transferência com variáveis dinâmicas:
  • Adicionado o tipo PhoneNumberDynamicVariableTransferDestination para transferências de número de telefone usando variáveis dinâmicas
  • Adicionado o tipo SIPUriDynamicVariableTransferDestination para transferências de URI SIP usando variáveis dinâmicas
  • Atualizados os discriminadores de PhoneNumberTransfer para incluir tipos de variáveis dinâmicas

Servidores MCP

• Criar servidor MCP, Obter servidor MCP, Atualizar servidor MCP
  • Adicionado o campo tool_config_overrides para personalização da configuração por ferramenta
  • Adicionado suporte a request_headers em MCPServerConfigUpdateRequestModel
  • Adicionadas as opções de configuração tool_call_sound e tool_call_sound_behavior

Ferramentas

• Melhorias no esquema de ferramentas:
  • LiteralJsonSchemaProperty agora inclui a flag is_system_provided
  • Os cabeçalhos das ferramentas de agentes agora oferecem suporte a ConvAIDynamicVariable para valores de cabeçalho dinâmicos

Integração com Twilio

• Endpoints de número de telefone atualizados:
  • Adicionado o campo opcional region_config para números de telefone Twilio
  • Adicionado o enum TwilioRegionId para seleção de região
  • Adicionado o enum TwilioEdgeLocation para configuração de localização de borda

Agentes

• Obter agente & Atualizar agente
  • Alterações no esquema de resposta (quebra de compatibilidade — consulte as notas de migração abaixo)