Extremos del equipo

Los equipos representan una agrupación a la que se puede asignar un agente, que luego se puede asignar a una cola. Cada objeto representa un solo equipo.

Existen tres extremos de equipo:

• /team : Recupera una lista de equipos.

• /team/tree : Recupera equipos en una estructura de árbol.

• /team/{:id} : Recupera un solo recurso de equipo.

Revisa el siguiente modelo para determinar qué campos podrían contener PII.

[
  {
    "id": 0,
    "name": "string",
    "parent_id": 0,
    "position": 0,
    "deleted": true,
    "agents_count": 0,
    "assignees": {
      "id": 0,
      "name": "string", // This may be considered PII
      "last_name": "string", // This may be considered PII
      "first_name": "string", // This may be considered PII
      "agent_number": "string", // This may be considered PII
      "avatar_url": "string"
    }
  }
]

Lista del equipo

Parámetro	Obligatorio	Tipo de datos	Definición
sort_column	FALSO	String	Ordena la respuesta según cualquier campo del objeto de respuesta.
sort_direction	FALSO	ASC o DESC	Indica la dirección de la clasificación, ya sea ascendente o descendente.
página	FALSO	String	Se combina con per para indicar qué página de registros. Por ejemplo, si per se establece en 200 y la página es 2, la respuesta contendrá los registros 201-400, ya que la página 1 contendrá 1-200.
por	FALSO	String	Se combina con la página para indicar cuántos registros se incluirán en una página de registros. Por ejemplo, si per se establece en 200 y la página es 2, la respuesta contendrá los registros 201-400, ya que la página 1 contendrá 1-200.
agents_count[from]	FALSO	Número	Crea un límite inferior del campo de recuento de agentes. Todos los registros que se muestran estarán después del valor ingresado.
agents_count[to]	FALSO	Número	Crea un límite superior del campo de recuento de agentes. Todos los registros que se muestran estarán antes del valor ingresado.
id[]	FALSO	Array[String]	Array[Strings]. Es el ID de los registros que se deben buscar y mostrar.
name[]	FALSO	Array[String]	Muestra registros según el nombre del recurso.
parent_id[]	FALSO	Array[String]	Muestra registros según el ID superior de los registros determinados.
position[]	FALSO	Array[String]	Muestra registros según la posición en la que se encuentra un menú.
with_deleted	FALSO	Booleano	Muestra los registros que se borraron (True) o no incluye los registros que se borraron (False).

Extremo:

Method: GET
Type: 
URL: https://{​{subdomain}​}.{​{domain}​}/manager/api/v1/teams

Más ejemplos de solicitudes y respuestas:

Ejemplo de solicitud: Lista del equipo

Cuerpo: Ninguno

Ejemplo de respuesta: Lista del equipo

[
  {
    "id": 11,
    "name": "Forest Moon of Endor Team",
    "parent_id": null,
    "position": 28,
    "agents_count": 3,
    "deleted": false,
    "assignees": [
      {
        "id": 19,
        "agent_number": "77",
        "name": "Storm Trooper 1",
        "last_name": "Storm",
        "first_name": "Trooper 1"
      },
      {
        "id": 20,
        "agent_number": "78",
        "name": "Storm Trooper 2",
        "last_name": "Storm",
        "first_name": "Trooper 2"
      },
      {
        "id": 21,
        "agent_number": "79",
        "name": "Storm Trooper 3",
        "last_name": "Storm",
        "first_name": "Trooper 3"
      }
    ]
  },
  {
    "id": 12,
    "name": "Death Star Team",
    "parent_id": null,
    "position": 28,
    "agents_count": 3,
    "deleted": false,
    "assignees": [
      {
        "id": 34,
        "agent_number": "80",
        "name": "Storm Trooper 5",
        "last_name": "Storm",
        "first_name": "Trooper 5"
      },
      {
        "id": 35,
        "agent_number": "81",
        "name": "Storm Trooper 6",
        "last_name": "Storm",
        "first_name": "Trooper 6"
      },
      {
        "id": 36,
        "agent_number": "82",
        "name": "Storm Trooper 7",
        "last_name": "Storm",
        "first_name": "Trooper 7"
      }
    ]
  }
]

Código de estado: 200

Equipo único

Parámetro	Obligatorio	Tipo de datos	Definición
record_id	FALSO	String	Muestra un registro específico según el ID.
with_deleted	FALSO	Booleano	Muestra los registros que se borraron (True) o no incluye los registros que se borraron (False).

Extremo:

Method: GET
Type: 
URL: https://{​{subdomain}​}.{​{domain}​}/manager/api/v1/teams/{​{team_id}​}

Más ejemplos de solicitudes y respuestas:

Ejemplo de solicitud: Equipo único

Cuerpo: Ninguno

Ejemplo de respuesta: Equipo único

    {
        "id": 11,
        "name": "Forest Moon of Endor Team",
        "parent_id": null,
        "position": 28,
        "agents_count": 3,
        "deleted": false,
        "assignees": [
            {
                "id": 19,
                "agent_number": "77",
                "name": "Storm Trooper 1",
                "last_name": "Storm",
                "first_name": "Trooper 1"
            },
            {
                "id": 20,
                "agent_number": "78",
                "name": "Storm Trooper 2",
                "last_name": "Storm",
                "first_name": "Trooper 2"
            },
            {
                "id": 21,
                "agent_number": "79",
                "name": "Storm Trooper 3",
                "last_name": "Storm",
                "first_name": "Trooper 3"
            }
        ]
    }

Código de estado: 200

Árbol de equipos

Extremo:

Method: GET
Type: 
URL: https://{​{subdomain}​}.{​{domain}​}/manager/api/v1/teams/tree

Más ejemplos de solicitudes y respuestas:

Ejemplo de solicitud: Árbol de equipos

Cuerpo: Ninguno

Ejemplo de respuesta: Árbol de equipos

[
  {
    "id": 147,
    "name": "Storm Trooper Reigment",
    "parent_id": null,
    "position": 1,
    "agents_count": 9,
    "deleted": false,
    "children": [
      {
        "id": 34,
        "name": "Storm Trooper 1st Regiment",
        "parent_id": 147,
        "position": 1,
        "agents_count": 2,
        "deleted": false,
        "children": []
      }
    ]
  }
]

Código de estado: 200