IBM Cloud Docs
Configurazione integrazione telefono

Configurazione integrazione telefono

IBM Cloud

Dopo aver configurato l'integrazione telefonica per il tuo assistente, puoi modificare le impostazioni dell'integrazione telefonica per personalizzare il comportamento della chiamata.

Gestione degli errori di chiamata e trasferimento

È possibile configurare l'integrazione telefonica per trasferire il chiamante a un agent attivo se la connessione telefonica non riesce per qualsiasi motivo. Per trasferire automaticamente il chiamante a un utente, andare alla scheda Avanzate nelle impostazioni di integrazione del telefono ed effettuare le seguenti selezioni di configurazione:

  • Destinazione SIP quando una chiamata non riesce: aggiungere l'endpoint SIP per il servizio dell'agent di supporto. Specificare un SIP o un URI telefonico per una coda di chiamata generale che può reindirizzare le richieste ad altre code. Per ulteriori informazioni, consultare Configurazione di una soluzione service desk di backup.

  • Messaggio di errore chiamata: aggiungi il messaggio che vuoi che l'assistente dica a un chiamante prima che trasferisca la chiamata a un agent attivo.

Se, dopo aver trasferito la chiamata a un utente, la connessione a un agent attivo non riesce per qualsiasi motivo, è possibile configurare le operazioni da eseguire.

  • Messaggio di errore di trasferimento: aggiungi il messaggio che vuoi che l'assistente dica a un chiamante se il trasferimento a un agent attivo non riesce. Il messaggio può avere una lunghezza massima di 150 caratteri.

  • Disconnetti chiamata in caso di errore di trasferimento: scegliere se disconnettere la chiamata dopo il messaggio di errore. Questa opzione è attivata per impostazione predefinita. Se questa opzione è disabilitata, quando un trasferimento di chiamata ha esito negativo, il tuo assistente può disconnettere o elaborare un'azione diversa.

    Se scegli di lasciare una chiamata connessa nonostante un errore di trasferimento, watsonx Assistant inizia un nuovo turno per determinare il passo successivo. È importante che l'Assistente sia configurato con un'azione o un webhook in grado di gestire questo scenario.

L'integrazione telefonica supporta il ripristino di emergenza fornendo la capacità di eseguire un failover rapido in un'altra regione invece di instradare la chiamata a un agent attivo quando si verifica un'interruzione del servizio. Ciò viene realizzato inviando una risposta SIP 503 al provider di trunking SIP upstream, invece di fare riferimento automaticamente alla chiamata a un agent attivo quando si verificano errori durante l'impostazione di una chiamata. Questa risposta 503 può quindi essere utilizzata dal provider di trunking SIP per reinstradare la chiamata a un'altra regione. Se vuoi sfruttare questa funzionalità, apri un ticket del servizio rispetto all'istanza del servizio watsonx Assistant che richiede il ripristino di emergenza.

Proteggi la connessione telefonica

È possibile aggiungere la sicurezza alla connessione telefonica andando alla scheda Opzioni avanzate nelle impostazioni di integrazione telefonica e selezionando una o entrambe le seguenti opzioni:

  • Forza trunking sicuro: selezionare questa opzione per utilizzare SRTP (Secure Real-Time Transfer Protocol) per proteggere l'audio trasmesso tramite telefono. Per ulteriori informazioni su RTP, vedi Dettagli di instradamento della chiamata.

  • Abilita autenticazione SIP: selezionare questa opzione se si desidera richiedere l'autenticazione digest SIP.

    Quando è necessaria l'autenticazione SIP, tutto il traffico in entrata (ovvero le richieste dal provider SIP al tuo assistente) viene autenticato utilizzando l'autenticazione digest SIP e deve essere inviato utilizzando TLS (Transport Layer Security). Se questa opzione è selezionata, il nome utente e la password digest SIP devono essere configurati e il trunk SIP utilizzato per connettersi a Assistant deve essere configurato per utilizzare solo TLS.

    Se utilizzi Twilio come tuo provider trunk SIP, non puoi abilitare l'autenticazione SIP per i trunk SIP in uscita in watsonx Assistant.

Applicazione delle impostazioni di configurazione trunk SIP avanzata

