Diese API arbeitet mit einem IVR-Objekt im Jtel-System zusammen, das bei eingehenden Anrufen zur Suche nach Datensätzen in SalesForce verwendet werden kann. Die Ergebnisse der durchgeführten Suche stehen als Variablen zur Verfügung und können verwendet werden, um das Routing im Jtel-System zu beeinflussen, z.B. um zu einem bestimmten Agenten oder zu einer bestimmten ACD-Gruppe zu routen. Um diese API nutzen zu können, muss in SalesForce ein REST-Endpunkt bereitgestellt werden, auf den das jtel-System zugreifen kann. Auf den folgenden Seiten wird eine Beispielimplementierung beschrieben. GET Die folgenden Parameter werden in der REST-Anforderung bereitgestellt: | Parameter Name | Ab jtel Release | Beschreibung |
|---|
| CallerID |
| Die Nummer des Anrufers im Format E.164 (voll qualifiziert ohne +). | | ServiceNumber |
| Die angerufene Servicenummer (jtel-Feld ServiceNumbers.Name). | | ServiceName |
| Der Name des aufgerufenen Dienstes (Jtel field ServiceNumbers.Name2). | | Funktion | | Status |
|---|
| |
|---|
| subtle | true |
|---|
| colour | Blue |
|---|
| title | 3.25 / 2021-07-02 UND HÖHERSPÄTER |
|---|
|
| Die auszuführende Funktion. Dieser Parameter kann verwendet werden, um die gewünschte Aktion in der Apex Klasse zu differenzieren und kann für viele Geschäftsfälle verwendet werden. Zum Beispiel, um nach einem Ticket zu suchen. Oder ein Ereignis, um SalesForce zu aktualisieren und ein Objekt zu erstellen. | | UserData | | Status |
|---|
| |
|---|
| subtle | true |
|---|
| colour | Blue |
|---|
| title | 3.25 / 2021-07-02 UND HÖHERSPÄTER |
|---|
|
| Ein benutzerdefinierbarer Parameter, der beliebige Informationen enthalten kann. | | UserData2 | | Status |
|---|
| |
|---|
| subtle | true |
|---|
| colour | Blue |
|---|
| title | 3.25 / 2021-07-02 UND HÖHERSPÄTER |
|---|
|
| Ein benutzerdefinierbarer Parameter, der beliebige Informationen enthalten kann. | | UserData3 | | Status |
|---|
| |
|---|
| subtle | true |
|---|
| colour | Blue |
|---|
| title | 3.25 / 2021-07-02 UND HÖHERSPÄTER |
|---|
|
| Ein benutzerdefinierbarer Parameter, der beliebige Informationen enthalten kann. |
Die folgenden Statuscodes sollten verwendet werden: Status Code | Ab jtel Release | Bedeutung |
|---|
200 – OK |
| Eine Datensatz wurde gefunden und zurückgegeben. | | 300 – Multiple Choices | | Status |
|---|
| |
|---|
| subtle | true |
|---|
| colour | Yellow |
|---|
| title | 3.29 / 2022-08-08 UND FRÜHER |
|---|
|
| Es wurden mehrere Datensätze gefunden. (In diesem Fall sollten keine Datensätze zurückgegeben werden). | 300 – Multiple Choices | | Status |
|---|
| |
|---|
| subtle | true |
|---|
| colour | Blue |
|---|
| title | 3.30 / 2022-08-08 UND SPÄTER |
|---|
|
| Es wurden mehrere Datensätze gefunden. Die Apex-Klasse kann entweder: - keine Datensätze zurückgeben
- einen der gefundenen Datensätze zurückgeben
In diesem Fall sollte, wenn der Datensatz für einen Screen-Pop verwendet werden soll (durch Auffüllen des UserData-Feldes), dem Agenten eine Information gegeben werden, dass tatsächlich mehr als ein Datensatz existiert, z.B. im zusätzlichen Informationsfeld. - alle gefundenen Datensätze in einem Array zurückgeben.
Im letzten Fall wird die Logik in der Routing-Anwendung entsprechend schwieriger, aber die Routing-Anwendung erhält Zugriff auf alle zurückgegebenen Datensätze in Variablen mit zusätzlicher Indizierung. Zum Beispiel $SalesForce.0.ID ... $SalesForce.1.ID und so weiter.
| | 404 – Not found |
| Es wurde kein Datensatz gefunden. |
Die Rückgabestruktur muss JSON sein, aber ansonsten können beliebige Felder und Inhalte zurückgegeben werden. Das jtel-System wird die Daten in Variablen für die jtel IVR-GUI parsen, in der Form $SalesForce.FieldName Wenn Strukturen verschachtelt sind, dann wird die Variable entsprechend benannt: $SalesForce.Entity.FieldName Die Einsicht in das Anrufprotokoll zeigt Ihnen die genauen zurückgegebenen Feldnamen. | 