Telefonia Voys

Con l'integrazione Voys, Tillor vede chi sta chiamando e mostra subito i dati del cliente. Le chiamate, le registrazioni e le trascrizioni finiscono poi in Chiamate telefoniche. Voys è un fornitore di telefonia per le aziende.

Prima di iniziare:

• Ti serve un account VoIP Voys attivo e l'accesso alle impostazioni del piano di chiamata in Voys.
• Ti serve l'autorizzazione Gestisci integrazioni.
• Il numero di telefono di chi chiama deve essere sul profilo cliente o presso una persona di contatto, altrimenti Tillor non collega la chiamata a un cliente.

Configurare VoysCopia il link a questa sezione

1. Vai a Impostazioni (nella barra laterale, sotto Assistenza)

2. Scegli Integrazioni e apri Voys nell'elenco
3. Nella pagina di dettaglio inserisci i tuoi dati Voys (username, password, client_uuid, token) e fai clic su Installare

Ti serve un account VoIP Voys attivo.

Ritrovare gli URL per VoysCopia il link a questa sezione

Tillor e Voys comunicano tra loro tramite indirizzi (URL). In alcuni passaggi Voys chiede a Tillor una risposta, ad esempio se sei aperto. Quella risposta è ACK (sì, continua) oppure NAK (no, segui l'altro percorso). Un webhook è un indirizzo di questo tipo che Voys richiama durante una chiamata.

Per i webhook, la ricerca del nome di chi chiama e i codici di accesso usi gli URL che Tillor genera per te.

1. Vai a Impostazioni > Integrazioni e apri Voys
2. Dopo l'installazione, nella pagina di dettaglio, sotto Impostazioni, trovi il blocco URL da configurare: copia lì l'URL giusto per ogni scopo

Trovi tra l'altro:

• Notifiche di chiamata - URL del webhook per gli eventi delle chiamate
• Webhook per Beller Lookup - URL per la ricerca del nome del chiamante (caller name lookup) nel tuo piano di chiamata Voys
• XML Phonebook - URL con cui i telefoni VoIP recuperano la rubrica
• Codici di accesso - URL per comandare il punto di accesso (sbarra, cancello o porta) tramite il piano di chiamata
• Webhook degli orari di apertura - ACK se Tillor è aperto, NAK se Tillor è chiuso
• Webhook chiamante consentito - ACK se la chiamata può essere inoltrata, NAK se il chiamante deve andare alla segreteria
• Webhook di instradamento - ACK con una destinazione, NAK se non è impostata nessuna destinazione

Nel piano di chiamata Voys usa le stesse variabili indicate in Tillor (come {callerid}, {did}, {callername}, {callid} e {code}).

Configurare le notifiche di chiamata in VoysCopia il link a questa sezione

1. In Voys apri il modulo Notifiche di chiamata
2. Fai clic su Aggiungi
3. Come pacchetto/servizio scegli Personalizzato
4. Incolla l'URL di Tillor preso da Notifiche di chiamata
5. Salva

Documentazione di Voys:

• Notifiche di chiamata

Configurare i nomi dei chiamanti (caller lookup) nel piano di chiamataCopia il link a questa sezione

Per la ricerca del nome del chiamante usi in Voys un passaggio webhook nel piano di chiamata.

1. In Tillor apri l'URL Webhook per Beller Lookup (in Impostazioni > Integrazioni > Voys, sotto URL da configurare) e copialo
2. In Voys apri il modulo Webhook e crea un webhook con questo modello di URL
3. Attiva quel webhook nel piano di chiamata tramite il passaggio webhook
4. Nel modello di URL usa le variabili supportate da Voys ({callerid}, {did}, {callername} e, se necessario, {code})
5. Nell'instradamento del webhook imposta Variabile nome chiamante, così il nome restituito viene mostrato sugli apparecchi

I webhook degli orari di apertura e dell'instradamento non cercano il nome del chiamante. Per questo usa questo passaggio separato.

Altri approfondimenti:

• Webhook
• Cosa sono le notifiche di chiamata (differenza rispetto ai webhook)

Orari di apertura e destinazioni nel piano di chiamataCopia il link a questa sezione

Tillor è la fonte per gli orari di apertura, le vacanze e le eccezioni per i giorni festivi. Voys non ha più bisogno di conoscere da sé quel calendario.

1. In Impostazioni > Integrazioni > Voys scegli l'apparecchio Voys per aperto e, facoltativamente, per chiuso
2. Copia Webhook degli orari di apertura o Webhook di instradamento da URL da configurare
3. In Voys crea un webhook con quel modello di URL
4. Inserisci quel webhook come passaggio nel piano di chiamata, sopra eventuali menu di scelta
5. Lascia disattivato Usa menu

Due schemi:

• Webhook degli orari di apertura - status=ACK segue il percorso HTTP e menu riusciti (aperto), status=NAK segue HTTP o menu non riusciti (chiuso). Se è impostata una destinazione per l'apertura, questa è presente con ACK come destination.
• Webhook di instradamento - Tillor sceglie la destinazione. Nel passaggio riuscito imposta Variabile destinazione finale. ACK + destination se c'è una destinazione, altrimenti NAK.

In caso di errore o timeout Voys prende il percorso non riuscito. Trattalo come chiuso.

Documentazione di Voys: Webhook.

Inviare automaticamente i chiamanti alla segreteriaCopia il link a questa sezione

Con il Webhook chiamante consentito lasci che Voys decida, chiamante per chiamante, se una chiamata viene inoltrata. Tillor controlla se il numero del chiamante appartiene a un cliente che ha attivato la segreteria automatica.

Imposta prima il piano di chiamata:

1. Copia Webhook chiamante consentito da URL da configurare in Impostazioni > Integrazioni > Voys
2. In Voys crea un webhook con quel modello di URL
3. Inserisci quel webhook come passaggio nel piano di chiamata, sopra i passaggi che inoltrano la chiamata
4. Lascia disattivato Usa menu
5. Indirizza il percorso HTTP e menu riusciti al tuo normale instradamento e il percorso HTTP o menu non riusciti alla segreteria
6. In Impostazioni > Integrazioni > Voys, sotto Instradamento chiamate, seleziona Segreteria automatica in Voys

Finché è disattivato, non vedi Invia le chiamate alla segreteria sul profilo cliente.

Poi attiva la segreteria automatica per singolo cliente:

1. Apri il profilo cliente e vai alla scheda Comunicazioni
2. In Impostazioni di comunicazione seleziona l'opzione Invia le chiamate alla segreteria
3. Fai clic su Salva

Ecco come funziona la risposta:

• ACK - il chiamante può passare. Vale anche per i numeri sconosciuti e per i chiamanti con numero nascosto.
• NAK - il numero appartiene a un cliente con segreteria automatica. Voys segue il percorso non riuscito.

Tillor confronta il numero del chiamante con il numero di telefono sul profilo cliente, indipendentemente da spazi o notazione del prefisso internazionale. I numeri di telefono delle persone di contatto non contano.

Questo webhook non tiene conto degli orari di apertura. Combinalo con il webhook degli orari di apertura o di instradamento inserendo entrambi come passaggi separati nel piano di chiamata.

Documentazione di Voys: Webhook.

Instradamento fisso per chiamanteCopia il link a questa sezione

Lo stesso Webhook di instradamento può inoltrare subito un chiamante a un apparecchio Voys, a un interno o a un numero di telefono specifico. Questo vale solo per i clienti per i quali hai scelto una destinazione e solo se Instradamento fisso in Voys è attivo.

1. Inserisci il Webhook di instradamento nel piano di chiamata, come per gli orari di apertura
2. Nel passaggio riuscito imposta Variabile destinazione finale
3. In Impostazioni > Integrazioni > Voys, sotto Instradamento chiamate, seleziona Instradamento fisso in Voys

Finché è disattivato, non vedi Instradamento fisso delle chiamate sul profilo cliente. Il webhook usa allora solo l'apparecchio per aperto o chiuso.

Imposta poi la destinazione per singolo cliente:

1. Apri il profilo cliente e vai alla scheda Comunicazioni
2. In Instradamento fisso delle chiamate scegli un apparecchio Voys, oppure Altro per un numero di telefono o un interno (ad esempio 411)
3. Scegli Nessuno per disattivare l'instradamento fisso
4. Fai clic su Salva

Ecco come il webhook di instradamento sceglie la destinazione:

• Se per questo chiamante c'è una destinazione fissa, quella è destination.
• Altrimenti destination è l'apparecchio Voys per aperto o chiuso.
• NAK - non c'è né una destinazione fissa né un apparecchio per lo stato attuale. Vale anche per i numeri sconosciuti e per i chiamanti con numero nascosto, finché non c'è un apparecchio per aperto o chiuso.

Tillor confronta il numero del chiamante con il numero di telefono sul profilo cliente, indipendentemente da spazi o notazione del prefisso internazionale. I numeri di telefono delle persone di contatto non contano.

In caso di errore o timeout Voys prende il percorso non riuscito.

Documentazione di Voys: Webhook.

Cosa succede dopo?Copia il link a questa sezione

• Ogni chiamata in arrivo o in uscita compare in ComunicazioniChiamate telefoniche, con il cliente accanto se il numero corrisponde. Vedi Chiamate telefoniche.
• Quando arriva una chiamata, il chiamante compare come scheda in basso a destra in Tillor, con i dati del cliente.
• Le registrazioni e le trascrizioni arrivano non appena la chiamata è terminata, se le registrazioni delle chiamate sono attive nel tuo account Voys.

Problemi?Copia il link a questa sezione

Vedi ancheCopia il link a questa sezione