Per configurare il modo in cui il tuo assistente interagisce con un trunk SIP da un provider esterno, vai alla scheda trunk SIP nelle impostazioni di integrazione telefono e aggiorna le seguenti opzioni nella sezione Integrazione trunking SIP:

  • SIP INVITE headers to extract: elenca le intestazioni che vuoi che il tuo assistente utilizzi.

    La richiesta SIP INVITE può includere metadati relativi alla chiamata nelle intestazioni che possono essere estratti e inviati al tuo assistente utilizzando le variabili di contesto. Ad esempio, molte aziende utilizzano sistemi IVR (Interactive Voice Response) che trasmettono informazioni su una chiamata in entrata utilizzando intestazioni SIP. Se si desidera utilizzare una di queste intestazioni, elencare qui i nomi delle intestazioni.

    Le intestazioni specificate, se presenti nella richiesta, vengono memorizzate nella variabile di contesto sip_custom_invite_headers, insieme ad altri metadati correlati che vengono automaticamente estratti da SIP INVITE. Questa variabile è un array in cui ogni coppia chiave / valore rappresenta un'intestazione dalla richiesta, come in questo esempio:

    {
      "input": {
        "text": "",
          ...
      },
      "context" : {
        "global" : {...},
        "skills" : {...},
        "integrations" : {
          "voice_telephony": {
            "private":{
              "user_phone_number":"+18594213456",
            },  
            "sip_call_id": "Aob2-2743-5678-1234",
            "assistant_phone_number":"+18882346789",
            "sip_custom_invite_headers": {
              "X-customer-name": "my_name",
              "X-account-number": "12345"
            }
          }
        }
      }
    }
    

    Puoi quindi fare riferimento a queste intestazioni nel tuo assistente. Ad esempio, è possibile controllare il valore dell'intestazione in una condizione del passo per determinare il passo successivo. Puoi anche utilizzare queste intestazioni durante la ricerca nei log dell'assistente; ad esempio, potresti cercare un'intestazione personalizzata per trovare tutti i messaggi associati a un particolare account.

  • Disabilitare l'anello che i chiamanti ascoltano mentre l'assistente viene contattato: scegliere se si desidera che il chiamante ascolti un segnale che indica che l'assistente è stato contattato.

    Viene inviata una risposta 180 Ringing dall'assistente al provider del trunk SIP mentre il tuo assistente elabora l'invito alla chiamata in entrata. La risposta di chiamata viene inviata per impostazione predefinita.

  • Non mettere in attesa i chiamanti durante il trasferimento a un agente attivo: scegliere se l'integrazione telefonica mette in attesa il chiamante.

    Se il provider trunk SIP gestisce le sospensioni, disabilitare questa funzione. Ad esempio, alcuni provider di trunk SIP preferiscono che l'assistente invii una richiesta SIP REFERENCE, in modo che possano mettere la chiamata in attesa.

Per ulteriori informazioni sul protocollo SIP, consultare RFC 3261 e sul protocollo RTP, consultare RFC 3550.

Configurazione di una soluzione service desk di backup

Quando si utilizza l'integrazione del telefono come prima linea di assistenza per i clienti, è una buona idea avere un backup dell'agent in tempo reale disponibile. Puoi progettare il tuo assistente per trasferire una chiamata a un utente nel caso in cui la connessione del telefono non riesca o se un utente chiede di parlare con qualcuno.

L'azienda potrebbe già avere uno o più numeri di telefono che si collegano a un ACD (automatic call dispatcher), che può accodare i chiamanti fino a quando non è disponibile un agent appropriato. In caso contrario, scegliere una soluzione di service desk da utilizzare come backup.

Una conversazione non può essere trasferita da un tipo di integrazione a un altro. Ad esempio, se si utilizza l'integrazione della chat web con il supporto service desk, non è possibile trasferire una chiamata telefonica al service desk configurato per la chat web.

È necessario fornire l'URI SIP del service desk per la soluzione di supporto del service desk utilizzata. Devi specificare queste informazioni nel tuo assistente quando abiliti un trasferimento di chiamata da un nodo di dialogo o un passo dell'azione. Per ulteriori informazioni, consultare Trasferimento di una chiamata a un agent attivo.

