Vai al contenuto

ExoVoIPManuale sviluppatori

Musica d'attesa

Le classi di musica d'attesa definiscono cosa ascolta il chiamante in coda, in attesa o durante un trasferimento: brani e annunci periodici. Scope media:read / media:write.

Creare una classe

curl -s -X POST https://centralino.exovoip.it/api/v1/moh \
  -H "X-API-Key: $EXOPBX_API_KEY" -H "Content-Type: application/json" \
  -d '{"name":"Musica aziendale","source":"upload","trackPromptIds":[41,42],"shuffle":true,
       "announcePromptIds":[43],"announceEveryS":45}'

await pbx.moh.create({
  name: 'Musica aziendale',
  source: 'upload',
  trackPromptIds: [41, 42],
  shuffle: true,
  announcePromptIds: [43],
  announceEveryS: 45,
});

$pbx->moh->create([
    'name' => 'Musica aziendale',
    'source' => 'upload',
    'trackPromptIds' => [41, 42],
    'shuffle' => true,
    'announcePromptIds' => [43],
    'announceEveryS' => 45,
]);

pbx.moh.create({
    "name": "Musica aziendale",
    "source": "upload",
    "trackPromptIds": [41, 42],
    "shuffle": True,
    "announcePromptIds": [43],
    "announceEveryS": 45,
})

Campo	Descrizione
`source`	`exobyte` (raccolta Exobyte), `library`, `upload` (brani caricati), `ai`
`trackPromptIds`	Brani caricati, in ordine (messaggi vocali di tipo `moh`)
`shuffle`	Riproduzione casuale
`announcePromptIds`, `announceEveryS`	Annunci inseriti tra i brani e intervallo
`isDefault`	Classe predefinita dell'azienda

I brani si caricano come messaggi vocali con kind: "moh". La classe si usa nelle code e nei gruppi di squillo (mohClassId).

Endpoint

Descrizione	Richiesta	Scope	Metodo SDK
Classi musica d’attesa (azienda + Exobyte)	`GET /v1/moh`	`media:read`	`moh.list()`
Crea classe musica d’attesa	`POST /v1/moh`	`media:write`	`moh.create()`
Dettaglio classe	`GET /v1/moh/:id`	`media:read`	`moh.get()`
Modifica classe (tracce e annunci)	`PATCH /v1/moh/:id`	`media:write`	`moh.update()`
Elimina classe (IN_USE se usata)	`DELETE /v1/moh/:id`	`media:write`	`moh.delete()`