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

# Listar assistentes

> Lista todos os assistentes do usuário autenticado com paginação.

Este endpoint permite recuperar todos os assistentes de IA pertencentes ao usuário autenticado.

### Parâmetros de Consulta

<ParamField query="per_page" type="integer" optional>
  Número de assistentes por página (1-100, padrão: 10)
</ParamField>

<ParamField query="page" type="integer" optional>
  Número da página (padrão: 1)
</ParamField>

### Campos de Resposta

<ResponseField name="data" type="array">
  <Expandable title="properties">
    <ResponseField name="id" type="integer">
      O identificador único do assistente
    </ResponseField>

    <ResponseField name="user_id" type="integer">
      O ID do usuário que possui este assistente
    </ResponseField>

    <ResponseField name="phone_number_id" type="integer">
      O ID do número de telefone atribuído ao assistente
    </ResponseField>

    <ResponseField name="engine_id" type="integer">
      ID do motor
    </ResponseField>

    <ResponseField name="synthesizer_id" type="integer">
      ID do sintetizador
    </ResponseField>

    <ResponseField name="transcriber_id" type="integer">
      ID do transcritor
    </ResponseField>

    <ResponseField name="voice_id" type="integer">
      O ID da voz usada pelo assistente
    </ResponseField>

    <ResponseField name="instance_id" type="integer">
      O ID da instância do assistente
    </ResponseField>

    <ResponseField name="name" type="string">
      O nome do assistente
    </ResponseField>

    <ResponseField name="variables" type="object">
      Variáveis personalizadas definidas para o assistente
    </ResponseField>

    <ResponseField name="post_call_evaluation" type="boolean">
      Se a avaliação pós-chamada está habilitada
    </ResponseField>

    <ResponseField name="fillers" type="integer">
      Se o áudio de preenchimento está habilitado (1 = habilitado, 0 = desabilitado)
    </ResponseField>

    <ResponseField name="post_call_schema" type="array">
      Definição de esquema para extração de dados pós-chamada

      <Expandable title="post_call_schema properties">
        <ResponseField name="name" type="string">
          O nome do campo do esquema
        </ResponseField>

        <ResponseField name="type" type="string">
          O tipo de dados (string, number, bool)
        </ResponseField>

        <ResponseField name="description" type="string">
          Descrição do que este campo representa
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="tools" type="array">
      Array de ferramentas disponíveis para o assistente
    </ResponseField>

    <ResponseField name="is_webhook_active" type="boolean">
      Se as notificações por webhook estão habilitadas
    </ResponseField>

    <ResponseField name="webhook_url" type="string">
      A URL do webhook para notificações pós-chamada
    </ResponseField>

    <ResponseField name="inbound_webhook_url" type="string">
      A URL do webhook para notificações de chamadas de entrada
    </ResponseField>

    <ResponseField name="language" type="string">
      Idioma
    </ResponseField>

    <ResponseField name="type" type="string">
      O tipo de assistente (inbound ou outbound)
    </ResponseField>

    <ResponseField name="status" type="string">
      O status atual do assistente (active ou inactive)
    </ResponseField>

    <ResponseField name="max_duration" type="integer">
      Duração máxima da chamada em segundos
    </ResponseField>

    <ResponseField name="record" type="boolean">
      Se deve gravar chamadas
    </ResponseField>

    <ResponseField name="initial_message" type="string">
      A mensagem inicial que o assistente falará
    </ResponseField>

    <ResponseField name="system_prompt" type="string">
      O prompt do sistema que define o comportamento do assistente
    </ResponseField>

    <ResponseField name="flows_platform_id" type="integer">
      ID para integração com a plataforma de fluxos
    </ResponseField>

    <ResponseField name="timezone" type="string">
      A configuração de fuso horário do assistente
    </ResponseField>

    <ResponseField name="created_at" type="string">
      A data e hora em que o assistente foi criado
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      A data e hora da última atualização do assistente
    </ResponseField>

    <ResponseField name="max_silence_duration" type="integer">
      Duração máxima de silêncio em segundos antes do reengajamento
    </ResponseField>

    <ResponseField name="reengagement_interval" type="integer">
      Intervalo de reengajamento em segundos
    </ResponseField>

    <ResponseField name="deleted_at" type="string">
      Timestamp de exclusão suave (null se não excluído)
    </ResponseField>

    <ResponseField name="end_call_on_voicemail" type="integer">
      Se deve encerrar a chamada quando caixa postal é detectada (1 = sim, 0 = não)
    </ResponseField>

    <ResponseField name="llm_temperature" type="string">
      Configuração de temperatura do LLM como string
    </ResponseField>

    <ResponseField name="voice_stability" type="string">
      Configuração de estabilidade da voz como string
    </ResponseField>

    <ResponseField name="voice_similarity" type="string">
      Configuração de similaridade da voz como string
    </ResponseField>

    <ResponseField name="allow_interruptions" type="boolean">
      Se permite interrupções do chamador
    </ResponseField>

    <ResponseField name="enable_noise_cancellation" type="boolean">
      Se o cancelamento de ruído está habilitado
    </ResponseField>

    <ResponseField name="endpoint_sensitivity" type="number">
      Nível de sensibilidade do endpoint
    </ResponseField>

    <ResponseField name="speech_speed" type="string">
      Multiplicador de velocidade da fala como string
    </ResponseField>

    <ResponseField name="endpoint_type" type="string">
      Tipo de detecção de atividade de voz (vad ou ai)
    </ResponseField>

    <ResponseField name="wait_for_customer" type="boolean">
      Se deve aguardar o cliente falar primeiro
    </ResponseField>

    <ResponseField name="mode" type="string">
      O modo do motor (pipeline ou multimodal)
    </ResponseField>

    <ResponseField name="language_id" type="integer">
      O ID do idioma usado pelo assistente
    </ResponseField>

    <ResponseField name="transcriber_provider_id" type="integer">
      ID do provedor de transcrição
    </ResponseField>

    <ResponseField name="synthesizer_provider_id" type="integer">
      ID do provedor de síntese
    </ResponseField>

    <ResponseField name="llm_model_id" type="integer">
      ID do modelo LLM usado
    </ResponseField>

    <ResponseField name="multimodal_model_id" type="integer">
      ID do modelo multimodal usado
    </ResponseField>

    <ResponseField name="ambient_sound" type="string">
      Configuração de som ambiente
    </ResponseField>

    <ResponseField name="uuid" type="string">
      UUID único do assistente
    </ResponseField>

    <ResponseField name="send_webhook_only_on_completed" type="boolean">
      Se deve enviar webhooks apenas em chamadas concluídas
    </ResponseField>

    <ResponseField name="include_recording_in_webhook" type="boolean">
      Se deve incluir URL de gravação no payload do webhook
    </ResponseField>

    <ResponseField name="interrupt_sensitivity" type="number">
      Nível de sensibilidade de interrupção
    </ResponseField>

    <ResponseField name="filler_config" type="object">
      Configuração para respostas de áudio de preenchimento

      <Expandable title="filler_config properties">
        <ResponseField name="neutral" type="array">
          Array de respostas de preenchimento neutras
        </ResponseField>

        <ResponseField name="negative" type="array">
          Array de respostas de preenchimento negativas
        </ResponseField>

        <ResponseField name="positive" type="array">
          Array de respostas de preenchimento positivas
        </ResponseField>

        <ResponseField name="question" type="array">
          Array de respostas de preenchimento para perguntas
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="knowledgebase_id" type="integer">
      ID da base de conhecimento associada
    </ResponseField>

    <ResponseField name="knowledgebase_mode" type="string">
      Configuração do modo da base de conhecimento
    </ResponseField>

    <ResponseField name="min_interrupt_words" type="integer">
      Número mínimo de palavras antes que a interrupção seja permitida
    </ResponseField>

    <ResponseField name="ambient_sound_volume" type="string">
      Nível de volume do som ambiente como string
    </ResponseField>

    <ResponseField name="widget_settings" type="object">
      Configurações para integração com widget web
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="current_page" type="integer">
  O número da página atual
