> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toolzz.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Atualizar Voice

> Endpoint para atualizar configurações de Voz

## Token de Acesso

<ParamField header="Authorization" type="string">
  Token de acesso ("Bearer" deve estar antes do token)
</ParamField>

## Corpo da Requisição

<ParamField path="id" type="string">
  ID do agente
</ParamField>

<ParamField body="visualIconId" type="string">
  ID opcional do ícone visual.
</ParamField>

<ParamField body="visualType" type="string">
  Tipo opcional de representação visual.
</ParamField>

<ParamField body="transcriptionCredentialId" type="string">
  ID opcional da credencial para serviços de transcrição.
</ParamField>

<ParamField body="voiceCredentialId" type="string">
  ID opcional da credencial para serviços de voz.
</ParamField>

<ParamField body="language" type="string">
  Configuração de idioma para o assistente de voz.
</ParamField>

<ParamField body="voiceId" type="string">
  ID opcional da voz utilizada.
</ParamField>

<ParamField body="voiceImage" type="string">
  Imagem opcional representando a voz.
</ParamField>

<ParamField body="voiceName" type="string">
  Nome opcional do perfil de voz.
</ParamField>

<ParamField body="voiceDescription" type="string">
  Descrição opcional do perfil de voz.
</ParamField>

<ParamField body="insertedLabsId" type="string">
  ID opcional de referência de laboratório.
</ParamField>

<ParamField body="model" type="string">
  Modelo do agente.
</ParamField>

<ParamField body="primaryColor" type="string">
  Configuração opcional de cor primária.
</ParamField>

<ParamField body="buttonColor" type="string">
  Configuração opcional de cor do botão.
</ParamField>

<ParamField body="webPrimaryColor" type="string">
  Cor primária opcional para interface web.
</ParamField>

<ParamField body="webButtonColor" type="string">
  Cor do botão opcional para interface web.
</ParamField>

<ParamField body="theme" type="string">
  Identificador ou configuração de tema opcional.
</ParamField>

<ParamField body="textTitle" type="string">
  Título opcional exibido na interface.
</ParamField>

<ParamField body="textDescription" type="string">
  Descrição opcional exibida na interface.
</ParamField>

<ParamField body="waitTime" type="string">
  Configuração de tempo de espera para interações.
</ParamField>

<ParamField body="callTime" type="string">
  Configuração opcional de duração da chamada.
</ParamField>

<ParamField body="voicePrompt" type="string">
  Configuração opcional de como o seu agente de voz deve se comportar durante a chamada.
</ParamField>

## Descrição da Resposta

Abaixo você verá a descrição da resposta da atualização de voz

<ResponseField name="id" type="uuid" required>
  Identificador único da configuração de voz.
</ResponseField>

<ResponseField name="botId" type="uuid" required>
  Identificador do agente associado.
</ResponseField>

<ResponseField name="visualIconId" type="uuid">
  ID do ícone usado para representação visual.
</ResponseField>

<ResponseField name="visualType" type="string">
  Tipo de layout visual aplicado (ex: completo, minimalista).
</ResponseField>

<ResponseField name="language" type="string">
  Código do idioma para interação por voz (ex: ptbr).
</ResponseField>

<ResponseField name="voiceId" type="string">
  ID da voz selecionada.
</ResponseField>

<ResponseField name="voiceName" type="string">
  Nome exibido da voz selecionada (opcional).
</ResponseField>

<ResponseField name="voiceDescription" type="string">
  Descrição para a voz (opcional).
</ResponseField>

<ResponseField name="insertedLabsId" type="string">
  ID da voz de serviços de laboratório integrados.
</ResponseField>

<ResponseField name="model" type="string">
  Configuração de modelo para a voz (pode estar vazio).
</ResponseField>

<ResponseField name="primaryColor" type="string">
  Cor primária para UI de voz.
</ResponseField>

<ResponseField name="buttonColor" type="string">
  Cor usada para botões de ação.
</ResponseField>

<ResponseField name="webPrimaryColor" type="string">
  Cor primária web.
</ResponseField>

<ResponseField name="webButtonColor" type="string">
  Cor do botão web.
</ResponseField>

<ResponseField name="theme" type="string">
  Tema da UI (ex: claro, escuro).
</ResponseField>

<ResponseField name="textTitle" type="string">
  Título exibido na interface de voz.
</ResponseField>

<ResponseField name="textDescription" type="string">
  Descrição exibida abaixo do título.
</ResponseField>

<ResponseField name="waitTime" type="number">
  Tempo de espera antes de iniciar a interação (em segundos).
</ResponseField>

<ResponseField name="callTime" type="number">
  Duração máxima da chamada (em segundos).
</ResponseField>

<ResponseField name="voiceCredentialId" type="uuid">
  ID da credencial para serviço de síntese de voz.
</ResponseField>

<ResponseField name="bot" type="Bot" required>
  <Expandable title="properties">
    <ResponseField name="id" type="uuid" required>
      Identificador do agente.
    </ResponseField>

    <ResponseField name="name" type="string" required>
      Nome exibido do agente.
    </ResponseField>

    <ResponseField name="description" type="string" required>
      Breve descrição do propósito do agente.
    </ResponseField>

    <ResponseField name="prompt" type="string" required>
      Instrução ou prompt padrão dado ao agente.
    </ResponseField>

    <ResponseField name="tags" type="array of string">
      Lista de tags associadas ao agente.
    </ResponseField>

    <ResponseField name="hasVoice" type="boolean" required>
      Indica se o agente suporta voz.
    </ResponseField>

    <ResponseField name="isAdvancedBot" type="boolean" required>
      Indica se o agente utiliza configuração avançada de IA.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="visualIcon" type="File" required>
  <Expandable title="properties">
    <ResponseField name="id" type="uuid" required>
      Identificador do arquivo visual.
    </ResponseField>

    <ResponseField name="type" type="string" required>
      Tipo do arquivo.
    </ResponseField>

    <ResponseField name="url" type="string" required>
      URL pública para acessar o ícone.
    </ResponseField>

    <ResponseField name="fileName" type="string" required>
      Nome do arquivo armazenado.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="voiceCredential" type="Credential" required>
  <Expandable title="properties">
    <ResponseField name="id" type="uuid" required>
      Identificador da credencial.
    </ResponseField>

    <ResponseField name="name" type="string" required>
      Nome da credencial.
    </ResponseField>

    <ResponseField name="integrationId" type="uuid" required>
      ID da integração vinculada ao provedor de voz.
    </ResponseField>

    <ResponseField name="status" type="boolean" required>
      Status da credencial.
    </ResponseField>

    <ResponseField name="integration" type="Integration" required>
      <Expandable title="properties">
        <ResponseField name="name" type="string" required>
          Nome da integração.
        </ResponseField>

        <ResponseField name="type" type="string" required>
          Tipo da integração.
        </ResponseField>

        <ResponseField name="status" type="boolean" required>
          Indica se a integração está ativa.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>

  <ResponseField name="transcriptionCredential" type="uuid">
    ID da credencial para serviço de transcrição (opcional).
  </ResponseField>

  <ResponseField name="voicePrompt" type="string">
    Configuração opcional de como o seu agente de voz deve se comportar durante a chamada.
  </ResponseField>
</ResponseField>

## Segurança

Para acessar este endpoint, é necessário enviar um **token de acesso** válido através do cabeçalho de autorização (Authorization) da requisição. Além disso, a API é protegida por outras medidas de segurança para proteger os dados dos usuários.
