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

# Chamada de API

## Token de Acesso

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

<ParamField path="bot-id" type="string">
  ID do Agente
</ParamField>

<ParamField body="phone" type="string" required>
  Telefone para chamada
</ParamField>

<ParamField body="language" type="string">
  Idioma do agente
</ParamField>

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

<ParamField body="credentialId" type="string">
  ID da credencial de voz
</ParamField>

<ParamField body="model" type="string">
  Modelo do provedor de voz
</ParamField>

<ParamField body="firstMessage" type="string">
  Primeira interação da voz com o usuário
</ParamField>

<ParamField body="prompt" type="string">
  Prompt simples da voz
</ParamField>

## Descrição da Resposta

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

<ResponseField name="message" type="string" required>
  Mensagem de status da resposta da API.
</ResponseField>

<ResponseField name="response" type="object" required>
  <Expandable title="properties">
    <ResponseField name="message" type="string" required>
      Mensagem de confirmação do serviço SIP.
    </ResponseField>

    <ResponseField name="roomName" type="string" required>
      Nome da sala em que o participante SIP foi criado.
    </ResponseField>

    <ResponseField name="participantIdentity" type="string" required>
      Identidade atribuída ao participante SIP.
    </ResponseField>

    <ResponseField name="status" type="boolean" required>
      Indica se a criação do participante SIP foi bem-sucedida.
    </ResponseField>
  </Expandable>
</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.