Documentazione

Il suo centralino in cinque minuti

Tutto quello che segue esiste già nel suo account. Niente qui richiede un installatore, la visita di un tecnico o un apparecchio da comprare.

• Numeri e interni ci sono già. Si creano insieme al suo account, con le credenziali SIP di cui ha bisogno ogni apparecchio. Un interno è una persona o una postazione; un numero è quello che compone chi sta fuori.
• Punti un numero da qualche parte. Nella scheda Numeri stabilisce cosa deve fare una chiamata che entra da lì: far squillare un interno, far squillare un gruppo, aprire un menu, entrare in una coda o seguire i suoi orari.
• La risponda dal browser. Apra la scheda Telefono, dia il permesso al microfono, e quella scheda è un apparecchio che funziona. Chiami la prova dell'eco componendo *43 e si sentirà tornare indietro.
• E poi metta gli orari e la segreteria. Sono quei due a evitare che una chiamata si perda alle sette di sera, e sono le due cose che più spesso mancano a un centralino appena acceso.

Ha fretta? Ci sono cinque modelli di avvio —uno studio medico, uno studio legale, un'officina, un negozio e una linea di casa— che creano gli orari, la rotta in entrata e la segreteria fuori orario in una sola richiesta. Non sovrascrivono mai qualcosa che lei abbia già configurato.

Come si entra nel pannellotramite API

Il pannello vive nella sua pagina VOICE e compare solo con una sessione. Quella sessione la emette la sua area cliente; qui non si digita nulla.

Per chi costruisce quel pulsante, questo è tutto il contratto:

POST /inquilinos/:inquilino/sesiones     # ambito sistema: solo il portale può emetterla
{ "minutos": 15 }
→ { "clave": "pbx_ses_…", "caduca": "…", "ambito": "sesion", "minutos_max": 60 }

/centralino#t=<clave>&exp=<ISO>&v=<inquilino>

La credenziale viaggia nel frammento e non nella query apposta: un frammento non viene mai mandato a un server, quindi non finisce in un'intestazione Referer, né nei registri d'accesso, né in un intermediario lungo la strada. Scade in pochi minuti, ha un tetto, e non può fabbricare una chiave permanente.

Il pannello, scheda per schedatramite API

16 sezioni, le stesse 16 in tutte e otto le lingue. Tutto quello che c'è qui esiste anche nell'API.

Il telefono dentro il browserchiamata reale

Una scheda del browser è un apparecchio. Niente da installare, nessun telefono da scrivania da comprare, nessun numero da portare: è un interno del suo stesso centralino, registrato dal browser.

• È un interno vero. Il browser si registra sul suo centralino esattamente come un telefono da scrivania, e l'audio viaggia su una connessione cifrata. Chi chiama il suo numero può arrivare alla scheda, e la scheda può chiamare fuori.
• La scheda deve restare aperta. Una scheda chiusa è un telefono staccato. È il limite onesto di un telefono nel browser, ed è il motivo per cui accompagna un apparecchio da scrivania invece di sostituirlo dappertutto.
• Vede chi è in chiamata.chiamata reale Le spie dei suoi colleghi si aggiornano in diretta — libero, squilla, parla — così sa se c'è qualcuno a cui passare la chiamata prima di provare a passargliela.
• Può spostare una chiamata viva su un altro apparecchio.non ancora provato «Devo uscire e sto parlando»: la chiamata passa al suo cellulare senza riagganciare. È un pulsante e non un codice da tastiera apposta — chi sposta una chiamata ha uno schermo davanti.
• Trasferire, parcheggiare e registrare sono gli stessi codici di qualsiasi apparecchio. Si compongono, non si cliccano, quindi quello che impara sul telefono del browser le serve sul telefono da scrivania e sul cellulare.

Il telefono del browser non registra mai sul suo computer. La registrazione avviene dentro il centralino, che è dove si applicano le regole su chi si può registrare e chi va avvisato — veda «Registrare, e la legge».

