# Telefonia La sezione Telefonia è l'area di Aurora in cui gestisci i numeri usati dalla piattaforma per le attività telefoniche. In questa parte del sistema puoi vedere i numeri già disponibili, aggiungerne di nuovi, collegare un numero esistente oppure acquistare un numero VoIP da usare direttamente all'interno del tuo flusso operativo. Questa sezione ha un ruolo centrale perché il numero telefonico non è un semplice dato anagrafico: è il punto con cui l'agente entra realmente in contatto con l'esterno. Per questo motivo, la gestione dei numeri va considerata come una parte essenziale della configurazione operativa di Aurora. ### Come è organizzata la sezione Attualmente la telefonia è divisa in due aree operative principali: * gestione dei numeri già presenti in piattaforma * gestione del flusso VoIP per ricerca, acquisto e attivazione dei numeri In pratica, la sezione ti accompagna in due possibili scenari. Il primo è quello in cui vuoi collegare un numero che possiedi già e che il tuo team sa configurare. Il secondo è quello in cui vuoi cercare e acquistare un numero VoIP direttamente nel flusso previsto da Aurora. *** ### La lista dei numeri telefonici La pagina principale dei numeri ti mostra l'elenco dei numeri già registrati nella piattaforma. È il punto da cui puoi controllare rapidamente quali numeri sono disponibili e con quali caratteristiche sono stati configurati.
Nell'elenco trovi in particolare: * etichetta del numero * numero telefonico * origine del numero * supporto inbound * supporto outbound * eventuale agente assegnato Questa vista è utile perché ti permette di capire subito se un numero proviene da un acquisto VoIP oppure da una configurazione manuale, e se è già stato collegato all'operatività di un agente. *** ### I due modi per aggiungere un numero Quando scegli di aggiungere un numero, Aurora ti propone due percorsi distinti. #### Acquistare un numero VoIP Questa è la modalità consigliata nella maggior parte dei casi. Ti permette di cercare un numero disponibile e gestire il processo di acquisto all'interno del flusso previsto dalla piattaforma. Questa opzione è generalmente la più semplice quando vuoi un percorso guidato e già integrato con Aurora. #### Collegare un numero esistente Questa è la modalità avanzata. Serve quando possiedi già un numero o una configurazione telefonica esterna e vuoi collegarla manualmente alla piattaforma. È un percorso più adatto a chi ha già familiarità con questo tipo di configurazione e sa come gestire correttamente i dati necessari per il collegamento. ### Una nota importante sul piano {% hint style="info" %} Attualmente i limiti del piano si applicano ai numeri VoIP acquistati attraverso il flusso dedicato. I numeri manuali, invece, non vengono conteggiati nello stesso modo e non hanno limitazioni. {% endhint %} Dal punto di vista pratico, questo significa che la scelta tra numero VoIP e numero manuale non è solo una decisione tecnica, ma può avere anche un impatto organizzativo e di piano. Per questo conviene leggere con attenzione i messaggi mostrati dalla piattaforma prima di procedere. *** ### Il provider VoIP: Telnyx Per la gestione dei numeri VoIP, Aurora utilizza Telnyx come provider. In termini semplici, Telnyx è il servizio tramite cui la piattaforma ricerca, acquista e gestisce i numeri telefonici VoIP. Per l'utente finale non è necessario conoscere il funzionamento tecnico del provider. La cosa importante da sapere è che, quando acquisti un numero VoIP in Aurora, il numero viene gestito attraverso Telnyx. Alcuni passaggi del flusso, come documenti, requisiti, ordini e disponibilità dei numeri, dipendono proprio da questo provider. Per questo nella sezione telefonia troverai riferimenti a Telnyx nelle schermate operative collegate all'acquisto dei numeri. ### Ricerca di un numero VoIP Se scegli il percorso VoIP, Aurora ti porta nella pagina di ricerca dei numeri disponibili. Puoi impostare alcuni criteri principali, tra cui: * paese * località o provincia * tipo di numero Questa schermata è utile perché ti permette di restringere la ricerca in base al contesto in cui dovrà lavorare il numero. Una ricerca ben impostata rende più semplice trovare una risorsa coerente con il territorio e con l'uso previsto. *** ### Come leggere i risultati della ricerca Dopo la ricerca, la piattaforma mostra i numeri disponibili. In questa fase è importante non limitarsi a guardare solo il numero in sé, ma leggere anche le informazioni di contesto che accompagnano il risultato, ad esempio disponibilità e area geografica. Dal punto di vista operativo, questa fase serve a scegliere il numero più adatto prima di passare all'acquisto. È quindi consigliabile fare una selezione ragionata, soprattutto se il numero dovrà essere usato in attività visibili ai clienti. *** ### Requisiti per l'acquisto In alcuni casi, prima di completare l'acquisto del numero, Aurora richiede la compilazione di requisiti specifici. Questo passaggio fa parte del flusso VoIP e serve a raccogliere le informazioni necessarie per procedere correttamente. La piattaforma può anche mostrare eventuali requirement group già presenti, così da permetterti di riutilizzare informazioni già salvate invece di ricompilare tutto da zero. Dal punto di vista pratico, questo significa che il processo di acquisto non è sempre immediato e lineare: in alcuni casi richiede una fase di completamento dati prima dell'ordine. *** ### Documenti della telefonia La sezione telefonia include anche una pagina dedicata ai documenti. Questa area è utile per consultare i file già caricati nel flusso collegato a Telnyx e per tenere traccia del materiale usato nelle procedure richieste dal provider. Per l'utente, questa pagina è soprattutto un punto di controllo. È utile quando vuoi verificare se un documento è già presente, se è stato caricato correttamente o se devi pulire elementi non più necessari. *** ### Requisiti salvati Aurora mette a disposizione anche una vista dedicata ai requisiti già creati. Qui puoi consultare l'elenco dei requirement group, leggerne lo stato e aprire il dettaglio quando serve. Questa schermata è particolarmente utile quando gestisci più richieste o quando un acquisto richiede approvazioni e verifiche intermedie. In pratica, ti aiuta a non perdere il controllo dei passaggi amministrativi che accompagnano la telefonia VoIP. ### Ordini dei numeri La sezione ordini ti permette di controllare lo stato degli acquisti effettuati. È il punto in cui puoi seguire l'avanzamento dell'ordine e capire se sono richieste ulteriori azioni. Dalla lista ordini puoi trovare azioni utili come: * completare requisiti mancanti, quando richiesto * aprire il numero collegato, se l'ordine è già attivo Questa parte è importante perché collega la scelta del numero al suo effettivo stato operativo. *** ### Collegare un numero esistente Se scegli il percorso avanzato, puoi aggiungere un numero manualmente. Questo flusso è pensato per scenari in cui l'organizzazione dispone già di una configurazione telefonica e vuole collegarla ad Aurora. {% hint style="info" %} Questa modalità richiede maggiore attenzione, perché non si limita a registrare un numero: comporta anche la definizione delle informazioni operative necessarie al suo utilizzo. Per questo motivo è una scelta più adatta a utenti esperti o a contesti in cui il team sa già come gestire questo tipo di configurazione. {% endhint %} ### Informazioni principali di un numero Nella gestione dei numeri, alcuni campi hanno un significato operativo importante. #### Etichetta L'etichetta serve a riconoscere il numero nella piattaforma. Conviene scegliere un nome chiaro, ad esempio in base all'uso, al reparto o all'agente associato. #### Numero telefonico È il numero vero e proprio. Deve essere controllato con attenzione perché rappresenta l'identità telefonica che verrà usata nel flusso operativo. #### Origine del numero L'origine indica se il numero è stato acquistato tramite Telnyx oppure collegato manualmente. Questa distinzione è importante perché aiuta a capire anche quale percorso di gestione e quali vincoli si applicano al numero. #### Inbound Questo campo indica se il numero supporta le chiamate in entrata. È utile per capire se il numero può essere utilizzato per ricevere chiamate da parte dei clienti. #### Outbound Questo campo indica se il numero supporta le chiamate in uscita. È importante nelle attività in cui Aurora deve avviare il contatto verso l'esterno. #### Agente assegnato Questo elemento mostra se il numero è già collegato a un agente. Il collegamento è importante perché permette di associare la componente telefonica al comportamento operativo configurato nella sezione agenti. *** ### Modifica ed eliminazione Dalla lista dei numeri puoi anche modificare o eliminare un numero già presente. La modifica è utile quando devi aggiornare etichetta, assegnazione o altre impostazioni disponibili. L'eliminazione, invece, va usata con attenzione, soprattutto se il numero è già inserito in un flusso operativo o collegato a un agente attivo. Prima della cancellazione, la piattaforma richiede conferma. Questo passaggio è importante per evitare rimozioni accidentali. ### Un metodo consigliato Se stai iniziando a usare questa sezione, il metodo più efficace è questo: 1. verifica prima se ti serve un numero VoIP oppure un collegamento manuale 2. se non hai esigenze particolari, usa il percorso VoIP consigliato 3. scegli il numero con attenzione in base a paese, area e uso previsto 4. completa con ordine eventuali requisiti richiesti 5. controlla documenti, requisiti e ordini fino all'attivazione 6. assegna il numero all'agente corretto una volta pronto Questo approccio rende più ordinata la gestione della telefonia e riduce il rischio di configurazioni incomplete. ### Errori comuni da evitare I casi più frequenti in questa sezione sono: * scegliere un percorso manuale senza avere le competenze necessarie * ignorare i limiti del piano sui numeri VoIP * acquistare un numero senza completare correttamente i requisiti richiesti * non controllare lo stato dell'ordine dopo l'acquisto * assegnare il numero all'agente sbagliato * eliminare un numero senza verificare se è già in uso ### Serve supporto? Se riscontri dubbi nella scelta del percorso, problemi con l'acquisto di un numero VoIP o difficoltà legate ai requisiti Telnyx, puoi scrivere a `assistenza@aurorasuite.ai`. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.aurorasuite.ai/funzionalita-operative/phone-numbers-and-voip.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.