</ResponseField>

<ResponseField name="per_page" type="integer">
  Número de itens por página
</ResponseField>

<ResponseField name="total" type="integer">
  Número total de assistentes
</ResponseField>

<ResponseField name="last_page" type="integer">
  O número da última página
</ResponseField>

<ResponseExample>
  ```json 200 Response theme={null}
  {
    "current_page": 1,
    "data": [
      {
        "id": 127,
        "user_id": 1,
        "phone_number_id": 45,
        "engine_id": null,
        "synthesizer_id": null,
        "transcriber_id": null,
        "voice_id": 8,
        "instance_id": 1,
        "name": "Sales Outreach Assistant",
        "variables": {
          "company_name": "Your Company",
          "product_line": "Premium Services",
          "rep_name": "Assistant"
        },
        "post_call_evaluation": true,
        "fillers": 1,
        "post_call_schema": [
          {
            "name": "interest_level",
            "type": "string",
            "description": "Customer's level of interest (high, medium, low)"
          },
          {
            "name": "budget_qualified",
            "type": "bool",
            "description": "Whether the prospect has adequate budget"
          },
          {
            "name": "follow_up_date",
            "type": "string",
            "description": "Preferred date for follow-up contact"
          }
        ],
        "tools": [],
        "is_webhook_active": true,
        "webhook_url": "https://yourcompany.com/api/webhooks/sales-calls",
        "inbound_webhook_url": null,
        "language": null,
        "type": "outbound",
        "status": "active",
        "max_duration": 900,
        "record": true,
        "initial_message": "Hi, this is an assistant from Your Company. I hope I'm catching you at a good time. How are you doing today?",
        "system_prompt": "You are a sales representative for Your Company. Be professional, friendly, and focus on qualifying leads for premium services.",
        "flows_platform_id": null,
        "timezone": "America/Los_Angeles",
        "created_at": "2025-07-15T14:32:15.000000Z",
        "updated_at": "2025-08-02T09:18:42.000000Z",
        "max_silence_duration": 25,
        "reengagement_interval": 45,
        "deleted_at": null,
        "end_call_on_voicemail": 1,
        "llm_temperature": "0.35",
        "voice_stability": "0.75",
        "voice_similarity": "0.85",
        "allow_interruptions": true,
        "enable_noise_cancellation": true,
        "endpoint_sensitivity": 1.8,
        "speech_speed": "1.10",
        "endpoint_type": "vad",
        "wait_for_customer": true,
        "mode": "pipeline",
        "language_id": 1,
        "transcriber_provider_id": null,
        "synthesizer_provider_id": null,
        "llm_model_id": 3,
        "multimodal_model_id": null,
        "ambient_sound": "office",
        "uuid": "a7b3c942-5f1e-4d28-8c59-2e4f7a8b9c3d",
        "send_webhook_only_on_completed": true,
        "include_recording_in_webhook": true,
        "interrupt_sensitivity": 1.2,
        "filler_config": {
          "neutral": [
            "I see.",
            "Understood.",
            "Right.",
            "Got it.",
            "Okay."
          ],
          "negative": [
            "I understand.",
            "Hmm.",
            "I see.",
            "Okay."
          ],
          "positive": [
            "Excellent!",
            "That's great!",
            "Wonderful!",
            "Perfect!"
          ],
          "question": [
            "Let me think...",
            "Good question.",
            "Hmm.",
            "Right."
          ]
        },
        "knowledgebase_id": 12,
        "knowledgebase_mode": "hybrid",
        "min_interrupt_words": 3,
        "ambient_sound_volume": "0.30",
        "widget_settings": {
          "theme": "modern",
          "color": "#2563eb",
          "position": "bottom-right"
        }
      }
    ],
    "first_page_url": "https://suasofia.online/api/user/assistants/get?page=1",
    "from": 1,
    "last_page": 5,
    "last_page_url": "https://suasofia.online/api/user/assistants/get?page=5",
    "links": [
      {
        "url": null,
        "label": "&laquo; Previous",
        "active": false
      },
      {
        "url": "https://suasofia.online/api/user/assistants/get?page=1",
        "label": "1",
        "active": true
      },
      {
        "url": "https://suasofia.online/api/user/assistants/get?page=2",
        "label": "2",
        "active": false
      }
    ],
    "next_page_url": "https://suasofia.online/api/user/assistants/get?page=2",
    "path": "https://suasofia.online/api/user/assistants/get",
    "per_page": 10,
    "prev_page_url": null,
    "to": 10,
    "total": 47
  }
  ```
</ResponseExample>