Codici che si compongono dall'apparecchio

Dove una convenzione esiste, si rispetta quella di sempre (*72 deviazione, *78 non disturbare, *97 segreteria, *8 risposta per assente, *69 chi ha appena chiamato). È tutto il senso di un codice da tastiera: la funzione è già nel pannello, e il codice è quello che fa credere al pannello chi compone *72 da vent'anni.

Si compongono con il telefono libero

Si compongono durante una conversazione

Durante la consultazione, in un trasferimento assistito

Dentro una stanza di conferenza

Alcuni codici significano due cose e non si scontrano: *1 in una conversazione normale è «registra ora», durante una consultazione è «completa il trasferimento», e dentro una stanza è «chiudi la stanza». Sono stati diversi dello stesso telefono, gestiti da codice diverso.

Prima di fidarsi di un apparecchio nuovo: I telefoni da scrivania e gli adattatori elaborano i propri codici asterisco e non li inoltrano mai. Se compone un codice e sente silenzio e poi il tono, se l'è mangiato l'apparecchio e il centralino non ha visto niente. Ci chieda di controllare un modello nuovo contro l'elenco di oggi prima di distribuirlo.

La segreteria da qualsiasi telefonobanco di prova

Componga *97, digiti il suo PIN, e la segreteria è tutta lì — senza app e senza browser. È scritta per il titolare che chiama da un telefono in prestito.

Menu principale

Mentre suona un messaggio

Menu degli annunci

Gestire la chiamata

Un gruppo di squillo dice «che squilli in più posti». Tutto quello che c'è in questo elenco fa qualcosa che un gruppo di squillo non sa fare.

• Code.non ancora provato Una coda sa quante persone ci sono davanti e quanto ci vuole di solito, quindi può dirlo. L'attesa si misura sulle sue chiamate recenti, non viene mai inventata — con meno di tre campioni non dice proprio niente. Senza nessuno di turno, non si fa aspettare nessuno.
• Richiamata dalla coda.non ancora provato Viene offerta dopo un po' di attesa, e non viene offerta se la chiamata sta comunque per essere risposta. La richiesta sopravvive a un riavvio, perché chi la fa riaggancia, e la richiamata entra davanti alla fila — che è quello che le era stato promesso.
• Stanze di conferenza.non ancora provato Una stanza con un numero e due chiavi: una per entrare, una per gestirla. Nessuno ha bisogno di un account da nessuna parte. Entrate e uscite vengono annunciate con il nome che ciascuno ha registrato di persona.
• La rubrica per nome.banco di prova Chi chiama compita un nome sulla tastiera e viene messo in comunicazione. Si indicizza ogni parola del nome separatamente, perché qui due cognomi sono la norma e cercare solo il primo trova mezza azienda. Accenti e ñ vengono normalizzati, così «Muñoz» si trova componendo 686.
• Lo zero per il centralinista.non ancora provato Probabilmente l'aspettativa più universale che esista su un telefono: poter arrivare a una persona. Lo zero scende a cascata dal suo centralinista alla segreteria generale fino a dirlo ad alta voce — mai un riaggancio muto.
• Parcheggiare e riprendere.non ancora provato Parcheggi una chiamata e resta ad aspettare con la musica in un posto numerato mentre lei cammina verso un'altra postazione. Chiunque la riprende componendo quel posto. Rispondere al telefono che squilla accanto è *8.

Canali: garanzia, prestito e restituzionetramite API

È la parte del prodotto che un tetto fisso non sa fare, e conviene capirla prima di scegliere il piano.

