Vai al contenuto

ExoVoIPManuale sviluppatori

Inoltro al cellulare

Le chiamate dirette a un interno possono raggiungere anche il cellulare dell'utente. Scope extensions:read / extensions:write.

Deviazione e modalità di inoltro

Deviazione sul cellulare (PUT /v1/extensions/:id/follow-me): numero, squilli prima dell'inoltro, modalità (insieme o in sequenza).
Modalità di inoltro (PUT /v1/extensions/:id/invisible-forwarding): come si presenta la chiamata sul cellulare.

curl -s -X PUT https://centralino.exovoip.it/api/v1/extensions/12/follow-me \
  -H "X-API-Key: $EXOPBX_API_KEY" -H "Content-Type: application/json" \
  -d '{"enabled":true,"number":"+393331234567","rings":3}'
curl -s -X PUT https://centralino.exovoip.it/api/v1/extensions/12/invisible-forwarding \
  -H "X-API-Key: $EXOPBX_API_KEY" -H "Content-Type: application/json" \
  -d '{"style":"whisper","whisperText":"Chiamata dal centralino"}'

await pbx.extensions.followMe(12, { enabled: true, number: '+393331234567', rings: 3 });
await pbx.forwarding.update(12, { style: 'whisper', whisperText: 'Chiamata dal centralino' });
const current = await pbx.forwarding.get(12);

$pbx->extensions->followMe(12, ['enabled' => true, 'number' => '+393331234567', 'rings' => 3]);
$pbx->forwarding->update(12, ['style' => 'whisper', 'whisperText' => 'Chiamata dal centralino']);

pbx.extensions.follow_me(12, {"enabled": True, "number": "+393331234567", "rings": 3})
pbx.forwarding.update(12, {"style": "whisper", "whisperText": "Chiamata dal centralino"})

`style`	Comportamento
`confirm`	Predefinita. L'utente sente un messaggio e preme un tasto per accettare: così una chiamata finita nella segreteria del cellulare non viene considerata risposta
`silent`	La chiamata viene collegata appena il cellulare risponde; `silentTimeoutS` è il tempo di squillo verso il cellulare
`whisper`	Prima del collegamento l'utente ascolta un breve annuncio (`whisperText`, dove `{caller}` è il nome in rubrica o il numero, oppure `whisperPromptId`)

I numeri esterni devono rispettare la politica dell'azienda sulle destinazioni consentite (vedi Regole di uscita).

Deviazione presso l'operatore (piattaforma)

GET/PUT /v1/extensions/:id/provider-divert gestisce la deviazione configurata direttamente presso l'operatore telefonico: riservata alle chiavi globali.

Endpoint

Descrizione	Richiesta	Scope	Metodo SDK
Modalità di inoltro al cellulare	`GET /v1/extensions/:id/invisible-forwarding`	`extensions:read`	`forwarding.get()`
Imposta conferma / silenziosa / sussurro	`PUT /v1/extensions/:id/invisible-forwarding`	`extensions:write`	`forwarding.update()`
Deviazione presso il provider (solo Exobyte)	`GET /v1/extensions/:id/provider-divert`	`tenants:write`	`forwarding.getProviderDivert() · py: forwarding.get_provider_divert()`
Imposta deviazione presso il provider (solo Exobyte)	`PUT /v1/extensions/:id/provider-divert`	`tenants:write`	`forwarding.setProviderDivert() · py: forwarding.set_provider_divert()`