Messagerie vocale
Requête « vm/list » - récupère la liste des messages vocaux
Cette requête permet de récupérer la liste des enveloppes des messages vocaux de l'utilisateur. Par défaut, seul les messages non lus sont retournés.
| Parametre | Signification |
|---|---|
| voicemailbox |
Identification de la boite vocale à lire (si non spécifié, utilise la boite vocale personnelle de l'utilisateur).
Les possibilité de ce paramètre sont:
- userid - "global" - groupid |
En retour, la requête retourne une liste des messages (c'est une liste de tableaux associatifs; la liste peut être vide). Chaque élément (i.e. enveloppes de message) contient les champs suivants:
| Champ | Signification |
|---|---|
| voicemailbox | Identifiant de la boite vocale |
| messageId | Identifiant du message (qui permet de manipuler le message avec les autres fonctions de l'API comhub) |
| date | Date de dépos (epoch) |
| duration | Durée du message, en secondes |
| callerNumber | Numéro appelant de la personne qui a déposé le message |
| callerName | Nom de l'appelant (quand il existe dans le carnet d 'adresses) |
Note: les dépôts de message vocaux sont indiqués par l'expédition d'un évènement "user" qui contient le champ "vmailCount" indiquant le nombre de message vocaux non lus en attente.