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

# Obter os agentes da sua empresa

> Devolve os agentes da sua conta que podem receber conversas. Use-o para conhecer o `email` e o `id` de cada agente, que são os valores que você deve devolver do seu endpoint quando usa o destino **API** do bloco de Métodos de transferência.

Apenas os agentes **ativos** são devolvidos, portanto qualquer agente da resposta pode receber uma conversa.

Este endpoint vive no host da plataforma de agentes, `agent-api.treble.ai`, e não em `main.treble.ai`.



## OpenAPI

````yaml open-api-files/treble-api-pt.json GET /agent/company/agents
openapi: 3.0.1
info:
  title: API do Treble Poll
  description: Documentação para o endpoint de implantação de polls no Treble
  version: 1.0.0
servers:
  - url: https://main.treble.ai
    description: Servidor principal do Treble
  - url: https://seudominio.com
    description: >-
      Servidor de exemplo para implementar os webhooks. Isso representa SEU
      servidor onde você deve implementar os endpoints que o Treble chamará.
security: []
tags:
  - name: Webhooks
    description: >-
      Endpoints que o Treble chamará no seu servidor. Estes não são endpoints
      reais que você possa chamar, mas uma representação dos webhooks que o
      Treble invocará no seu sistema.
paths:
  /agent/company/agents:
    get:
      summary: Obter os agentes da sua empresa
      description: >-
        Devolve os agentes da sua conta que podem receber conversas. Use-o para
        conhecer o `email` e o `id` de cada agente, que são os valores que você
        deve devolver do seu endpoint quando usa o destino **API** do bloco de
        Métodos de transferência.


        Apenas os agentes **ativos** são devolvidos, portanto qualquer agente da
        resposta pode receber uma conversa.


        Este endpoint vive no host da plataforma de agentes,
        `agent-api.treble.ai`, e não em `main.treble.ai`.
      parameters:
        - name: Authorization
          in: header
          required: true
          description: >-
            API Key de autorização. Pode ser obtida em
            https://app.treble.ai/pt/dashboard/settings/developers
          schema:
            type: string
          example: API_KEY
      responses:
        '200':
          description: Lista de agentes obtida corretamente
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Agent'
              example:
                - id: 4567
                  first_name: Andrea
                  last_name: Soto
                  email: andrea.soto@suaempresa.com
                  tags:
                    - id: 12
                      name: Default
                    - id: 18
                      name: Comercial
      servers:
        - url: https://agent-api.treble.ai
          description: Host da plataforma de agentes do Treble
components:
  schemas:
    Agent:
      type: object
      description: Agente da sua conta que pode receber conversas.
      properties:
        id:
          type: integer
          description: Identificador do agente no Treble.
          example: 4567
        first_name:
          type: string
          description: Nome do agente.
          example: Andrea
        last_name:
          type: string
          description: Sobrenome do agente.
          example: Soto
        email:
          type: string
          description: >-
            Email do agente. É o valor recomendado para devolver do seu endpoint
            de atribuição.
          example: andrea.soto@suaempresa.com
        tags:
          type: array
          description: Equipes às quais o agente pertence.
          items:
            $ref: '#/components/schemas/AgentTag'
    AgentTag:
      type: object
      description: Equipe (tag) à qual o agente pertence.
      properties:
        id:
          type: integer
          description: Identificador da equipe.
          example: 12
        name:
          type: string
          description: Nome da equipe.
          example: Default

````