Konfiguration der Telefonintegration
IBM Cloud
Nachdem Sie die Telefonintegration für Ihren Assistenten konfiguriert haben, können Sie die Einstellungen für die Telefonintegration ändern, um das Anrufverhalten anzupassen.
Handhabung von Anruf- und Übertragungsfehlern
Sie können die Telefonintegration so konfigurieren, dass der Anrufer an einen Live-Agenten weitergeleitet wird, falls die Telefonverbindung aus irgendeinem Grund unterbrochen wird. Um den Anrufer automatisch an einen Menschen weiterzuleiten, gehen Sie in den Einstellungen für die Telefonintegration auf die Registerkarte "Erweitert" und treffen Sie die folgenden Konfigurationsauswahlen:
-
SIP-Ziel bei Anruffehler: Fügen Sie den SIP-Endpunkt für Ihren Supportmitarbeiter hinzu. Geben Sie einen SIP- oder Telefon-URI für eine allgemeine Anrufwarteschlange an, die Anfragen an andere Warteschlagen weiterleiten kann. Weitere Informationen finden Sie unter Backup-Service-Desk-Lösung konfigurieren.
-
Fehlermeldung bei Anruf: Fügen Sie die Nachricht hinzu, die der Assistent einem Anrufer mitteilen soll, bevor er den Anruf an einen Live-Agenten weiterleitet.
Wenn nach der Weiterleitung des Anrufs an einen Mitarbeiter die Verbindung zu einem Live-Agenten aus irgendeinem Grund fehlschlägt, können Sie festlegen, was zu tun ist.
-
Meldung bei fehlgeschlagener Weiterleitung: Fügen Sie die Meldung hinzu, die der Assistent einem Anrufer mitteilen soll, wenn die Weiterleitung an einen Live-Agenten fehlschlägt. Die Nachricht darf bis zu 150 Zeichen lang sein.
-
Anruf bei Übertragungsfehler trennen: Wählen Sie aus, ob der Anruf nach der Fehlernachricht unterbrochen werden soll. Diese Option wird standardmäßig aktiviert. Wenn diese Option inaktiviert ist und eine Anrufübergabe fehlschlägt, kann der Assistent die Verbindung trennen oder eine andere Aktion verarbeiten.
Wenn Sie einen Anruf trotz eines Übertragungsfehlers verbunden lassen möchten, leitet watsonx Assistant einen neuen Turnus ein, um den nächsten Schritt zu bestimmen. Es ist wichtig, dass der Assistent mit einer Aktion oder einem Webhook konfiguriert wird, der dieses Szenario verarbeiten kann.
Die Telefonintegration unterstützt die Disaster-Recovery, indem sie die Möglichkeit bietet, einen schnellen Failover auf eine andere Region durchzuführen, anstatt den Anruf an einen Live-Agenten weiterzuleiten, wenn es zu einem Serviceausfall kommt. Dies wird erreicht, indem eine SIP 503-Antwort an den vorgeschalteten SIP-Trunking-Provider gesendet wird, anstatt den Anruf automatisch an einen Live-Agenten zu leiten, wenn während der Einrichtung eines Anrufs Fehler auftreten. Diese 503-Antwort kann dann vom SIP-Trunking-Provider verwendet werden, um den Anruf an eine andere Region weiterzuleiten. Wenn Sie diese Funktion nutzen möchten, öffnen Sie ein Service-Ticket für die watsonx Assistant-Serviceinstanz, für die eine Notfallwiederherstellung (Disaster-Recovery) erforderlich ist.
Televonverbindung schützen
Sie können der Telefonverbindung Sicherheitsmechanismen hinzufügen, indem Sie die Registerkarte Erweiterte Optionen in den Einstellungen der Telefonintegration aufrufen und eine oder beide der folgenden Optionen auswählen:
-
Sicheres Trunking erzwingen: Wählen Sie diese Option aus, um Secure Real-Time Transfer Protocol (SRTP) zum Sichern der über das Telefon übertragenen Audiodaten zu verwenden. Weitere Informationen zu RTP finden Sie im Abschnitt Details für Rufrouting.
-
SIP-Authentifizierung aktivieren: Wählen Sie diese Option aus, wenn die SIP-Digest-Authentifizierung erforderlich sein soll.
Wenn die SIP-Authentifizierung erforderlich ist, wird der gesamte eingehende Datenverkehr (d. h. Anforderungen vom SIP-Provider an Ihren Assistenten) mithilfe der SIP-Digest-Authentifizierung authentifiziert und muss mit TLS (Transport Layer Security) gesendet werden. Wenn diese Option ausgewählt ist, müssen der Benutzername und das Kennwort für den SIP-Digest konfiguriert werden, und der SIP-Trunk, der für die Verbindung zum Assistent verwendet wird, muss so konfiguriert werden, dass nur TLS verwendet wird.
Wenn Sie Twilio als Ihren SIP-Trunk-Anbieter verwenden, können Sie die SIP-Authentifizierung für ausgehende SIP-Trunks zu watsonx Assistant nicht aktivieren.
Erweiterte Konfigurationseinstellungen für SIP-Trunks anwenden
Um zu konfigurieren, wie Ihr Assistent mit einem SIP-Trunk von einem externen Provider interagiert, rufen Sie die Registerkarte SIP-Trunk in den Einstellungen der Telefonintegration auf und aktualisieren Sie die folgenden Optionen im Abschnitt Integration von SIP-Trunking:
-
Zu extrahierende SIP-INVITE-Header: Listen Sie die Header auf, die Ihr Assistent verwenden soll.
Die SIP-Anforderung INVITE kann Metadaten zum Aufruf in Headern enthalten, die extrahiert und über Kontextvariablen an Ihren Assistenten gesendet werden können. Viele Unternehmen verwenden beispielsweise IVR-Systeme (Interactive Voice Response), die Informationen zu einem eingehenden Anruf mithilfe von SIP-Headern übergeben. Wenn Sie solche Header verwenden möchten, listen Sie die betreffenden Header hier auf.
Die angegebenen Header (sofern in der Anforderung vorhanden) werden in der Kontextvariablen
sip_custom_invite_headers
zusammen mit anderen zugehörigen Metadaten gespeichert, die automatisch von der SIP-Anforderung INVITE extrahiert werden. Diese Variable ist ein Array, in dem jedes Schlüssel/Wert-Paar einen Header aus der Anforderung darstellt, wie im folgenden Beispiel:{ "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" } } } } }
Anschließend können Sie in Ihrem Assistenten auf diese Header verweisen. Sie können beispielsweise den Headerwert in einer Schrittbedingung überprüfen, um den nächsten Schritt festzulegen. Sie können diese Header auch beim Durchsuchen der Assistentprotokolle verwenden. Sie können beispielsweise nach einem angepassten Header suchen, um alle Nachrichten zu finden, die einem bestimmten Konto zugeordnet sind.
-
Deaktivieren Sie den Klingelton, den Anrufer hören, während der Assistent kontaktiert wird: Wählen Sie aus, ob der Anrufer ein Signal hören soll, das anzeigt, dass der Assistent kontaktiert wird.
Eine Antwort
180 Ringing
wird vom Assistenten an den Provider der SIP-Amtsleitung zurückgegeben, während Ihr Assistent die eingehende Anrufeinladung verarbeitet. Der Ruftonantwort wird standardmäßig gesendet. -
Anrufer bei Übergabe an Live-Agenten nicht in Wartemodus schalten: Wählen Sie aus, ob die Telefonintegration den Anrufer in den Wartemodus versetzt.
Inaktivieren Sie diese Funktion, wenn Wartestatus von Ihrem Provider der SIP-Amtsleitung verwaltet werden. Beispiel: Manche Provider von SIP-Amtsleitungen möchten, dass der Assistent eine SIP-Anforderung REFER sendet, damit sie den Anruf selbst in den Wartemodus versetzen können.
Weitere Informationen zum SIP-Protokoll finden Sie unter RFC 3261 und zum RTP-Protokoll unter RFC 3550.
Backup-Service-Desk-Lösung konfigurieren
Wenn Sie die Telefonintegration als erste Anlaufstelle für Kunden nutzen, ist es eine gute Idee, einen Live-Agenten als Backup zur Verfügung zu haben. Sie können Ihren Assistenten so gestalten, dass er einen Anruf an eine Person überträgt, falls die Telefonverbindung fehlschlägt oder ein Benutzer fragt, ob er mit einer Person sprechen kann.
Ihr Unternehmen verfügt möglicherweise bereits über eine oder mehrere Telefonnummern, die mit einem automatischen Anrufverteiler (ACD) verbunden sind, der Anrufer in eine Warteschlange stellen kann, bis ein geeigneter Mitarbeiter verfügbar ist. Wenn nicht, wählen Sie eine Service-Desk-Lösung als Backup.
Ein Dialog kann nicht von einem Integrationstyp in einen anderen übertragen werden. Wenn Sie beispielsweise die Web-Chat-Integration mit Service-Desk-Unterstützung verwenden, ist es nicht möglich, einen Telefonanruf an das für den Web-Chat eingerichtete Service-Desk zu übertragen.
Sie müssen den Service-Desk-SIP-URI für die von Ihnen verwendete Service-Desk-Support-Lösung bereitstellen. Sie müssen diese Informationen im Assistenten angeben, wenn Sie eine Anrufübergabe über einen Dialogmodulknoten oder Aktionsschritt aktivieren. Weitere Informationen finden Sie unter Anruf an einen Live-Agenten übertragen.
Aktionen für die Telefoninteraktion optimieren
Für ein optimiertes Kundenerlebnis sollten Sie beim Entwerfen Ihres Dialogmoduls die Leistungsmerkmale der Telefonintegration berücksichtigen:
-
Schließen Sie keine HTML-Elemente in Ihre Aktionsantworten ein. Verwenden Sie Markdown, um Formatierung hinzuzufügen. Weitere Informationen finden Sie unter Antworten formatieren.
-
Sie können eine Sucherweiterung verwenden, um Suchergebnisse in Aktionen einzuschließen, die von der Telefonintegration gelesen werden. Wenn Suchergebnisse zurückgegeben werden, liest die Telefonintegration die einleitende Nachricht (z. B.
I found this information that might be helpful
) und dann nur den Hauptteil des ersten Suchergebnisses.Die gesamte Suchantwort (d. h. die einleitende Nachricht plus der Hauptteil des ersten Suchergebnisses) darf höchstens 5.000 Zeichen lang sein; andernfalls wird die Antwort überhaupt nicht gelesen. Testen Sie die zurückgegebenen Suchergebnisse und stellen Sie die verwendete Datensammlung entsprechend zusammen.
Weitere Informationen zur Verwendung der Suchintegration finden Sie unter Nutzung vorhandener Hilfeinhalte.
Weitere Informationen zum Implementieren allgemeiner Aktionen über Ihr Dialogmodul finden Sie unter Handhabung von Telefoninteraktionen.
SIP-Trunk erstellen
Wenn Sie die Option zur Generierung einer kostenlosen Telefonnummer nicht nutzen, müssen Sie den SIP-Trunk einrichten, der von der Telefonintegration verwendet wird. Suchen Sie einen Provider und erstellen Sie ein SIP-Trunk-Konto, für das Sie pro Nutzung bezahlen müssen.
Sie können einen SIP-Trunk wie folgt einrichten:
- Twilio-SIP-Trunk einrichten
- Andere Drittanbieter verwenden
- Eigenen SIP-Trunk verwenden
- Migration von Voice Agent with Watson
Einrichten eines Twilio-SIP-Trunks
Bevor Sie mit der Konfiguration eines Twilio-SIP-Trunk beginnen, führen Sie die folgenden vorausgesetzten Schritte aus:
- Erstellen Sie ein Twilio-Konto auf der Twilio-Website.
- SIP-Trunk erstellen
Wenn Sie bereits einen SIP-Trunk erstellt haben, führen Sie die Schritte unter SIP-Trunk konfigurieren aus.
SIP-Trunk erstellen
-
Melden Sie sich bei Ihrer Twilio-Konsole an und gehen Sie zum Abschnitt "Elastic SIP Trunking ".
Hinweis: Wenn Sie "Elastic SIP Trunking" nicht sehen, gehen Sie wie folgt vor:
- Suchen Sie in der Suchleiste nach
Elastic SIP Trunking
. - Klicken Sie auf Elastic SIP-Trunking-Dashboard.
- Suchen Sie in der Suchleiste nach
-
Gehen Sie im linken Navigationsmenü zu "Übersicht" und klicken Sie auf "Loslegen ".
-
Klicken Sie in der Navigationsleiste auf "Neue Trunks erstellen ".
-
Geben Sie einen Namen für Ihren SIP-Trunk in das Feld "FREUNDLICHER NAME" ein.
-
Klicken Sie auf die Schaltfläche Erstellen. Eine Trunk-SID wird zugewiesen, sobald Sie einen neuen Trunk erstellen.
Führen Sie für die Konfiguration eines SIP-Trunks die Schritte unter SIP-Trunk konfigurieren aus.
SIP-Trunk konfigurieren
Gehen Sie wie folgt vor, um einen SIP-Trunk zu konfigurieren:
-
Wechseln Sie auf der Seite Elastic SIP Trunking Dashboard zu Elastic SIP Trunking.
-
Klicken Sie im linken Navigationsmenü auf "Verwalten ".
-
Klicken Sie auf Trunks und wählen Sie den erstellten SIP-Trunk aus.
-
Klicken Sie auf "Ursprung ", um die Einstellungen zu konfigurieren.
-
Um die Ursprungs-SIP-URI hinzuzufügen, klicken Sie auf die Schaltfläche "Neue Ursprungs-URI hinzufügen " und geben Sie Werte für die folgenden Felder ein:
- SIP-URI für die Erstellung – Die SIP-URI für Ihre Telefonintegration erhalten Sie auf der Konfigurationsseite für die Telefonintegration von watsonx Assistant. Um dies in watsonx Assistant zu tun, starten Sie das Tooling und den Assistenten zum Erstellen. Wählen Sie Integration hinzufügen und dann Telefon aus. Kopieren Sie in Ihrem Assistenten den SIP-URI und fügen Sie ihn im Feld Ursprungs-SIP-URI von Twilio ein.
- Priorität-Die Priorität stuft den Stellenwert des URI ein. Eine niedrigere Zahl steht für den höchsten Stellenwert.
- Wertigkeit-Die Wertigkeit wird verwendet, um den Anteil der Last zu ermitteln, wenn mehrere URIs dieselbe Priorität haben. Je höher der Wert ist, desto mehr wird ein URI geladen.
- Aktiviert-Sie müssen den Schalter Aktiviert auf
Yes
setzen. Dies bedeutet, dass der Ursprungs-SIP-URI aktiviert ist.
-
Wenn Sie die Anrufübergabe unterstützen wollen, aktivieren Sie in Ihrem SIP-Trunk die Anrufübergabe (SIP REFER). Wenn Sie erwarten, Anrufe an das öffentliche Telefonnetz zu übertragen (PSTN), aktivieren Sie auch die PSTN-Übertragung auf Ihrem Trunk.
-
Wählen Sie in der Navigationsleiste die Option "Nummern" für Ihren SIP-Trunk aus und führen Sie dann eine der folgenden Aktionen aus:
- Klicken Sie auf Nummer hinzufügen und anschließend auf Nummer kaufen*.
- Wenn Sie bereits über eine Zahl verfügen, können Sie auf Zahl hinzufügen und anschließend auf Vorhandene Zahl hinzufügenklicken.
Wenn Sie ein Twilio-Konto mit Lite- oder Trial-Plan für Testzwecke verwenden, vergewissern Sie sich, dass das Übergabeziel verifiziert wurde. Weitere Informationen finden Sie in der Twilio-Dokumentation.
Die SIP-Authentifizierung darf nicht aktiviert werden, wenn Sie Twilio als Provider für die SIP-Amtsleitung verwenden. Twilio bietet keine SIPS-Unterstützung für ursprüngliche Anrufe.
Andere Provider verwenden
Unterstützung zum Einrichten eines Kontos bei einem anderen Provider für SIP-Amtsleitungen können Sie durch eine Support-Anfrage anfordern.
IBM hat Partnerschaften zu den folgenden SIP-Trunk-Providern aufgebaut:
Der betreffende Provider richtet eine SIP-Amtsleitung für Ihren Sprachdatenverkehr ein und verwaltet den Zugriff über die zulässigen IP-Adressen. Die meisten bedeutenden Provider von SIP-Amtsleitungen führen Geschäftsbeziehungen mit IBM. Daher kann die erforderliche Netzkonfiguration zur Unterstützung der Verbindung für SIP-Amtsleitungen in der Regel ohne großen Aufwand für Sie eingerichtet werden.
-
Erstellen Sie einen IBM Cloud-Fall.
-
Geben Sie im Feld Thema
watsonx Assistant
ein. -
Wählen Sie in der Dropdown-Liste Unterthema
Phone & SMS Integration
aus. -
Geben Sie im Feld Betreff
SIP trunk provider setup for watsonx Assistant
ein. -
Geben Sie in der Beschreibung die folgenden Informationen an:
- Name des Unternehmens
- Ihre IBM Cloud-Konto-ID
- Ihr watsonx Assistant-Servicename
- Netzdiagramm mit IP-Adresse oder die Informationen für den Provider der SIP-Amtsleitung
Eigenen SIP-Trunk verwenden
Wenn Sie einen SIP-Trunk-Carrier verwenden möchten, zu dem IBM keine etablierte Partnerschaft hat, ist dies ebenfalls möglich.
In der folgenden Tabelle sind die vollständig qualifizierten Domänennamen und IP-Adressen aufgelistet, die für SIP-Verbindungen verwendet werden.
Standort | Domänennamen | IP-Adressen |
---|---|---|
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 |
Frankfurt | 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 |
London | public.0001.voip.eu-gb.assistant.watson.cloud.ibm.com public.0002.voip.eu-gb.assistant.watson.cloud.ibm.com public.0003.voip.eu-gb.assistant.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-syd.assistant.watson.cloud.ibm.com |
168.1.47.2 135.90.86.50 168.1.106.130 |
Tokio | public.0001.voip.jp-tok.assistant.watson.cloud.ibm.com public.0002.voip.jp-tok.assistant.watson.cloud.ibm.com public.0003.voip.jp-tok.assistant.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 |
Migration von Voice Agent with Watson
Wenn Sie eine IBM® Voice Agent with Watson-Serviceinstanz in IBM Cloud erstellt haben, damit Kunden über das Telefon eine Verbindung zu einem Assistenten herstellen können, können Sie stattdessen die Telefonintegration verwenden. Sie können dasselbe SIP-Konto und dieselbe SIP-Telefonnummer verwenden, die Sie für die Verwendung mit Voice Agent with Watson in der Telefonintegration konfiguriert haben.
Die Telefonintegration bietet eine nahtlose Integration mit Ihrem Assistenten. Die Integration unterstützt derzeit jedoch die folgenden Funktionen nicht:
- Abgehende Aufrufe
- Backup-Positionen konfigurieren
- Weiterleitung von Ereignissen zur Speicherung von Anrufdetailberichten im Datenbankdienst IBM Cloudant for IBM Cloud
- Überprüfung der Übersichtsseite für die Nutzung. Verwenden Sie stattdessen IBM Log Analysis. Weitere Informationen finden Sie unter Protokolle anzeigen.
Führen Sie die folgenden Schritte aus, um eine Migration von Voice Agent with Watson auf die watsonx Assistant-Telefonintegration durchzuführen:
-
Kopieren Sie auf der Seite Voice Agent with Watson die Telefonnummern, die Sie für Ihr SIP-Konto verwendet haben.
-
Wenn Sie die watsonx Assistant-Telefonintegration einrichten, fügen Sie die Telefonnummer oder die Gruppe von Nummern hinzu, die Sie im vorherigen Schritt kopiert haben.
-
Kopieren Sie auf der Konfigurationsseite für die Telefonintegration den SIP-URI (Uniform Resource Identifier).
-
Ersetzen Sie in Ihrem SIP-Trunk-Konto den zuvor angegebenen Voice Agent with Watson-URI durch den URI, den Sie im vorherigen Schritt von der Konfigurationsseite für die Telefonintegration kopiert haben.
Wenn Sie beispielsweise einen Twilio-SIP-Trunk verwenden, fügen Sie den SIP-URI des Assistenten zum Twilio-Feld Ursprungs-SIP-URI hinzu.
-
Wenn Ihr SIP-Trunk-Provider noch nicht in der Zulassungsliste der watsonx Assistant-Region aufgeführt ist, auf die Sie migrieren, folgen Sie diesen Anweisungen, um Zugriff auf Ihren SIP-Trunk zu erhalten.
Details für Rufrouting
Eingehende Anrufe für Ihren Assistenten folgen diesem Pfad:
-
Ein Kunde wählt die Rufnummer der Kundenunterstützung, die von Ihrem Provider für SIP-Amtsleitungen (SIP = Session Initiation Protocol) verwaltet wird.
-
Der SIP-Trunk-Dienst sendet eine SIP-
INVITE
-Anfrage an die Telefonintegration Ihres Assistenten, um eine Verbindung herzustellen. -
Die Telefonintegration stellt die Verbindung zu den Sprachservices her, die zum Unterstützen der Interaktion erforderlich sind.
-
Sobald die Services betriebsbereit sind, wird die Verbindung aufgebaut und Audiodaten werden über das RTP-Protokoll (Real-time Transport Protocol) gesendet.
RTP ist ein Netzprotokoll zur Übertragung von Audio- und Videodaten in IP-Netzen.
-
Die Begrüßungsaktion des Assistenten wird verarbeitet. Der Antworttext wird an den Text to Speech-Service gesendet und in Audiodaten umgewandelt, die an den Anrufer gesendet werden.
-
Wenn der Kunde etwas sagt, werden die Audiodaten vom Speech to Text-Service in Text konvertiert und zur Auswertung an Ihren Assistenten gesendet.
-
Der Assistent verarbeitet die Eingabe und berechnet die beste Antwort. Der Antworttext vom Assistenten wird an den Text to Speech-Service gesendet, um in Audiodaten konvertiert zu werden. Die Audiodaten werden dann über die vorhandene Verbindung an den Anrufer zurückgesendet.
-
Wenn der Anrufer mit einem Servicemitarbeiter sprechen möchte, kann der Assistent den Anruf an ein Call-Center übergeben. Eine SIP-Anforderung
REFER
wird an den Provider der SIP-Amtsleitung gesendet, damit der Anruf an den SIP-URI des Call-Centers weitergeleitet werden kann, der in dem Dialogmodulknoten angegeben ist, in dem die Übergabeaktion konfiguriert ist. -
Wenn einer der Teilnehmer des Anrufs auflegt, wird eine SIP-Anfrage
BYE
an den anderen Teilnehmer gesendet.