> ## Documentation Index
> Fetch the complete documentation index at: https://doc.omnitechsolucoes.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar ferramentas de uso durante a chamada

> Lista todas as ferramentas de uso durante a chamada disponíveis na conta OmniTech, com paginação e detalhes de configuração de cada integração.

Este endpoint permite recuperar todas as ferramentas de uso durante a chamada. As ferramentas de mid call permitem que seus assistentes de IA interajam com APIs externas durante uma ligação.

### Headers

<ParamField header="Authorization" type="string" required>
  Token Bearer para autenticação
</ParamField>

<ParamField header="Content-Type" type="string" required>
  Deve ser `application/json`
</ParamField>

<ParamField header="Accept" type="string" required>
  Deve ser `application/json`
</ParamField>

### Campos da Resposta

<ResponseField name="data" type="array">
  Array de ferramentas de uso durante a chamada

  <Expandable title="propriedades">
    <ResponseField name="id" type="integer">
      Identificador único da ferramenta
    </ResponseField>

    <ResponseField name="name" type="string">
      Nome da ferramenta (minúsculas com underscore)
    </ResponseField>

    <ResponseField name="description" type="string">
      Explicação detalhada de quando e como a IA deve utilizar esta ferramenta
    </ResponseField>

    <ResponseField name="endpoint" type="string">
      URL do endpoint da API que será chamado
    </ResponseField>

    <ResponseField name="method" type="string">
      Método HTTP (GET, POST, PUT, PATCH, DELETE)
    </ResponseField>

    <ResponseField name="timeout" type="integer">
      Timeout da requisição em segundos (1-30)
    </ResponseField>

    <ResponseField name="headers" type="array">
      Headers HTTP enviados na requisição

      <Expandable title="propriedades de headers">
        <ResponseField name="name" type="string">
          Nome do header
        </ResponseField>

        <ResponseField name="value" type="string">
          Valor do header
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="schema" type="array">
      Parâmetros que a IA irá extrair e enviar para o endpoint

      <Expandable title="propriedades de schema">
        <ResponseField name="name" type="string">
          Nome do parâmetro
        </ResponseField>

        <ResponseField name="type" type="string">
          Tipo do parâmetro (string, number, boolean)
        </ResponseField>

        <ResponseField name="description" type="string">
          Descrição para ajudar a IA a entender como extrair este parâmetro
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Timestamp ISO 8601 de criação da ferramenta
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Timestamp ISO 8601 da última atualização da ferramenta
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 Response theme={null}
  [
    {
      "id": 1,
      "name": "get_weather",
      "description": "Use esta ferramenta para obter o clima atual de uma cidade específica. Utilize quando o cliente perguntar sobre condições climáticas.",
      "endpoint": "https://api.openweathermap.org/data/2.5/weather",
      "method": "GET",
      "timeout": 10,
      "headers": [
        {
          "name": "Content-Type",
          "value": "application/json"
        },
        {
          "name": "Authorization",
          "value": "Bearer sk_..."
        }
      ],
      "schema": [
        {
          "name": "city",
          "type": "string",
          "description": "Nome da cidade para consulta do clima"
        },
        {
          "name": "temperature",
          "type": "number",
          "description": "Valor da temperatura atual"
        },
        {
          "name": "is_raining",
          "type": "boolean",
          "description": "Indica se está chovendo no momento"
        }
      ],
      "created_at": "2025-10-10T12:00:00.000000Z",
      "updated_at": "2025-10-10T12:00:00.000000Z"
    },
    {
      "id": 2,
      "name": "send_notification",
      "description": "Use esta ferramenta para enviar uma notificação ao cliente. Utilize quando o cliente solicitar atualizações.",
      "endpoint": "https://api.suaempresa.com/notifications/send",
      "method": "POST",
      "timeout": 15,
      "headers": [
        {
          "name": "Content-Type",
          "value": "application/json"
        }
      ],
      "schema": [
        {
          "name": "message",
          "type": "string",
          "description": "Mensagem da notificação a ser enviada"
        },
        {
          "name": "priority_level",
          "type": "number",
          "description": "Nível de prioridade de 1 a 5"
        },
        {
          "name": "send_sms",
          "type": "boolean",
          "description": "Indica se também deve enviar notificação por SMS"
        }
      ],
      "created_at": "2025-10-09T14:30:00.000000Z",
      "updated_at": "2025-10-10T09:15:00.000000Z"
    }
  ]
  ```
</ResponseExample>

Atribuindo Ferramentas aos Assistentes
Para utilizar estas ferramentas com assistentes, consulte:

Criar Assistente – Utilize o parâmetro tool\_ids para anexar ferramentas

Atualizar Assistente – Gerencie as atribuições de ferramentas utilizando o parâmetro tool\_ids