• Garantite. Le chiamate simultanee che vende il suo piano. Ci stanno sempre, comunque vada il centralino, e nessuno gliele può togliere.
• In prestito. Sopra la sua garanzia usa quello che il centralino ha libero. Quasi tutti i giorni sarà qui, e non costa niente in più.
• La riserva. Un cuscinetto di canali che non si presta a nessuno, così chiunque può arrivare alla propria garanzia in qualsiasi momento.
• La restituzione. Quando il centralino è sotto pressione, le chiamate in prestito possono essere restituite per proteggere la garanzia di un altro. Vale solo per gli account che l'hanno attivata, mai per una chiamata dentro una garanzia, mai per una chiamata d'emergenza e mai in silenzio: il centralino parla prima di lasciare.
• Non si può vendere due volte. La somma di tutte le garanzie più la riserva deve starci. L'attivazione lo controlla e rifiuta un piano che non ci starebbe, ed è questo che dà un senso alla parola «garantita».
• E si vede quando ha morso. La congestione viene riportata per episodi con la loro ora, non come totale del mese. «Dodici rifiuti in trenta giorni» si legge come rumore; «martedì scorso, tra le dieci e le undici, cinque persone hanno sentito occupato» è qualcosa su cui si può decidere.

Cosa succede quando qualcosa si rompe

Un centralino si giudica il giorno che va via la corrente, non il giorno in cui funziona tutto.

• Più di una via d'uscita. Il centralino raggiunge il mondo esterno con diverse connessioni indipendenti e sceglie da solo fra loro. Lei non configura niente e non lo vede succedere.
• «Funziona» si misura contro la cosa giusta. Una connessione entra nel giro solo se arriva sia a internet sia alla rete telefonica. Controllare solo la prima è il modo in cui un centralino resta senza linea con tutte le spie verdi.
• Si riprende da solo dopo un blackout. Quando torna la corrente, il centralino e gli apparati di rete si accendono insieme e non sempre nell'ordine giusto. Invece di fidarsi di quell'ordine, il centralino confronta di continuo quello che ha davvero con quello che dovrebbe avere e si ripara — con un tetto a quante volte può riprovare, così un guasto vero viene segnalato invece di restare in ciclo.
• Non taglia una chiamata per ripararsi. Qualsiasi riparazione che interromperebbe delle conversazioni aspetta che non ce ne sia più nessuna.

Le registrazioni e i messaggi della segreteria si conservano fuori dal centralino, quindi sopravvivono alla macchina stessa.

Piani e minuti

5 piani, da $100 a $300 all'anno, e un numero per licenza. Il minuto in entrata su un numero costaricano è $0.00.

Minuti

Prezzi in dollari statunitensi, tasse incluse. Le chiamate ai cellulari le misura al secondo il nostro operatore. Ogni licenza include 1 numero; i numeri in più condividono lo stesso centralino, gli stessi flussi e lo stesso pannello.

Registrare, e la leggetramite API

Un audio registrato è la voce di altre persone. Lo governa la legge costaricana 8968, e il progetto nasce da lì e non da quello che sarebbe comodo.

• Decide lei cosa si registra.tramite API Tutto, o solo certi interni, o solo le chiamate che entrano da un certo numero. O niente, che è una risposta legittima.
• La conservazione viene con il suo piano. Le registrazioni si cancellano da sole quando è ora. L'unica eccezione è una registrazione legata a un fascicolo di chiamata molesta, che smette di scadere finché lei non chiude il fascicolo — e chiuderlo restituisce una scadenza normale, mai un «la cancelli subito».
• Condividerne una non è dare accesso. Un link firmato riproduce una sola registrazione, scade da solo e si può revocare. La persona a cui lo manda non vede mai il suo account.
• Ogni ascolto resta annotato. Chi ha riprodotto quale registrazione e quando. È la voce di un'altra persona: sapere chi l'ha sentita fa parte del tenerla.
• Si possono classificare. Cliente, potenziale cliente o interna. Non c'è un valore predefinito apposta: non classificata è onesto, e un'etichetta messa dalla macchina poi non si distingue da una messa da una persona.

