Schermata: la pagina Numeri, dove puoi filtrare per tipo e fare clic su + Aggiungi numero per acquistare o importare numeri.
### Cosa puoi fare da Numeri La pagina ha due schede: * **Numeri**: tutti i numeri del tuo spazio di lavoro, con il **Tipo** e lo **Stato** (per esempio, quando è stato aggiunto e quando si rinnova). * **Richieste Numeri**: le tue richieste di acquisto per paesi al di fuori di Stati Uniti e Canada. Vedi la sezione **Seguire le tue richieste**, più sotto. Quando fai clic su **+ Aggiungi numero**, vedi queste opzioni: * **Acquista numero** (tramite Callin.io) * **Importa da Twilio** * **Aggiungi numero personale** * **Aggiungi numero Telnyx** (dopo aver collegato Telnyx) Usa i filtri **Tutti**, **Acquistati**, **Twilio**, **Personali**, **Telnyx** e **BYOC (Tronco SIP)**, oppure la casella **Cerca numeri...**, per trovare subito quello che cerchi. *** ### Opzione A: Acquistare un numero tramite Callin.io Acquistare numeri tramite Callin.io è il modo più semplice per iniziare. #### Stati Uniti e Canada: acquisto istantaneo Per **Stati Uniti** e **Canada**, l’acquisto è istantaneo:Video: + Aggiungi numero → Acquista numero → Cerca numeri → seleziona un numero.
1. Vai su [Apri Numeri](https://app.callin.io/numbers). 2. Fai clic su **+ Aggiungi numero** → **Acquista numero**. 3. Scegli il **Paese**. Puoi cercare nell’elenco per nome, codice ISO o prefisso internazionale. 4. Scegli il tipo: * **Locale**: prefisso locale standard. * **Gratuito**: prefissi come 800 o 888. 5. (Facoltativo) Usa **Cerca per prefisso** (esempio: `415`). 6. Fai clic su **Cerca numeri**. 7. Seleziona un numero dall’elenco. Ognuno mostra lo stato o la provincia (per esempio, `NV`). 8. Fai clic su **Acquista numero selezionato**. > **Importante:** Dopo l’acquisto, il numero dovrebbe comparire nel tuo elenco. Se vedi l’avviso **Questo numero non è assegnato a nessun agente**, devi ancora assegnarlo a un agente prima di usarlo. #### Altri paesi: richiesta + documentazione
Schermata: per i paesi al di fuori di Stati Uniti e Canada, scegli il tipo di richiesta e un numero, poi fai clic su Avvia richiesta per caricare i documenti del paese.
Per i paesi **al di fuori di Stati Uniti e Canada**, l’acquisto segue un flusso **basato su richiesta** invece di un acquisto istantaneo: 1. Fai clic su **+ Aggiungi numero** → **Acquista numero** e scegli il **Paese**. 2. Scegli il **Tipo di richiesta**: * **Nuovo numero**: ottenere un nuovo numero. * **Portabilità**: mantenere il tuo numero attuale (vedi sotto). 3. Scegli uno dei **numeri** disponibili. Ognuno mostra l’operatore che lo fornisce (per esempio, **telnyx**). A seconda del paese, puoi scegliere anche il tipo di numero (per esempio **Locale** o **Mobile**). 4. Fai clic su **Avvia richiesta**. La piattaforma carica le informazioni e i **Requisiti documenti** specifici del paese. 5. Compila i campi obbligatori, carica i documenti e salva ogni elemento. 6. Invia la richiesta e paga le eventuali tariffe. Un operatore esamina poi la richiesta. Puoi seguire tutte le tue richieste nella scheda **Richieste Numeri**. ##### Portare un numero che hai già La **Portabilità** ti permette di portare un numero che hai già con un altro provider, così i tuoi clienti continuano a chiamare lo stesso numero. 1. In **Acquista un nuovo numero**, scegli il **Paese** e seleziona **Portabilità** come **Tipo di richiesta**. 2. Inserisci il tuo numero in **Numero da portare** e fai clic su **Verifica portabilità**. 3. Se il numero può essere portato, fai clic su **Avvia richiesta** e completa i **Requisiti documenti**, come per un nuovo numero. > **Suggerimento:** La portabilità richiede di solito più tempo dell’acquisto di un nuovo numero, perché il tuo provider attuale deve rilasciarlo. Non disattivare la linea attuale finché il numero non compare nel tuo elenco **Numeri**. Questa parte del processo è importante perché i requisiti non sono sempre gli stessi. Possono cambiare in base al **paese**, al **tipo di numero** e al fatto che la richiesta venga fatta da una **persona fisica**, da una **ditta individuale** o da una **società**. ##### Come funziona la fase di documentazione Dopo aver fatto clic su **Avvia richiesta**, il modulo può mostrare una combinazione di: * Campi di testo da compilare manualmente * Campi per caricare documenti di supporto * Un pulsante **Salva** per ogni requisito * Uno stato **In attesa** finché quell’elemento non viene salvato o caricato correttamente Questo significa che la richiesta di solito si completa **un pezzo alla volta**, non tutta insieme. Se un campo o un caricamento mostra ancora **In attesa**, quel requisito di norma non è ancora completo. In molti paesi con richiesta, il modulo può chiedere dati come: * **Tipo di documento d’identità** * **Numero del documento d’identità** * **Data di nascita** * **Luogo di nascita** * **Ente emittente del documento d’identità** * **Data di scadenza del documento d’identità** * **Indirizzo locale nello stesso paese** * **Codice fiscale personale** * **Partita IVA** * **Codice fiscale dell’azienda** * **Tipo di cliente IT** * **Prova di indirizzo** * **Copia del passaporto/documento d’identità** * **Certificato di registrazione dell’azienda** Alcune etichette chiariscono anche chi deve fornire ogni elemento, per esempio: * **Solo per persone giuridiche** * **Solo per persone giuridiche e ditte individuali** * **Solo per persone fisiche e ditte individuali** Quindi, anche se due clienti richiedono numeri nello stesso paese, la documentazione necessaria può cambiare in base al tipo di attività e alla categoria esatta del numero. > **Suggerimento:** Nel modulo di richiesta, alcuni campi hanno un proprio pulsante **Salva**. Inserire un valore non sempre basta: l’elemento può continuare a mostrare **In attesa** finché non fai clic su **Salva**. ##### Requisiti documentali comuni (esempi) I requisiti esatti dipendono dal paese e dal tipo di numero, ma potrebbero chiederti elementi come questi: | Requisito | Cosa significa | Esempio | | - | - | - | | Indirizzo corrispondente al prefisso del numero | Potrebbe servirti un indirizzo nella stessa città, regione o area di copertura del numero richiesto | “Via Roma 22, Milano” per un numero locale di Milano | | Documento d’identità / codice fiscale | Identificazione personale o aziendale per verificare il richiedente | Numero di passaporto, carta d’identità, codice fiscale, partita IVA | | Dati di contatto | Una persona o un contatto aziendale reperibile per la richiesta | “Luca Bianchi, +39 345 000 1111” | | Prova di indirizzo (caricamento) | Un documento che mostra l’indirizzo inserito nella richiesta | Bolletta, estratto conto, contratto d’affitto o lettera ufficiale della pubblica amministrazione | | Copia del passaporto/documento (caricamento) | Verifica dell’identità di una persona o di un rappresentante dell’azienda | Scansione del passaporto o copia fronte/retro della carta d’identità | | Certificato aziendale (caricamento) | Prova che l’azienda è registrata legalmente | Atto costitutivo, visura camerale | | Codice fiscale dell’azienda / partita IVA | Dati fiscali dell’azienda per le richieste aziendali | Partita IVA o codice fiscale dell’azienda | | Data e luogo di nascita | Dati di identificazione personale richiesti in alcuni paesi | “14 marzo 1988, Napoli” | | Ente emittente e scadenza del documento d’identità | Informazioni sull’autorità che lo ha emesso e sulla sua validità | “Rilasciato dal Comune di Torino, scade 08/2028” | ##### Prova di indirizzo: cosa causa più spesso problemi La **prova di indirizzo** è uno dei motivi più comuni per cui una richiesta si blocca. In molti paesi, la prova di indirizzo caricata deve rispettare tutte queste condizioni: * Mostrare chiaramente lo **stesso nome** usato nella richiesta, o il nome dell’azienda se la richiesta è aziendale * Mostrare chiaramente lo **stesso indirizzo** inserito nel modulo * Essere **recente** * Essere completa e leggibile * Non essere ritagliata in modo da nascondere dati importanti Una regola molto importante è che la bolletta o il documento di indirizzo spesso deve avere **meno di 3 mesi** al momento dell’invio. Di solito significa caricare un documento recente come: * Una bolletta degli ultimi 3 mesi * Un estratto conto degli ultimi 3 mesi * Una lettera ufficiale della pubblica amministrazione o fiscale degli ultimi 3 mesi I documenti più vecchi possono essere rifiutati anche se l’indirizzo è corretto. > **Importante:** Quando carichi una bolletta o un estratto conto come prova di indirizzo, assicurati che abbia **meno di 3 mesi**. Se è più vecchio, la richiesta può restare in attesa o essere rifiutata durante la revisione. ##### Come preparare i documenti prima del caricamento Per evitare ritardi, controlla ogni documento prima di caricarlo. Un buon documento deve essere: * **Chiaro e leggibile** * **Completo**, senza bordi tagliati * **Coerente** con i dati inseriti nel modulo * **Aggiornato**, soprattutto per i documenti di indirizzo * **Adatto** al tipo di richiedente, persona o azienda Per esempio, se la richiesta è per un’azienda, il revisore può aspettarsi che nome dell’azienda, numero di registrazione, dati fiscali e documenti di registrazione coincidano. Se è per una persona, può verificare che nome, documento d’identità e prova di indirizzo coincidano. Problemi comuni che rallentano l’approvazione: * L’indirizzo nel modulo non corrisponde al documento caricato * La bolletta caricata ha più di 3 mesi * La copia del passaporto o del documento è sfocata * Una richiesta aziendale viene inviata solo con documenti personali * Un campo è compilato, ma non è stato fatto clic su **Salva** * Un documento è stato caricato, ma il suo stato mostra ancora **In attesa** > **Errore comune:** Caricare il file giusto non sempre basta. Dopo ogni caricamento o testo, controlla che il requisito non mostri più **In attesa**. ##### Tariffe + revisione Alcuni paesi mostrano una fase di **pagamento** dopo aver completato la documentazione. Può includere: * Una **tariffa di attivazione una tantum** * Il **costo mensile** del numero La richiesta di solito va avanti solo dopo che i documenti necessari sono stati caricati e il pagamento è stato completato. Dopo l’invio e il pagamento: * Ricevi un **ID richiesta** * Un operatore esamina la richiesta * Una volta approvata, il numero compare nel tuo elenco **Numeri** La revisione è spesso manuale, per questo l’approvazione non è sempre immediata. > **Importante:** I tempi di approvazione variano in base al paese, alle regole del provider e alla qualità dei documenti. Se ti serve il numero per un lancio o una campagna, invia la richiesta il prima possibile con documenti recenti e ben leggibili. ### Seguire le tue richieste (Richieste Numeri) La scheda **Richieste Numeri** elenca le tue richieste di acquisto e di portabilità per i paesi al di fuori di Stati Uniti e Canada.
Schermata: ogni scheda è una richiesta. Usa i filtri per trovare quelle che richiedono la tua attenzione.
Ogni scheda mostra il **paese**, lo **stato** della richiesta, il **Tipo Numero**, il **Flusso**, il **Numero Scelto**, la data e lo stato del pagamento. Usa i filtri per restringere l’elenco: | Filtro | Opzioni | | - | - | | **Stato** | **Bozza**, **In attesa**, **Approvato**, **Info richieste**, **Rifiutato**, **Completato**, **Annullato** | | **Flusso** | **Ordine** (nuovo numero), **Portabilità** (numero esistente) | | **Stato Pagamento** | **Dovuto**, **Pagato** | Fai clic su **Aggiorna** per vedere lo stato più recente. > **Suggerimento:** Controlla spesso questa scheda finché hai una richiesta aperta. Una richiesta in **Info richieste** aspetta che tu corregga o aggiunga qualcosa, e **Pagamento Dovuto** significa che non andrà avanti finché non paghi. *** ### Opzione B: Importare numeri da Twilio Se hai già dei numeri su Twilio, puoi importarli in Callin.io: 1. Vai su [Apri Numeri](https://app.callin.io/numbers). 2. Fai clic su **+ Aggiungi numero** → **Importa da Twilio**. 3. Inserisci il tuo **Twilio Account SID** e il tuo **Twilio Auth Token**. 4. Fai clic su **Cerca numeri Twilio** e seleziona i numeri da importare. 5. Assegna i numeri importati a un agente IA quando vuoi usarli. > **Errore comune:** Copiare le credenziali Twilio sbagliate (per esempio quelle di prova invece di quelle reali). Se non compare nessun numero, controlla il tuo progetto Twilio e i relativi permessi. *** ### Opzione C: Aggiungere un numero personale (solo chiamate in uscita) Un **numero personale** è utile quando vuoi effettuare chiamate in uscita dal tuo numero, ma non può ricevere chiamate in entrata in Callin.io.
Schermata: la finestra Aggiungi numero personale, con il campo del telefono e il processo di verifica (ricevi una chiamata e inserisci il codice).
#### Come verificare il tuo numero personale 1. Vai su [Apri Numeri](https://app.callin.io/numbers). 2. Fai clic su **+ Aggiungi numero** → **Aggiungi numero personale**. 3. Seleziona il prefisso del paese e inserisci il tuo numero di telefono. 4. Fai clic su **Verifica numero**. 5. Ricevi una **chiamata di verifica** da Twilio. 6. Inserisci il codice di verifica quando richiesto. 7. Dopo la verifica, il numero viene aggiunto al tuo account. > **Importante:** I numeri personali sono **solo per chiamate in uscita**. Se ti servono chiamate in entrata, usa un numero acquistato o importato, oppure BYOC. *** ### Opzione D: Aggiungere/importare numeri Telnyx Se il tuo account Telnyx è collegato (tramite BYOC), puoi importare i tuoi numeri Telnyx attivi in Callin.io: 1. Vai su [Apri Numeri](https://app.callin.io/numbers). 2. Fai clic su **+ Aggiungi numero** → **Aggiungi numero Telnyx**. 3. Usa **Cerca numeri...** per trovarli e spunta la casella **Seleziona** di ogni numero che vuoi. **Seleziona visibili** seleziona tutti i numeri dell’elenco. 4. Fai clic su **Importa**, poi assegnali agli agenti quando serve. > **Importante:** Se non hai ancora collegato Telnyx, la finestra mostra un errore per la chiave API di Telnyx mancante e nessun numero. Collega prima Telnyx in [BYOC (tronco SIP)](#byoc-tronco-sip). *** ### Gestire i tuoi numeri Nell’elenco **Numeri**, fai clic sul menu **⋮** di un numero per gestirlo: * **Modifica etichetta**: dai al numero un nome riconoscibile, per esempio il cliente o la campagna a cui serve. * **Annulla abbonamento** (numeri acquistati): interrompi il rinnovo di un numero acquistato tramite Callin.io. * **Rimuovi** (numeri personali): elimina un numero personale dal tuo account. > **Importante:** Prima di annullare o rimuovere un numero, assegna un altro numero agli agenti che lo usano, così potranno continuare a effettuare e ricevere chiamate. *** ### Assegnare un numero a un agente Acquistare o importare un numero è solo il primo passo: il tuo agente deve ancora usarlo. Se l’elenco **Numeri** mostra **Questo numero non è assegnato a nessun agente**, assegnalo prima di andare in produzione: 1. Vai su **Agenti AI**. 2. Fai clic sul menu **⋮** dell’agente e seleziona **Assegna numero**. 3. Nella finestra di assegnazione, trova il numero (puoi cercare per numero, etichetta o operatore) e fai clic su **Assegna**.
Schermata: la finestra Assegna numero mostra quali numeri sono liberi e quali sono già usati da un altro agente.
La colonna **Stato** indica se ogni numero è **Non assegnato** o è già assegnato a un altro agente. Se non hai un numero adatto, fai clic su **Acquista nuovi numeri**. > **Errore comune:** Assegnare un numero già usato da un altro agente. Come avvisa la finestra, assegnandolo qui **verrà scollegato dall’altro agente**, che smetterà di usarlo. > **Suggerimento:** Tieni un numero “di prova” separato da quello di produzione mentre perfezioni istruzioni e flussi di chiamata. *** ## BYOC (tronco SIP) **BYOC** sta per *Bring Your Own Carrier*, cioè usare il tuo operatore. Invece di acquistare numeri tramite Callin.io, colleghi il tuo provider telefonico con un tronco SIP. Motivi tipici per usare BYOC: * Hai già un contratto con un operatore (telefonia aziendale) * Ti servono instradamenti personalizzati, il controllo del SBC o il rispetto di vincoli normativi * Vuoi evitare le regole della telefonia gestita da Callin usando il tuo provider Configuralo qui: [Apri BYOC](https://app.callin.io/byoc)
Schermata: la configurazione BYOC, dove puoi collegare Telnyx e sincronizzare i numeri con Callin.io.
### Che cos’è un tronco SIP (in parole semplici) Un **tronco SIP** è una connessione tra un operatore telefonico e il tuo sistema di chiamate. Pensalo come una “linea telefonica via internet” che gestisce chiamate in entrata e in uscita, molto usata dalle aziende. *** ### Opzione 1: Collegare Telnyx Se usi **Telnyx**, Callin.io ti guida nella configurazione con una chiave API: 1. Vai su [Apri BYOC](https://app.callin.io/byoc). 2. Seleziona la scheda **Telnyx**. 3. Incolla la tua **Chiave API Telnyx**. 4. Fai clic su **Avvia**. Durante la configurazione vedrai passaggi come: * Salvataggio della chiave API Telnyx * Recupero dei numeri Telnyx attivi (DID) * Salvataggio dei numeri nel tuo account Callin.io * Attivazione del tronco SIP (in entrata e in uscita) * Creazione dei numeri di telefono del provider Al termine, i tuoi numeri Telnyx dovrebbero comparire in **Numeri**. > **Importante:** Se la tua chiave Telnyx non ha il permesso di leggere i numeri (DID), Callin.io non potrà recuperarli. *** ### Opzione 2: Collegare un altro provider (tronco SIP generico) Se il tuo provider non è Telnyx, usa la scheda **Altro provider SIP** (**Trunk SIP generico / Estensione PBX (qualsiasi provider)**). Funziona con un numero di tronco SIP (DID) e anche con un’**estensione del tuo centralino** (PBX). Configurerai tre schede: **Base**, **In entrata** e **In uscita**.
Schermata: il modulo trunk SIP generico / estensione PBX. Compila Base, In entrata e In uscita, poi fai clic su Salva e importa.
#### Base * **Etichetta**: un nome facile da riconoscere (esempio: “Tronco SIP sede centrale”) * **Numero di telefono / Estensione (E.164 o estensione)**: il numero completo in formato internazionale (esempio: `+15551234567`) o l’estensione del centralino (esempio: `101`) * **Supporta in entrata** e **Supporta in uscita**: seleziona le direzioni che gestirà questo numero #### In entrata Le chiamate in entrata vanno dall’operatore al tuo sistema. * **SBC / FQDN in entrata**: il tuo indirizzo SIP (esempio: `sip.example.com:5061`) * **Trasporto**: **TLS**, **TCP** o **UDP** * **Crittografia dei media**: **Consentito**, **Richiesto** o **Disabilitato** > **Suggerimento:** Le chiamate in entrata spesso **non** richiedono credenziali. Molti operatori le autenticano tramite elenchi di IP consentiti o la configurazione del tronco. #### In uscita Le chiamate in uscita vanno da Callin.io al tuo operatore. * **SBC / FQDN in uscita**: il server SIP del tuo provider * **Trasporto** e **Crittografia dei media** (le stesse opzioni di In entrata) * **Nome utente** e **Password**: le tue credenziali SIP * **Paesi consentiti (in uscita)**: **In tutto il mondo** o un **Elenco personalizzato** Quando hai finito, fai clic su **Salva e importa**. Per ricominciare da capo, fai clic su **Reimposta**. Dopo il salvataggio, Callin.io verifica che il numero si possa usare per chiamare. Se le impostazioni SIP richiedono attenzione, vedrai delle indicazioni in questa pagina. Nel frattempo il numero può comparire comunque nel tuo elenco **Numeri**. > **Errore comune:** Usare un SBC/FQDN o credenziali sbagliati. Se le chiamate in uscita non funzionano, ricontrolla nome utente e password SIP e verifica se il tuo provider richiede una porta o un trasporto specifici. *** ## Minuti e fatturazione (le informazioni essenziali) La fatturazione può avere due parti: l’**utilizzo di Callin** e i **costi dell’operatore telefonico**. Quello che vedi dipende da come colleghi i numeri. ### Minuti di elaborazione di Callin I **minuti di elaborazione** rappresentano il tempo in cui il tuo agente IA è attivo (ascolta, elabora e risponde). È la metrica principale di utilizzo delle chiamate con IA. ### Avviso importante sulla fatturazione (primo minuto) Quando effettui chiamate con la **telefonia gestita da Callin** (per esempio, numeri acquistati tramite Callin.io e instradati sull’operatore di Callin), si applica una regola di **fatturazione del primo minuto**: * L’addebito minimo è di **1 minuto** * Dopo il primo minuto, si paga la durata reale della chiamata * Questa regola **non si applica** a: * **Chiamate di prova dal browser** * **Numerazione propria importata** (Telnyx o Twilio) * **Tronco SIP esterno (BYOC)** > **Importante:** Il comportamento esatto può variare in base alla tua configurazione e all’instradamento del provider. Se vuoi evitare le regole della telefonia gestita da Callin, importa i tuoi numeri o usa BYOC. ### Promemoria: fatturazione con numero personale I numeri personali sono **solo per chiamate in uscita**, e le chiamate fatte con un numero personale possono comunque rientrare nelle regole della telefonia gestita da Callin, a seconda di come vengono instradate le chiamate del tuo account. *** ## Risoluzione dei problemi ### “Non riesco a effettuare chiamate” * Controlla di avere almeno **un numero attivo** * Assicurati che il numero sia **assegnato a un agente** * Se usi BYOC, verifica che le impostazioni del tronco SIP siano corrette (SBC/FQDN, trasporto, credenziali) ### “Il mio numero personale non riceve chiamate in entrata” * È normale: **i numeri personali sono solo per chiamate in uscita** * Usa un numero acquistato o importato, oppure BYOC, per ricevere chiamate ### “I miei numeri importati non compaiono” * Ricontrolla le credenziali (Twilio Account SID e Auth Token, o la chiave API Telnyx) * Verifica che i numeri siano attivi nell’account del provider * Riprova e controlla di usare il progetto o il sottoaccount corretto del provider *** ## Nota finale Se vuoi la configurazione più rapida, inizia con **un numero degli Stati Uniti o del Canada acquistato in Callin.io**. Se ti serve un instradamento avanzato o hai già un operatore, collega **BYOC**. Quando il tuo numero è aggiunto e assegnato, i tuoi agenti IA possono effettuare e ricevere chiamate reali su larga scala. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.