App ExoVoIP
L'app ExoVoIP porta l'interno del centralino su smartphone, tablet e computer: stesso numero, stesse regole di chiamata e stessa rubrica, in ufficio, a casa o in viaggio. È disponibile per iPhone, iPad, Android, Mac e Windows ed è inclusa nel centralino, senza costi per dispositivo.
Come funziona
Ogni dispositivo collegato diventa un'estensione dell'interno:
- chi chiama compone sempre il numero aziendale e non sa da dove stai rispondendo;
- le chiamate in uscita mostrano il numero dell'interno e seguono gli stessi permessi;
- ogni dispositivo si collega e si scollega da solo, senza toccare i telefoni da scrivania.
Computer (Mac e Windows): l'app resta sempre connessa finché il computer è acceso e l'app è aperta, anche ridotta a icona nella barra dei menu o nell'area di notifica. Le chiamate arrivano subito, con una finestra in primo piano e una notifica.
Smartphone e tablet (iPhone, iPad, Android): per non consumare batteria l'app non resta connessa in background. All'arrivo di una chiamata il centralino invia una notifica che attiva l'app in un paio di secondi: il telefono squilla come una normale chiamata, anche con l'app chiusa e lo schermo bloccato. Per questo le notifiche dell'app devono restare attive.
Installazione
Scarica ExoVoIP dallo store del tuo dispositivo:
| Dispositivo | Dove scaricarla |
|---|---|
| iPhone e iPad | App Store |
| Android | Google Play |
| Mac | Mac App Store |
| Windows | Microsoft Store |
Al primo avvio l'app chiede il permesso di usare il microfono e di mostrare le notifiche: consentili entrambi, altrimenti non potrai ricevere le chiamate.
Download diretto per Windows
Se in azienda il Microsoft Store non è disponibile, scarica il programma di installazione direttamente dal nostro server:
https://centralino.exovoip.it/api/v1/app-releases/download/windows
Il link porta sempre all'ultima versione ufficiale. Il file è firmato digitalmente da Exobyte: Windows lo riconosce come editore attendibile e il download può essere ripreso se si interrompe.
Aggiornamenti
L'app installata dal sito si aggiorna da sola: controlla periodicamente se c'è una nuova versione, la scarica in background e propone di installarla. Prima di installarla verifica la firma di Exobyte, quindi un file alterato non viene mai eseguito.
Quando una versione è troppo vecchia per funzionare correttamente con il centralino, l'aggiornamento è obbligatorio: l'app lo segnala e si aggiorna prima di collegarsi. Le versioni scaricate dagli store si aggiornano dallo store stesso.
Collegare un dispositivo
Il collegamento si fa dal pannello, nella scheda App dell'interno. Può farlo l'amministratore per qualsiasi interno, oppure l'utente per il proprio.
- Nel pannello apri l'interno, scheda App, e premi Genera codice di collegamento.
- Sul dispositivo apri ExoVoIP e scegli Inquadra il QR, oppure Inserisci il codice.
- Inquadra il codice QR mostrato nel pannello oppure scrivi il codice di 8 caratteri (ad esempio
K7QP-4M2X).
Il codice vale 10 minuti e si può usare una sola volta: per collegare un altro dispositivo generane uno nuovo. Appena il collegamento va a buon fine il dispositivo compare nell'elenco Dispositivi collegati.
Suggerimento: sul computer il QR non serve. Apri il pannello da un altro dispositivo, oppure copia il codice e incollalo nell'app.
Nelle Opzioni avanzate puoi dare un nome al dispositivo (ad esempio "iPhone di Mario"): lo vedrai nell'elenco dei dispositivi collegati. Non c'è nessun indirizzo da inserire: l'app si collega da sola al servizio ExoVoIP. Un QR che non proviene dal tuo pannello ExoVoIP viene rifiutato.
Collegamento con email e password
Se al tuo utente del pannello è associato un interno, puoi collegare il dispositivo anche senza codice:
- Sul dispositivo apri ExoVoIP e scegli Accedi con email e password.
- Inserisci l'email e la password con cui entri nel pannello del centralino (con l'icona a forma di occhio puoi mostrare la password mentre la scrivi).
- Se il tuo account è protetto dalla verifica in due passaggi, l'app ti chiede anche il codice a 6 cifre dell'app di autenticazione.
- Premi Accedi e collega: il dispositivo viene collegato al tuo interno e compare in Dispositivi collegati.
La password serve solo per il collegamento e non viene memorizzata: da quel momento il dispositivo usa una propria chiave di accesso, che puoi revocare in qualsiasi momento con Scollega. Valgono le stesse protezioni dell'accesso al pannello: dopo troppi tentativi errati l'accesso viene bloccato per qualche minuto. Se al tuo utente non è associato un interno, chiedi all'amministratore di associarne uno oppure di generarti un codice di collegamento.
Quando squilla l'app
Nella scheda App scegli come squillano i dispositivi collegati rispetto ai telefoni dell'interno. L'impostazione vale per tutti i dispositivi dell'interno.
| Modalità | Cosa succede | Esempio |
|---|---|---|
| Insieme ai telefoni (predefinita) | App e telefoni squillano contemporaneamente | Rispondi dalla scrivania o dal cellulare, dove ti trovi |
| Prima i telefoni | I telefoni squillano subito, l'app dopo il ritardo scelto (da 1 a 60 secondi) | Ritardo di 10 secondi: in ufficio rispondi al fisso, fuori ti raggiunge l'app |
| Prima l'app | L'app squilla subito, i telefoni dopo il ritardo scelto | Lavori spesso in giro: la chiamata arriva prima sul cellulare |
| Solo se i telefoni non rispondono | L'app squilla quando i telefoni sono occupati, spenti o nessuno risponde | L'app è la tua riserva quando non sei alla scrivania |
| Solo l'app | Squillano soltanto i dispositivi collegati | Lavori da casa e non hai un telefono da scrivania |
| Non squilla | L'app non riceve chiamate, ma puoi usarla per chiamare con il numero dell'interno | Vuoi telefonare dal portatile senza essere disturbato |
La modalità si combina con le altre impostazioni dell'interno: il non disturbare ferma anche l'app, e la deviazione sul cellulare entra in gioco dopo i telefoni e l'app.
Dispositivi collegati
L'elenco nella scheda App mostra per ogni dispositivo il tipo (iPhone, iPad, Android, Mac, Windows), il nome, la versione dell'app, l'ultimo accesso e lo stato:
| Stato | Significato |
|---|---|
| Notifiche attive | Smartphone o tablet pronto: si attiva da solo all'arrivo di una chiamata |
| Da riattivare aprendo l'app | Il dispositivo non può essere avvisato delle chiamate: apri l'app e consenti le notifiche |
| Connesso | Computer con l'app aperta, pronto a ricevere |
| Non connesso | Computer spento o app chiusa: riceverà di nuovo le chiamate appena riapri l'app |
| In linea ora | Lo smartphone o il tablet è in uso in questo momento |
Ogni interno può avere fino a 20 dispositivi collegati.
Scollegare un dispositivo
Premi Scollega accanto al dispositivo e conferma. L'effetto è immediato: il dispositivo smette subito di ricevere e fare chiamate con l'interno. Fallo sempre se un telefono viene perso, sostituito o restituito. Per usarlo di nuovo basta un nuovo codice di collegamento.
Attivazione per l'azienda
L'app è attiva per tutte le aziende. Se nella scheda App compare il messaggio «App ExoVoIP non attiva», contatta Exobyte per attivarla. Quando l'app viene disattivata per l'azienda, tutti i dispositivi collegati smettono di ricevere e fare chiamate.
Risoluzione dei problemi
Lo smartphone non squilla con l'app chiusa
- Controlla nel pannello che il dispositivo sia Notifiche attive. Se è Da riattivare aprendo l'app, apri ExoVoIP: l'app si riattiva da sola.
- Verifica che le notifiche di ExoVoIP siano consentite nelle impostazioni del telefono (su iPhone: Impostazioni › Notifiche › ExoVoIP).
- Con le modalità _Full immersion_ o _Non disturbare_ del telefono le chiamate potrebbero essere silenziate: aggiungi ExoVoIP alle app consentite.
Android: le chiamate arrivano in ritardo o non arrivano
- Escludi ExoVoIP dall'ottimizzazione della batteria: Impostazioni › App › ExoVoIP › Batteria › Senza restrizioni.
- Su alcuni modelli (ad esempio Xiaomi, Huawei, Oppo, Samsung) attiva anche l'avvio automatico e disattiva il risparmio energetico per ExoVoIP.
- Consenti le notifiche a schermo intero, così la chiamata compare anche con lo schermo bloccato.
Il computer risulta Non connesso
- Verifica che l'app sia aperta (anche solo nella barra dei menu o nell'area di notifica) e che il computer non sia in stop.
- Nelle impostazioni dell'app attiva l'avvio al login, così ExoVoIP si apre da sola all'accensione.
Audio assente, a scatti o la chiamata cade
- Prova un'altra rete: passa dal Wi-Fi alla rete mobile o viceversa.
- Nelle reti aziendali o degli hotel con regole molto restrittive alcune connessioni possono essere bloccate: segnala il problema all'assistenza Exobyte.
- Controlla di aver concesso all'app il permesso di usare il microfono.
Il codice non viene accettato
- Il codice vale 10 minuti e una sola volta: generane uno nuovo dal pannello.
- Se compare il limite di dispositivi, scollega un dispositivo che non usi più.
- Se l'app dice che il QR non è un codice di collegamento ExoVoIP, inquadra il QR mostrato nella scheda App del pannello.
L'accesso con email e password non riesce
- Usa le stesse credenziali con cui entri nel pannello del centralino; se non le ricordi, reimpostale dalla pagina di accesso del pannello.
- Con la verifica in due passaggi inserisci il codice che vedi in quel momento nell'app di autenticazione: cambia ogni 30 secondi.
- Dopo troppi tentativi errati l'accesso resta bloccato per qualche minuto: attendi e riprova, oppure usa un codice di collegamento.
- Se compare "Al tuo utente non è associato un interno", chiedi all'amministratore di associare un interno al tuo utente.
Per gli sviluppatori
Le stesse funzioni sono disponibili via API, scope extensions:read / extensions:write. Il ruolo utente può usarle sul proprio interno.
| Descrizione | Richiesta | Scope | SDK |
|---|---|---|---|
| Modalità di squillo e dispositivi collegati | GET /v1/extensions/:id/app | extensions:read | extensions.getApp() |
| Modifica della modalità di squillo | PUT /v1/extensions/:id/app | extensions:write | extensions.setApp() |
| Codice di collegamento (QR, monouso, 10 minuti) | POST /v1/extensions/:id/app/activation | extensions:write | extensions.createAppActivation() |
| Scollegamento di un dispositivo (effetto immediato) | DELETE /v1/extensions/:id/app/devices/:deviceId | extensions:write | extensions.revokeAppDevice() |
PUT /v1/extensions/:id/app accetta ringMode (together, delayed, app_first, fallback, app_only, off) e ringDelayS (da 1 a 60, usato da delayed e app_first). La risposta di POST …/app/activation contiene code, url (il contenuto del QR, exovoip://activate?…), expiresAt e maxUses (attivazioni consentite con il codice, normalmente 1).
Il corpo di POST …/app/activation è facoltativo e riservato all'amministratore della piattaforma: { "validDays": 30, "maxUses": 10 } crea un codice valido fino a 30 giorni (validDays da 1 a 30) e utilizzabile più volte (maxUses da 1 a 50), ad esempio per la revisione dell'app negli store o per collegare più dispositivi con lo stesso QR. Se un amministratore dell'azienda o un utente invia uno di questi campi la richiesta viene rifiutata (403); senza corpo il codice resta monouso e valido 10 minuti.
Ogni dispositivo dell'elenco riporta platform (ios, ipados, android, macos, windows), name, appVersion, pushReady (notifiche attive, sempre true per i computer), pushEnv (production o sandbox, rilevante solo per iPhone e iPad), registered (connesso in questo momento) e lastSeenAt.
Il controllo degli aggiornamenti dell'app per computer è pubblico (nessuna autenticazione, limite di richieste per indirizzo): GET /v1/app-releases/latest?platform=windows&channel=stable¤t=1.4.2 restituisce il manifest firmato dell'ultima versione pubblicata, l'indirizzo del file, updateAvailable e mandatory (versione installata inferiore a minVersion). Il file si scarica da GET /v1/app-releases/files/:platform/:version/:name, con supporto alle richieste Range per riprendere i download interrotti. La gestione dei rilasci (/v1/app-releases, scope system:read / system:write) è riservata alla piattaforma.
L'attivazione per l'azienda (GET/PUT /v1/tenants/:id/app, corpo { "enabled": true }) è riservata all'amministratore della piattaforma; la risposta riporta anche il numero di dispositivi collegati.