Vengono sempre avvisate entrambe le parti. Chiedere al centralino di registrare restituisce anche l'obbligo di annunciarlo: le due cose non si possono separare, perché separarle è il modo in cui qualcuno finisce registrato senza saperlo. In una stanza di conferenza l'annuncio viene fatto a ogni persona quando entra.

Limiti, protezione e annullamento

Le cose che decidono quanto arriva a fare male una giornata storta: una credenziale rubata, un errore nell'instradamento, un numero che non smette di chiamare.

• Un tetto di spesa, giornaliero e mensile.banco di prova È quello che impedisce a una credenziale rubata di costare denaro. Raggiunto il tetto, le chiamate si fermano.
• Cosa può comporre ogni interno.tramite API Solo interne, nazionale, cellulare o tutto. Il telefono del magazzino non ha motivo di poter chiamare un numero a tariffa maggiorata. Le chiamate d'emergenza non passano mai di qui.
• Il prezzo prima di comporre.tramite API Chieda quanto costerebbe un certo numero e la risposta la calcola la stessa macchina che instraderà davvero la chiamata, non un listino che potrebbe non essere quello applicato.
• Un allarme antifrode che guarda il comportamento.non ancora provato Una velocità insolita, un paese che non ha mai chiamato, un'ora in cui non lavora nessuno. Avvisa e non taglia: un falso positivo qui non è un avviso fastidioso, è una chiamata che non si è fatta. Gli servono due segnali prima di dire qualcosa, perché un allarme che scatta ogni giorno si impara a ignorarlo.
• Chi insiste troppo viene segnalato.non ancora provato Lo stesso numero cinque volte in due minuti non è un cliente insistente: è un combinatore automatico. Di serie avvisa soltanto; bloccare in automatico è una casella sua, perché un falso positivo costa un cliente che non potrà più chiamare.
• Un fascicolo per una chiamata molesta.non ancora provato L'ora, la rotta e l'audio, tenuti insieme per una denuncia. Aprirne uno non blocca chi chiama: ogni nuova chiamata è una prova in più, e questo lo decide lei e non noi.
• Quanto sono stati raggiungibili i suoi apparecchi.tramite API Non il nostro tempo in piedi: il suo. E mostra sempre quanta parte del periodo è stata davvero misurata, perché una percentuale che si mangia in silenzio le ore che nessuno ha guardato sbaglia sempre dalla parte comoda.
• Cosa è cambiato, chi l'ha cambiato e come si annulla.non ancora provato «Ieri funzionava» è una domanda con una risposta. Ogni modifica alla configurazione resta annotata e si può revocare, e revocarla controlla che nel frattempo nessun altro abbia toccato quei campi, invece di sovrascriverli in silenzio.

Cosa è spento, e perché

Un manuale che racconta solo quello che funziona la obbliga a scoprire il resto per conto suo, e lo si scopre sempre nel momento peggiore. Questo elenco lo genera l'interruttore stesso, quindi non può descrivere come spento qualcosa che è già stato acceso.

L'APItramite API

Il pannello è un client di questa API come un altro. Tutto quello che cambia a mano si può cambiare da programma, con una chiave che è del suo account.

curl -H "authorization: Bearer <clave>" \
  https://api.voice.forhosting.com/inquilinos/<cuenta>/numeros

Ambiti

Quando qualcosa va storto

Oggi non c'è quasi nessun limite di frequenza. L'unico è un'attesa di pochi secondi fra un tentativo e l'altro di aprire il telefono nel browser. Non c'è una quota generale, e preferiamo dirlo piuttosto che lasciarglielo scoprire dopo aver costruito su un'ipotesi. Sia ragionevole, e se ha in programma qualcosa di pesante, ce lo dica prima, così lo misuriamo insieme a lei invece che dopo di lei.

Fin dove si arriva

267 endpoint in totale, letti dal centralino stesso il 2026-08-17.

