Configurazione del software Twilio per StarLeaf VoiceConnect
Introduzione
StarLeaf si affida a provider di trunking SIP di terze parti per abilitare le chiamate da e verso PSTN. Questa funzione si chiama VoiceConnect ed è disponibile nelle licenze dell'account Enterprise. Twilio è uno dei nostri fornitori certificati in tutto il mondo e offre una configurazione rapida e tariffe basse per le chiamate al minuto. Questo documento fornisce istruzioni dettagliate su come creare il tuo account Twilio in Twilio e configurarlo per l'uso con StarLeaf VoiceConnect, inclusa l'opzione per consentire al supporto StarLeaf di completare gli aspetti dettagliati del processo. Questi passaggi sono accurati a partire da maggio 2018, ma Twilio aggiunge spesso nuove sezioni e funzionalità alla sua console, quindi i dettagli esatti sono soggetti a modifiche: faccelo sapere se hai domande o se trovi discrepanze.
Se hai già un account Twilio che usi per altri scopi, potresti voler configurare un nuovo account secondario solo per l'uso con la tua organizzazione StarLeaf. Quindi vai al passaggio 5 di seguito.
Completa il modulo Iscriviti gratuitamente
La parte superiore del modulo è importante. Le 4 domande a discesa Quale prodotto prevedi di utilizzare per primo fino a Potenziali interazioni mensili non hanno alcuna influenza su come è effettivamente impostato il tuo account Twilio, quindi puoi scegliere la risposta che preferisci qui. Quindi, dimostra di non essere un robot e fai clic su Inizia.
Completa il passaggio di verifica tramite SMS
Questo non mette in relazione il tuo numero di cellulare con la tua connettività PSTN StarLeaf in alcun modo, è solo per aiutarti a verificare che non sei un bot.
La parte relativa alle restrizioni di prova scomparirà dopo aver aggiunto del credito al tuo account.
Aggiungi del credito al tuo account
Seleziona Fatturazione Upgrade all'account completo. Non possiamo integrarci con gli account Twilio di prova gratuiti, quindi questo passaggio è necessario. Completa i passaggi "Inserisci i tuoi dati di pagamento utilizzando una carta di credito o Paypal e Aggiungi fondi". Ti consigliamo di lasciare l'importo di fatturazione impostato su un minimo di $ 20 e di impostare la ricarica automatica su Attivato.
Acquista numeri di telefono
Nella dashboard della console principale, seleziona Acquista un numero. Nella pagina Acquista un numero, utilizza il menu a discesa del paese e il filtro del numero per scegliere e acquistare i numeri di telefono di tua scelta. Hai bisogno di almeno un numero di telefono, anche se desideri abilitare solo la composizione in uscita sulla tua organizzazione StarLeaf, ad esempio se non vuoi avere numeri DID per i tuoi sistemi di camere StarLeaf individuali o utenti quel numero di telefono verrà presentato come ID chiamante in uscita . In genere compreresti un numero di telefono per ciascuna delle tue sale riunioni StarLeaf (e forse anche per gli utenti): configureremo quindi quei numeri in modo che funzionino come DID per consentire a ciascun sistema di sala di essere composto direttamente dalla PSTN utilizzando quel numero di telefono, e presentare anche quel numero come proprio ID chiamante in uscita. Potresti anche voler acquistare un altro numero di telefono che funga da numero di telefono "principale" e indirizzarlo al tuo receptionist o a un gruppo di ricerca della reception. I numeri di telefono statunitensi costano $ 1 al mese, che viene detratto dal saldo aggiunto al passaggio 4. Se stai acquistando una quantità significativa di numeri, potresti scegliere di aumentare l'importo della ricarica del conto dal passaggio 4.
NOTA
se intendi effettuare chiamate internazionali (verso numeri in paesi diversi da quelli in cui hai acquistato i numeri) vai alla pagina Geo Permissions del tuo account Twilio e abilita le chiamate verso i paesi o continenti richiesti. https://www.twilio.com/console/voce/chiamate/autorizzazioni geografiche/lowrisk
Per facilitare la navigazione, espandi il menu di sinistra e aggiungi i seguenti elementi: Voce programmabile, Numeri di telefono, Runtime.
Crea contenitori TwiML
TwiMl è il linguaggio di markup di Twilio, utilizzato per dirigere le telefonate. Creiamo 2 bin TwiML, uno per le chiamate in entrata e l'altro per le uscite. Fare clic su Runtime > Cestini TwiML > + 9a. Aggiungi il seguente contenitore TwiML con il nome descrittivo Outbound.
Dovrebbe apparire così: 
Copia e incolla il suo URL in una posizione temporanea, ad esempio una nota adesiva per un uso successivo.
TWIML per l'instradamento delle chiamate in entrata
Ora crea un altro cestino TwiML chiamato 'Inbound' contenente il codice qui sotto (dove XXXXXXXXX è il tuo ID organizzazione StarLeaf), salvalo e copia il suo URL Anche.
Crea un dominio SIP per registrare le tue linee StarLeaf
Fare clic su Voce programmabile > Domini SIP > + per arrivare a una pagina come questa:
Aggiungi un nome descrittivo di tua scelta e un sottodominio per il tuo URI SIP. Il sottodominio dell'URI SIP deve corrispondere esattamente al valore starleaf XXXXXXXXX che hai creato nel tuo cestino TWIML nel passaggio 9. In Configurazione vocale > Richiedi URL, incolla l'URI del tuo cestino TwiML in uscita dal passaggio 9. Modifica il metodo di richiesta da HTTP POST a HTTP GET. 'Ricaderci URL e stato di richiamata URL può essere lasciato vuoto.
Proseguendo nella pagina fino all'Autenticazione vocale, il campo successivo che devi utilizzare è "Elenchi di credenziali". Fare clic sul + a destra del campo Elenchi di credenziali per creare il proprio elenco di credenziali. Per ogni numero di telefono acquistato nel passaggio 5, aggiungi una voce nome utente/password in cui il nome utente corrisponde esattamente al numero di telefono nel modulo +1xxxxxxxxxx e la password è di almeno 12 caratteri secondo i requisiti indicati nel modulo Aggiungi credenziali. È più semplice utilizzare la stessa password per tutti i tuoi numeri di telefono. In Registrazione SIP, abilita la registrazione SIP dell'endpoint e seleziona il tuo elenco di credenziali in base al nome nel campo "Elenchi di credenziali" sotto quello. Verifica che il nome del tuo elenco di credenziali appaia nelle sezioni Autenticazione vocale e Registrazione SIP. Salva la tua configurazione.
Allegare webaggancia i tuoi numeri di telefono
Fare clic su Numeri di telefono. Viene visualizzato un elenco di tutti i tuoi numeri attivi. Fare clic su un numero per configurarlo. Configuralo con il Webscelta dei ganci. Per l'azione "Arriva una chiamata", imposta "TwiML" e inserisci il nome del contenitore TwiML in entrata che hai creato nel passaggio 9b. La schermata qui sotto mostra un examplui.
Gli altri campi possono essere lasciati così come sono. Salva la configurazione del tuo numero di telefono e completa gli stessi passaggi per gli altri numeri di telefono. La configurazione della console Twilio è ora completa.
Accedi alla configurazione PSTN su StarLeaf Portal
Accedi a https://portal.starleaf.com come utente amministratore o rivenditore e accedi al cliente/organizzazione per cui stai configurando l'accesso a Twilio. Fare clic su Trunk SIP PSTN > Aggiungi trunk SIP PSTN. Se non vedi questa opzione, contatta il tuo rivenditore StarLeaf o account manager è una funzionalità di livello Enterprise. Nella sezione "Trunk", seleziona Provider: Twilio (in tutto il mondo) e inserisci un nome e una descrizione a tua scelta. In "Avanzate", imposta Gateway: deve essere l'intero sottodominio SIP che hai creato nel passaggio 10, MA con us1 inserito dopo la parte sip del nome di dominio completo del gateway (questo è un requisito Twilio corrente ed è sempre noi1 indipendentemente dal paese in cui ti trovi in). Per esample, se hai creato starleaf123456 .sip.twilio.com nel passaggio 10, il valore del tuo gateway sarà starleaf123456.sip.us1.twilio.com Sotto i numeri PSTN premi + e aggiungi i numeri che hai configurato nel passaggio 11. I valori dovrebbero essere inserito come segue
- Numero PSTN: il numero di telefono senza il +1 iniziale
- Nome di registrazione: completare il numero di telefono dall'elenco delle credenziali creato nel passaggio 10.
- Autenticazione dell'interno: completare il numero di telefono dall'elenco delle credenziali creato nel passaggio 10.
- Password dell'interno: password dall'elenco di credenziali creato nel passaggio 10.
Al termine, premi Applica e controlla che appaia un segno di spunta verde per mostrare che il bagagliaio è online. Il passaggio finale assegna i singoli numeri agli endpoint StarLeaf. Lo scopo di questo passaggio è controllare quale numero presenta ciascun endpoint StarLeaf come ID chiamante in uscita, un numero sarà quello predefinito. Questo viene configurato selezionando i numeri SIP PSTN dal portale StarLeaf e mappando gli interni StarLeaf ai tuoi numeri di telefono uno per uno. Selezionare un numero come predefinito dell'organizzazione, questo verrà presentato come ID chiamante in uscita per tutti gli account/sistemi di sala che non dispongono di un proprio ID chiamante dedicato.
Documenti / Risorse
 |
Configurazione del software Twilio per StarLeaf VoiceConnect [pdf] Guida utente Configurazione Twilio per StarLeaf VoiceConnect, StarLeaf VoiceConnect, VoiceConnect |
