Les équipes représentent un groupe auquel un agent peut être affecté, puis à une file d'attente. Chaque objet représente une seule équipe.
Il existe trois points de terminaison pour les équipes :
/team: extrait la liste des équipes./team/tree: extrait les équipes dans une arborescence./team/{:id}: extrait une seule ressource d'équipe.
Examinez le modèle suivant pour déterminer quels champs peuvent contenir des informations permettant d'identifier personnellement l'utilisateur.
[
{
"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"
}
}
]
Liste "Équipe"
| Paramètre | Obligatoire | Type de données | Définition |
|---|---|---|---|
| sort_column | FALSE | Chaîne | Trie la réponse en fonction de n'importe quel champ de l'objet de réponse. |
| sort_direction | FALSE | ASC ou DESC | Indique le sens du tri (croissant ou décroissant). |
| page | FALSE | Chaîne | Associé à "par" pour indiquer la page des enregistrements. Par exemple, si "per" est défini sur 200 et "page" sur 2, la réponse contiendra les enregistrements 201 à 400, car la page 1 contiendra les enregistrements 1 à 200. |
| par | FALSE | Chaîne | Associez-le à la page pour indiquer le nombre d'enregistrements à inclure sur une page d'enregistrements. Par exemple, si "per" est défini sur 200 et "page" sur 2, la réponse contiendra les enregistrements 201 à 400, car la page 1 contiendra les enregistrements 1 à 200. |
| agents_count[from] | FALSE | Nombre | crée une limite inférieure pour le champ du nombre d'agents. Tous les enregistrements renvoyés seront postérieurs à la valeur saisie. |
| agents_count[to] | FALSE | Nombre | crée une limite supérieure pour le champ du nombre d'agents. Tous les enregistrements renvoyés seront antérieurs à la valeur saisie. |
| id[] | FALSE | Tableau[Chaîne] | Array[Strings]. ID des enregistrements à rechercher et à renvoyer |
| name[] | FALSE | Tableau[Chaîne] | Renvoie les enregistrements en fonction du nom de la ressource. |
| parent_id[] | FALSE | Tableau[Chaîne] | Renvoie les enregistrements en fonction de l'ID parent des enregistrements donnés. |
| position[] | FALSE | Tableau[Chaîne] | Renvoie les enregistrements en fonction de la position d'un menu. |
| with_deleted | FALSE | Booléen | Renvoie les enregistrements qui ont été supprimés (True) ou non, y compris ceux qui ont été supprimés (False). |
Point de terminaison :
Method: GET
Type:
URL: https://{{subdomain}}.{{domain}}/manager/api/v1/teams
Autres exemples de requêtes/réponses :
Exemple de requête : Liste des équipes
Corps : aucun
Exemple de réponse : liste des équipes
[
{
"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"
}
]
}
]
Code d'état : 200
Équipe unique
| Paramètre | Obligatoire | Type de données | Définition |
|---|---|---|---|
| record_id | FALSE | Chaîne | Renvoie un enregistrement spécifique en fonction de l'ID. |
| with_deleted | FALSE | Booléen | Renvoie les enregistrements qui ont été supprimés (True) ou non, y compris ceux qui ont été supprimés (False). |
Point de terminaison :
Method: GET
Type:
URL: https://{{subdomain}}.{{domain}}/manager/api/v1/teams/{{team_id}}
Autres exemples de requêtes/réponses :
Exemple de requête : équipe unique
Corps : aucun
Exemple de réponse : équipe unique
{
"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"
}
]
}
Code d'état : 200
Arborescence de l'équipe
Point de terminaison :
Method: GET
Type:
URL: https://{{subdomain}}.{{domain}}/manager/api/v1/teams/tree
Autres exemples de requêtes/réponses :
Exemple de requête : Arborescence de l'équipe
Corps : aucun
Exemple de réponse : arbre de l'équipe
[
{
"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": []
}
]
}
]
Code d'état : 200