Questa tabella è un riassunto. L'elenco che non può invecchiare è quello che il centralino genera su se stesso: GET /api.

Sessioni: il browser non tiene mai una chiave permanente

Una credenziale di breve durata, con un tetto di 60 minuti, che non può fabbricarne una permanente. Questo è il contratto se è lei a costruire il pulsante.

• Solo il portale può emetterla. Emettere una sessione richiede una chiave di attivazione, perché solo il portale può affermare che dietro la richiesta c'è un cliente con la sessione aperta. VOICE non sa nulla delle password dei clienti, e non ha motivo di saperne.
• Non nasce mai senza scadenza. Se nessuno chiede una durata, gliene viene messa una. Un ambito che esiste per scadere e che potrebbe nascere eterno è peggio che non averlo, perché ci si fida.
• Chiedere più tempo non serve. C'è un tetto duro. Che chi chiama domandi otto ore non rende sicura la credenziale.
• Non può promuoversi da sola. La gestione delle chiavi vive interamente dietro l'ambito di attivazione, quindi una sessione non può fabbricarsi una chiave permanente. Questo viene imposto nel router, prima di qualsiasi gestore.
• Si può chiudere in anticipo. L'identificativo torna indietro nel momento in cui la si emette, proprio perché lei possa revocarla prima del tempo.

Webhooktramite API

I suoi sistemi vengono avvisati di quello che è successo, invece di chiederlo ogni pochi secondi. 28 eventi, firmati, con ritentativi, e nessuno che cada in silenzio.

x-pbx-evento: llamada.entrante
x-pbx-marca:  1755300000
x-pbx-firma:  <hex>

{ "evento": "llamada.entrante", "inquilino": "…", "cuando": "…", "datos": { … } }

Ogni consegna è firmata: la firma copre la marca temporale e il corpo esatto che ha ricevuto, quindi la verifichi contro i byte grezzi e non contro una copia riserializzata. Il segreto si vede una sola volta, quando crea l'iscrizione, e si può ruotare senza fermare le consegne.

Una consegna che fallisce viene ritentata dopo 10 · 30 · 60 · 300 · 900 · 3600 secondi, e ogni tentativo ha 10 secondi. Un'iscrizione che continua a fallire viene messa in pausa dopo 20 fallimenti di fila, invece di cadere in silenzio — e lei può vedere tutti i tentativi.

Gli eventi

Il canale in direttachiamata reale

I webhook viaggiano a lotti e arrivano in pochi secondi. Certe cose devono essere sullo schermo adesso: una spia che dice che un collega è al telefono non può arrivare quindici secondi dopo.

• Cosa porta. Le chiamate mentre succedono, i messaggi nuovi e lo stato della spia di ogni interno — che è quello che rende davvero viva una pulsantiera di spie su uno schermo.
• È di sola lettura.non ancora provato Si può aprire un accesso al canale senza consegnare un telefono: guardare quello che succede non dovrebbe richiedere una credenziale capace anche di cambiare le cose.
• Non sostituisce i webhook. Il canale in diretta è per uno schermo che qualcuno sta guardando. Se conta che il suo sistema lo venga a sapere, usi un webhook: ritenta, e non dipende da un socket aperto.

Come si leggono i distintivi

Ogni funzione di questa pagina porta un distintivo che dice come è stata verificata. Pubblichiamo anche quelle che non sono ancora state provate, segnate come tali, perché scoprirlo per conto suo è peggio.

112 funzioni, contate dal centralino il 2026-08-19.

Il distintivo è di una funzione, non di una singola riga: dove una funzione copre più codici, tutti mostrano il livello del gruppo. Vuol dire che un distintivo può restare INDIETRO rispetto a quello che è stato davvero provato — mai avanti, che è l'unica direzione in cui siamo disposti a sbagliare su una pagina che lei legge come una promessa.

Glossario

Le parole che usa un centralino telefonico e non usa nient'altro.