Gestion des utilisateurs
« user/list » - récupérer la liste des utilisateurs teambox
Permet de récupérer une liste des utilisateurs Teambox sur le serveur. Chaque enregistrement contient les champs suivants:
| Champ | Signification |
|---|---|
| userid | Identifiant de l'utilisateur |
| displayName | Nom en clair de l'utilisateur (nom + prénom) |
| extension | Numéro de poste (en 2XXX) de l'utilisateur |
| state | Etat de présence de l'utilisateur (voir l'évènement "user" pour plus de détail) |
| phoneState | Etat téléphonique |
| vmailCount | Nombre de messages vocaux non lus |
| phones[] | Liste des numéros de téléphone associés à cet utilisateur (cf plus bas). Cette liste inclut son numéro de mobile, ses numéros personnels et professionels, son numéro de poste, etc |
| ipphones[] | Liste des téléphones IP associés à l'utilisateur (généralement limitée à un seul téléphone). |
| features{} | Liste des fonctionnalités accessibles à l'utilisateur (cf plus bas) |
| callerIdNumbers[] | Liste de numéros de téléphones qu'il est possible d'utiliser pour identifier les appels sortants de cet utilisateur. |
phones[] : chaque numéro de téléphone associé à l'utilisateur est une structure contenant les champs suivants:
| Champ | Signification |
|---|---|
| number | Le numéro du téléphone |
| name | Un mot clé qui détermine le type de téléphone ("mobile", "work", "home", etc). |
| label | Un équivalent en clair du type de téléphone (ex: "Téléphone domicile") |
ipphones[] : chaque téléphone IP associé à l'utilisateur est une structure contenant les champs suivants:
| Champ | Signification |
|---|---|
| extension | Le numéro physique du téléphone (9XXX) |
| name | L'identifiant du téléphone (généralement phone-9XXX) |
| label | Un libellé décrivant le téléphone (ex: "Poste DECT") |
features{} : les fonctionnalités accessibles à chaque utilisateurs sont recensées dans ce champ « features », qui est un objet composite constitué des valeurs suivantes:
| Champ | Signification |
|---|---|
| presence | 1 si la gestion de présence est activée pour cet utilisateur (sinon 0) |
| telephony | 1 si cet utilisateur utilise la téléphonie (0 sinon) |
| callRecording | 1 si l'enregistrement de conversations est utilisable par cet utilisateur |
« user/info » - récupérer une fiche user
Cette requête permet de récupérer la fiche d'un user en particulier (ou de soi même).
| Parametre | Signification |
|---|---|
| userid | Identifiant du user. Quand cette valeur n'est pas spécifiée, le user courant est utilisé (celui qui est identifié via la connexion HTTP) |