Acquista un numero di telefono in qualsiasi paese

L'acquisto di un numero di telefono avviene interamente dentro GodSetter: la pagina Numeri cerca nell'inventario Twilio i numeri disponibili in qualsiasi paese del mondo e ne acquista uno con un clic. Gli acquisti passano dall'account Twilio della tua agenzia — il numero è tuo, e Twilio ti addebita il costo mensile ricorrente, che dipende dal paese e dal tipo di numero.

Molti paesi sono regolamentati, quindi può esserci un prerequisito che vive fuori dalla piattaforma: il tuo account Twilio potrebbe dover avere un regulatory bundle approvato prima di poter acquistare un numero in quel paese. Questa guida copre l'intero percorso, incluso quel prerequisito.

Prima di iniziare

Twilio deve essere connesso per la tua agenzia nella pagina Connessioni. Senza connessione, sia la ricerca sia l'acquisto si fermano con "Twilio non è ancora connesso". Vedi Connetti Twilio. Collega anche Retell prima di comprare: l'acquisto registra subito il numero su Retell e senza quella connessione il numero viene comprato ma resta non registrato.

Cercare numeri richiede l'accesso visualizzatore sull'area Numeri; comprare richiede editor più il permesso Può spendere (costa denaro). Senza, l'acquisto viene rifiutato — chiedi a un admin della tua agenzia dalla pagina Team.

Passo 1 — Verifica i requisiti regolatori del paese

I paesi regolamentati (Italia, Germania e molti altri) richiedono un regulatory bundle approvato sul tuo account Twilio: un documento d'identità e l'indirizzo del titolare del numero (una persona o un'azienda; spesso l'indirizzo deve essere locale). Lo configuri nella Twilio Console, in Phone Numbers → Regulatory Compliance → Bundles — anche la card Acquista numero in GodSetter rimanda alla guida Twilio ai requisiti regolatori.

L'approvazione è gestita da Twilio e non è immediata: può richiedere giorni. Richiedila con largo anticipo rispetto al go-live di un cliente. Senza un bundle approvato la ricerca dei numeri funziona comunque (legge solo la disponibilità), ma ogni acquisto in quel paese fallisce. Alcuni paesi (per esempio Stati Uniti e Canada) non hanno questo prerequisito.

Alcuni numeri richiedono in più un indirizzo validato sul tuo account Twilio, a volte nel paese del numero stesso. GodSetter legge questo requisito e allega automaticamente un indirizzo compatibile — ma solo se esiste: crealo nella Twilio Console (Phone Numbers → Regulatory Compliance → Addresses) insieme al bundle.

Passo 2 — Scegli paese e tipo di numero, poi cerca

Apri la pagina Numeri. Nella card Acquista numero scegli il paese dall'elenco ricercabile (mostra tutti i paesi in cui Twilio può vendere al tuo account) e il tipo di numero — Mobile, Fisso/locale o Numero verde. Non tutti i paesi vendono tutti i tipi (gli Stati Uniti, per esempio, non hanno numeri mobili acquistabili — lì usa i fissi/locali); una combinazione non disponibile restituisce semplicemente nessun risultato. Clicca Cerca numeri per elencare fino a cinque numeri disponibili, con il costo mensile stimato per quel paese e tipo.

Passo 3 — Acquista il numero

Clicca Compra accanto al numero che vuoi. Una finestra di conferma mostra il numero e il costo mensile ricorrente prima dell'acquisto — l'acquisto è immediato e non reversibile. Conferma per completarlo.

Passo 4 — Controlla la tabella Numeri attivi

Se l'acquisto riesce vedi "Numero acquistato" e il numero compare nella tabella Numeri attivi con Tipo, Costo/mese, data di Acquisito e Stato. Un numero appena comprato non ha agenti: la sua colonna Agenti riporta Non assegnato.

Passo 5 — Controlla la registrazione su Retell

Un numero che la piattaforma vocale (Retell) non conosce non può né fare né ricevere chiamate, qualunque cosa assegni in GodSetter. Subito dopo l'acquisto GodSetter registra il numero per te: crea un trunk SIP sull'account Twilio della tua agenzia (una sola volta per agenzia), ci sposta il numero e lo importa su Retell con il webhook delle chiamate in entrata già puntato sulla tua agenzia. La colonna Retell nella tabella Numeri attivi mostra l'esito: registrato, oppure non registrato con sotto il messaggio d'errore del provider.

Se leggi non registrato (un errore temporaneo del provider, o un numero comprato prima che esistesse questa automazione), premi Registra su Retell su quella riga. L'operazione si può ripetere senza rischi: ripara ciò che manca e lascia intatto ciò che già funziona. Per le chiamate in uscita verso un paese estero, Twilio deve anche consentire quella destinazione in Voice → Geographic Permissions → Elastic SIP Trunking: quando è questa la causa, il messaggio d'errore lo dice.

Passo 6 — Assegna il numero ai tuoi agenti

Un numero nel pool non viene usato finché non lo assegni. L'assegnazione è fail-closed: un agente senza numeri attivi assegnati non chiama mai — i trigger che lo riguardano vengono saltati e le chiamate già in coda vengono scartate al momento del dispatch. È un isolamento multi-mercato voluto (un lead UK non deve mai essere chiamato da un prefisso italiano — assegna i numeri per mercato).

Apri ogni agente che deve usare il numero (editor agente → tab Numeri) e spuntalo. Vedi Assegna i numeri di telefono a un agente. La colonna Agenti nella pagina Numeri mostra la vista inversa: quali agenti usano ciascun numero.

Se l'acquisto fallisce

Prossimi passi

• Assegna i numeri di telefono a un agente
• Capire la saturazione dei numeri
• Le chiamate non partono — checklist completa