Vai al contenuto

ExoVoIPManuale sviluppatori

Gruppi di squillo

Un gruppo fa squillare più interni (e numeri esterni) insieme o in sequenza. Scope ring_groups:read / ring_groups:write.

Creare un gruppo

curl -s -X POST https://centralino.exovoip.it/api/v1/ring-groups \
  -H "X-API-Key: $EXOPBX_API_KEY" -H "Content-Type: application/json" \
  -d '{"number":"600","name":"Assistenza","strategy":"simultaneous","ringTimeS":25,
       "memberExtensionIds":[12,13,14],"failoverDestination":{"type":"voicemail","extensionId":12}}'

await pbx.ringGroups.create({
  number: '600',
  name: 'Assistenza',
  strategy: 'simultaneous',
  ringTimeS: 25,
  memberExtensionIds: [12, 13, 14],
  failoverDestination: { type: 'voicemail', extensionId: 12 },
});

$pbx->ringGroups->create([
    'number' => '600',
    'name' => 'Assistenza',
    'strategy' => 'simultaneous',
    'ringTimeS' => 25,
    'memberExtensionIds' => [12, 13, 14],
    'failoverDestination' => ['type' => 'voicemail', 'extensionId' => 12],
]);

pbx.ring_groups.create({
    "number": "600",
    "name": "Assistenza",
    "strategy": "simultaneous",
    "ringTimeS": 25,
    "memberExtensionIds": [12, 13, 14],
    "failoverDestination": {"type": "voicemail", "extensionId": 12},
})

Campo	Descrizione
`number`	Numero breve del gruppo (componibile dagli interni)
`strategy`	`simultaneous` (tutti insieme) o `sequential` (uno alla volta)
`ringTimeS`, `memberRingS`	Durata totale dello squillo e, in sequenza, per ogni membro
`memberExtensionIds`, `externalNumbers`	Interni e numeri esterni del gruppo
`skipBusy`	Salta gli interni già al telefono
`callerHears`	Il chiamante sente lo squillo (`ring`) o la musica d'attesa (`moh`)
`failoverDestination`	Dove va la chiamata se nessuno risponde

Per distribuire le chiamate tra operatori con attesa e annunci usa invece le code.

Endpoint

Descrizione	Richiesta	Scope	Metodo SDK
Gruppi di squillo	`GET /v1/ring-groups`	`ring_groups:read`	`ringGroups.list() · py: ring_groups.list()`
Crea gruppo di squillo	`POST /v1/ring-groups`	`ring_groups:write`	`ringGroups.create() · py: ring_groups.create()`
Dettaglio gruppo	`GET /v1/ring-groups/:id`	`ring_groups:read`	`ringGroups.get() · py: ring_groups.get()`
Modifica gruppo	`PATCH /v1/ring-groups/:id`	`ring_groups:write`	`ringGroups.update() · py: ring_groups.update()`
Elimina gruppo (IN_USE se usato)	`DELETE /v1/ring-groups/:id`	`ring_groups:write`	`ringGroups.delete() · py: ring_groups.delete()`