Ottimizza le tue azioni per l'interazione telefonica

Per la migliore esperienza del cliente, progetta il tuo dialogo con le funzionalità dell'integrazione del telefono in mente:

  • Non includere elementi HTML nelle risposte di azione. Per aggiungere la formattazione, utilizzare Markdown. Per ulteriori informazioni, vedi Formattazione delle risposte.

  • È possibile utilizzare un'estensione di ricerca per includere i risultati della ricerca nelle azioni che l'integrazione telefonica leggerà. Quando vengono restituiti i risultati della ricerca, l'integrazione telefonica legge il messaggio introduttivo (ad esempio, I found this information that might be helpful) e quindi il corpo solo del primo risultato della ricerca.

    L'intera risposta di ricerca (il che significa che il messaggio introduttivo più il corpo del primo risultato della ricerca) deve essere inferiore a 5.000 caratteri o la risposta non verrà letta affatto. Assicurarsi di verificare i risultati della ricerca che vengono restituiti e di curare la raccolta dati che si utilizza come necessario.

Per ulteriori informazioni sull'utilizzo dell'integrazione di ricerca, vedi Utilizzo del contenuto della guida esistente.

Per ulteriori informazioni su come implementare azioni comuni dal tuo dialogo, vedi Gestione delle interazioni telefoniche.

creazione di un trunk SIP

Se non si utilizza l'opzione per generare un numero di telefono gratuito, è necessario impostare il trunk SIP utilizzato dall'integrazione telefonica. Trova un provider e crea un account trunk SIP, per cui devi pagare per ogni utilizzo.

È possibile impostare un trunk SIP nei modi seguenti:

Configurazione di un trunk SIP Twilio

Prima di iniziare la configurazione di un Twilio SIP Trunk, effettuare le seguenti operazioni prerequisite:

Se hai già creato un trunk SIP, segui la procedura in Configura un trunk SIP.

Crea un trunk SIP

  1. Accedere alla console Twilio e andare alla sezione Elastic SIP Trunking.

    Nota: se non viene visualizzato Elastic SIP Trunking, procedere come segue:

    1. Cercare Elastic SIP Trunking nella barra di ricerca.
    2. Fare clic su Elastic SIP Trunking Dashboard.
  2. Nel menu di navigazione a sinistra, andare su Panoramica e fare clic su Inizia.

  3. Fare clic su Crea nuovo tronco nella barra di navigazione Tronchi.

  4. Inserite un nome per il vostro trunk SIP nel campo NOME AMICO.

  5. Fai clic sul pulsante Create. Un SID del tronco viene assegnato una volta creato un nuovo tronco.

Per la configurazione di un trunk SIP, attenersi alla procedura in Configurazione di un trunk SIP.

Configurare il trunk SIP

Per configurare un trunk SIP, effettuare le seguenti operazioni:

  1. Dalla pagina Elastic SIP Trunking Dashboard, vai a Elastic SIP Trunking.

  2. Fare clic su Gestisci nel menu di navigazione a sinistra.

  3. Fai clic su Trunks e seleziona il trunk SIP che hai creato.

  4. Fare clic su Origine per configurare le impostazioni.

  5. Per aggiungere l'URI SIP di origine, fare clic sul pulsante Aggiungi nuovo URI di origine e fornire i valori dei seguenti campi:

    • URI SIP di origine- È possibile ottenere l'URI SIP per l'integrazione telefonica nella pagina di configurazione dell'integrazione telefonica di watsonx Assistant. Per farlo in watsonx Assistant, lanciare il tooling e creare l'assistente. Scegliere Aggiungi integrazione e selezionare Telefono. Dal tuo assistente, copia l'URI SIP e incollalo nel campo URI SIP di origine di Twilio.
    • Priorità- La priorità classifica l'importanza dell'URI. Un numero inferiore rappresenta la massima importanza.
    • Peso- Il peso viene utilizzato per stabilire la condivisione del carico quando più URI hanno la stessa priorità. Maggiore è il valore, maggiore è il carico di un URI.
    • Abilitato- È necessario passare all'opzione Abilitato in Yes. Ciò significa che l'URI SIP di origine è abilitato.
  6. Se si prevede di supportare i trasferimenti di chiamata, abilitare il trasferimento di chiamata (SIP FARE) nel trunk SIP. Se si prevede di trasferire chiamate alla rete telefonica pubblica commutata (PSTN), abilitare anche il trasferimento PSTN sul trunk.

  7. Seleziona Numbers dalla barra di navigazione per il tuo trunk SIP ed esegui una delle seguenti operazioni:

    1. Fare clic su Aggiungi un numero e quindi su Acquista un numero*.
    2. Se si dispone già di un numero, è possibile fare clic su Aggiungi un numero e quindi su Aggiungi un numero esistente.

Se utilizzi un account Twilio di prova o Lite per scopi di test, assicurati di verificare la destinazione del trasferimento. Per ulteriori informazioni, vedi la documentazione di Twilio.

Non puoi abilitare l'autenticazione SIP se scegli Twilio come tuo provider trunk SIP. Twilio non supporta SIPS per le chiamate di origine.

Utilizzo di altri provider di terze parti

Puoi chiedere aiuto per configurare un account con un altro provider trunk SIP aprendo una richiesta di assistenza.

IBM ha stabilito relazioni con i seguenti provider trunk SIP:

Il provider trunk SIP imposta un trunk SIP per il tuo traffico vocale e gestisce l'accesso dagli indirizzi IP consentiti. La maggior parte dei principali provider di trunk SIP hanno relazioni esistenti con IBM. Pertanto, la configurazione di rete richiesta per supportare la connessione trunk SIP in genere può essere gestita per conto dell'utente con il minimo sforzo.

  1. Crea un caso IBM Cloud.

  2. Nel campo Argomento, immettere watsonx Assistant.

  3. Nell'elenco a discesa Sottoargomento, selezionare Phone & SMS Integration.

  4. Nel campo Oggetto, immettere SIP trunk provider setup for watsonx Assistant.

  5. Includere le seguenti informazioni nella descrizione:

    • Nome azienda
    • Il tuo ID account IBM Cloud
    • Il nome del tuo servizio watsonx Assistant
    • Diagramma di rete con indirizzo IP o informazioni sul provider di trunk SIP

Porta il tuo tronco SIP

Se si sceglie di utilizzare un vettore trunk SIP con cui IBM non ha una relazione stabilita, è possibile farlo.

La seguente tabella elenca i nomi dominio completi e gli indirizzi IP utilizzati per connessioni SIP.

Informazioni sulla rete SIP
Posizione Nomi dominio Indirizzi IP
Dallas public.0001.voip.us-south.assistant.watson.cloud.ibm.com
public.0002.voip.us-south.assistant.watson.cloud.ibm.com
public.0003.voip.us-south.assistant.watson.cloud.ibm.com
67.228.108.82
169.63.5.162
150.239.30.146
Francoforte public.0001.voip.eu-de.assistant.watson.cloud.ibm.com
public.0002.voip.eu-de.assistant.watson.cloud.ibm.com
public.0003.voip.eu - de.assistant.watson.cloud.ibm.com
161.156.178.162
169.50.56.146
149.81.86.82
Londra public.0001.voip.eu-gb.assistant.watson.cloud.ibm.com
public.0002.voip.eu-gb.assistant.watson.cloud.ibm.com
public.0003.voip.eu-gbassistant.watson.cloud.ibm.com
158.176.120.162
141.125.102.34
158.175.99.34
Seoul public.0001.voip.kr-seo.assistant.watson.cloud.ibm.com
Sydney public.0001.voip.au-syd.assistant.watson.cloud.ibm.com
public.0002.voip.au-syd.assistant.watson.cloud.ibm.com
public.0003.voip.au-sydassistant.watson.cloud.ibm.com
168.1.47.2
135.90.86.50
168.1.106.130
Tokyo public.0001.voip.jp-tok.assistant.watson.cloud.ibm.com
public.0002.voip.jp-tok.assistant.watson.cloud.ibm.com
public.0003.voip.jp-tokassistant.watson.cloud.ibm.com
165.192.69.82
128.168.105.178
161.202.149.162
Washington, DC public.0001.voip.us-east.assistant.watson.cloud.ibm.com
public.0002.voip.us-east.assistant.watson.cloud.ibm.com
public.0003.voip.us-east.assistant.watson.cloud.ibm.com
52.116.100.158
169.61.70.162
169.59.136.194

Migrazione da Voice Agent with Watson

Se hai creato un'istanza del servizio IBM® Voice Agent with Watson in IBM Cloud per consentire ai clienti di connettersi a un assistente tramite telefono, prendi in considerazione di utilizzare invece l'integrazione telefonica. Puoi utilizzare lo stesso account SIP e lo stesso numero di telefono che hai configurato per l'utilizzo con Voice Agent with Watson nell'integrazione telefonica.

L'integrazione del telefono fornisce un'integrazione più completa con il tuo assistente. Tuttavia, attualmente l'integrazione non supporta le seguenti funzioni:

  • Chiamata in uscita
  • Configurazione delle ubicazioni di backup
  • Inoltro di eventi per il salvataggio di report di dettaglio delle chiamate nel servizio database IBM Cloudant for IBM Cloud
  • Revisione della pagina di riepilogo dell'utilizzo. Utilizzare invece IBM Log Analysis. Per ulteriori informazioni, vedi Visualizzazione dei log.

Per migrare da Voice Agent with Watson all'integrazione telefonica watsonx Assistant, completa la seguente procedura:

  1. Dalla pagina Voice Agent with Watson, copia il o i numeri di telefono che hai utilizzato per il tuo account SIP.

  2. Quando imposti l'integrazione telefonica watsonx Assistant, aggiungi il numero di telefono o la serie di numeri che hai copiato nel passo precedente.

  3. Dalla pagina di configurazione dell'integrazione telefonica, copiare l'URI (uniform resource identifier) SIP.

  4. Nel tuo account trunk SIP, sostituisci l'URI Voice Agent with Watson che hai specificato in precedenza con l'URI che hai copiato dalla pagina di configurazione dell'integrazione telefonica nel passo precedente.

    Ad esempio, se utilizzi un trunk SIP Twilio, aggiungi l'URI (uniform resource identifier) SIP dell'assistente al campo URI SIP di origine Twilio.

  5. Se il tuo provider trunk SIP non è ancora consentito con la regione watsonx Assistant in cui stai migrando, segui queste istruzioni per accedere al tuo trunk SIP.

Dettagli instradamento chiamata

Le chiamate in ingresso al tuo assistente seguono questo percorso:

  1. Un cliente chiama il numero di telefono del supporto clienti gestito dal provider trunk SIP (Session Initiation Protocol).

  2. Il servizio di trunk SIP invia una richiesta SIP INVITE all'integrazione telefonica dell'assistente per stabilire una connessione.

  3. L'integrazione telefonica si connette ai servizi vocali richiesti per supportare l'interazione.

  4. Una volta che i servizi sono pronti, la connessione viene stabilita e l'audio viene inviato tramite RTP (Real-time Transport Protocol).

    RTP è un protocollo di rete per la distribuzione di audio e video su reti IP.

  5. Viene elaborata l'azione di saluto dell'assistente. Il testo della risposta viene inviato al servizio Text to Speech per essere convertito in audio e l'audio viene inviato al chiamante.

  6. Quando il cliente dice qualcosa, l'audio viene convertito in testo dal servizio Speech to Text e viene inviato al tuo assistente per la valutazione.

  7. L'assistente elabora l'input e calcola la risposta migliore. Il testo della risposta dall'assistente viene inviato al servizio Text to Speech per essere convertito in audio e l'audio viene inviato nuovamente al chiamante tramite la connessione esistente.

  8. Se il chiamante chiede di parlare con una persona, l'assistente può trasferire la persona a un call center. Una richiesta SIP REFER viene inviata al provider trunk SIP in modo che possa trasferire la chiamata all'URI SIP del call center specificato nel nodo di dialogo in cui è configurata l'azione di trasferimento.

  9. Quando uno dei partecipanti alla chiamata riaggancia, viene inviata una richiesta SIP BYE all'altro partecipante.