Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languageen

Introduction

Have you ever wondered why the jtel System has so many variables available in the configuration of the Service Number parameters?

The following screenshots show you the parameters currently available.

  • So why so many?
  • And why does the list keep on growing with every release?
  • And what can I do with them?

Demo Scenario

To help you understand, let's consider a simple demo scenario where the system is shared by several branch offices.

Imagine, you need to build an IVR application which needs to do the following on the Munich service number:

  • During office hours of the Munich branch
    • play a welcome prompt "Welcome to our Munich branch"
    • Ask the caller to press 1 for sales and 2 for technical support
    • Connect to either sales or technical support, depending on the choice the caller makes
  • Outside of Munich office hours or on German Holidays, play a prompt with the opening times of the Munich branch

You might build the application a little like this:

Then, a week later, you get a request to build the following application for the Amsterdam branch service number:

  • During office hours of a branch in Amsterdam
    • play a welcome prompt welcoming the caller to the Amsterdam branch
    • Ask the caller to press 1 for sales and 2 for technical support
    • Connect to either sales or technical support department in Amsterdam, depending on the choice the caller makes
  • Outside of Amsterdam office hours or on Dutch Holidays, play a prompt with the opening times of the Amsterdam branch

You copy the application, and change the following:

  • Change the opening times and holidays to the Amsterdam and Dutch opening times and holiday lists
  • Change the welcome and closed prompts to the prompts for the Amsterdam office
  • Change the destination number used in the connect objects for Sales and Support 

Then a week later, you get a request to build the same application for the London branch ...

Warning
iconfalse

You start to think that this is all getting a bit repetitive ...

Is there a Better Way?

The good news is: yes, there is!

You only have to build the application once, and you can re-use the application for all three service numbers.

Here's what to do:

Use Variable Objects

Variable Objects in the jtel IVR are used to execute the same functionality as "normal" objects, but based on the contents of a variable.

Let's look at the Play Voice and the Play Voice with Variable ID objects:

You can see, they look the same, except for the gear wheel on the variable object.

Let's look inside:

The Play Voice object provides you with drop-down lists where you can select the prompt you require from all prompts you have uploaded to the system.

This is a fixed value, which is saved with the application.

The Play Voice with variable ID object provides you with a field where you can type in anything. 

So what do you put here?

  • You put the ID of the prompt you want to play. For example, to play the same prompt as in the Play Voice object, you need the ID of the "JTEL - Willkommen" prompt, which in our case happens to be 2.
  • You can get the ID as shown in the following screenshot:

Warning
iconfalse

Note: the actual IDs will almost certainly be different on different systems, as the ID is a chronological value assigned by the database software when the record is created in the database table.

So putting the value 2 in the ID - Voice Prompt field will play "JTEL - Willkommen".

Info
iconfalse

Try it out!

Use Variables

You can also use variables here. That's where these "variable" objects get their names.

Let's imagine, you have declared a variable $myPrompt and assigned this the value of 2. 

Then you would get the same result.

Info
iconfalse

Try it out!

Hint: add a variable assignment object directly after the start object. Then change the ID value in the Play Voice with variable ID object to $myPrompt.

Populate the Variables using the Service Number Parameters

Now for the trick with the service number parameters.

When you setup the service number parameters, what actually happens is the system declares variables for you before the application is started.

So for example, if you setup the following in the service number:

What actually happens, is the jtel system assigns the variable $announcement1_id (shown on the left) the value of the ID of the JTEL - Willkommen prompt when the routing application is started.

You therefore get a variable called $announcement1_id which in this configuration contains the value 2.

Similarly, setting up these two parameters:

would result in the following variables being setup:

  • $holidaylists1_id Will contain the ID of the holiday list for Bavaria
  • $openingtimes1_idWill contain the ID of the opening times list for the Munich Office


Info
iconfalse

Get the idea?

You can now build the application just once, using variable objects for:

  • The opening times / holidays check object
  • The play voice objects
  • The connect to sales and support objects

Finished Application

The finished application will look something like this:

Variable Objects

Let's look inside the variable objects. As you can see, these all reference parameters (variables) defined in the service number parameters.

Branch Opening Hours

Welcome

Closed

Connect Sales

Connect Support

Service Number Parameters

And finally let's see the relevant service number parameters.

Other Service Numbers

The other two service numbers would be configured in the same way - using the same routing application, but different sets of parameters for the prompts, opening times and holiday lists, and connect destinations.

Info
iconfalse

Remember: you always need to specify the language parameter for the service!

Conclusions

Using "variable" objects enables you to create generic, re-usable applications.

You can parameterise these applications using assignments to variables using the service number parameters.

This makes for quick and easy re-use of applications allowing you to specify variable content for:

  • The language used
  • ACD groups used in the routing
  • IVR statistics markers
  • Opening times
  • Holidays
  • Destination numbers
  • User profiles
  • TTS engines

As we continue to develop the system, watch out for new parameters. And when you see one, you can be sure there will be an IVR object to match!

Try it out - have fun and good luck with it!

Sv translation
languagede

Einführung

Haben Sie sich schon einmal gefragt, warum das jtel System so viele Variablen in der Konfiguration der Servicenummern-Parameter zur Verfügung hat?

Die folgenden Screenshots zeigen Ihnen die derzeit verfügbaren Parameter.

  • Warum also so viele?
  • Und warum wächst die Liste mit jedem Release weiter an?
  • Und wie können Sie diese nutzen?

Demo-Szenario

Zum besseren Verständnis betrachten wir ein einfaches Demoszenario, bei dem das System von mehreren Niederlassungen gemeinsam genutzt wird.

Stellen Sie sich vor, Sie müssen eine IVR-Anwendung erstellen, die für die Servicenummer in München Folgendes tun soll:

  • Während der Geschäftszeiten der Münchner Niederlassung
    • eine Begrüßungsansage "Willkommen in unserer Münchner Niederlassung" abspielen
    • die Auswahlmöglichkeit für den Anrufer, die 1 für den Vertrieb und die 2 für den technischen Support zu drücken
    • Verbinden entweder mit dem Vertrieb oder dem technischen Support, je nachdem, welche Wahl der Anrufer trifft
  • Außerhalb der Münchener Geschäftszeiten oder an Feiertagen
    • eine Ansage mit den Öffnungszeiten der Münchener Niederlassung abspielen

Sie könnten die Anwendung in etwa so aufbauen:

Dann, eine Woche später, erhalten Sie eine Aufforderung, die folgende Anwendung für die Servicenummer der Niederlassung Amsterdam zu erstellen:

  • Während der Geschäftszeiten der Filiale in Amsterdam
    • eine Begrüßungsansage abzuspielen, die den Anrufer in der Niederlassung Amsterdam willkommen heißt
    • die Auswahlmöglichkeit für den Anrufer, die 1 für den Vertrieb und die 2 für den technischen Support zu drücken
    • Verbinden entweder mit dem Vertrieb oder dem technischen Support in Amsterdam, je nachdem, welche Wahl der Anrufer trifft
  • Außerhalb der Amsterdamer Bürozeiten oder an niederländischen Feiertagen
    • die Ansage mit den Öffnungszeiten der Amsterdamer Niederlassung abzuspielen

Sie kopieren die Anwendung und ändern Folgendes:

  • die Öffnungszeiten und Feiertage auf die Amsterdamer und niederländischen Öffnungs- und Feiertagslisten
  • die Begrüßungs- und Schließungsansagen auf die Ansagen für die Amsterdamer Niederlassung
  • die in den Verbindungsobjekten für Vertrieb und Support verwendete Zielnummern

Dann, eine Woche später, erhalten Sie eine Anfrage, die gleiche Anwendung für die Londoner Niederlassung zu erstellen ...

Warning
iconfalse

Sie beginnen zu denken, dass sich das alles ein bisschen wiederholt ...

Gibt es einen besseren Weg?

Die gute Nachricht ist: ja, die gibt es!

Sie müssen die Anwendung nur einmal erstellen, und Sie können die Anwendung für alle drei Servicenummern wiederverwenden.

Sie gehen folgendermaßen vor:

Variable Objekte verwenden

Variable Objekte in der jtel IVR werden verwendet, um die gleiche Funktionalität wie "fix definierte" Objekte auszuführen, aber basierend auf dem Inhalt einer Variable.

Schauen wir uns die Objekte Ausgabe Ansage und Ausgabe variable Ansage an:

Beide sehen gleich aus, bis auf das Zahnrad am variablen Objekt.

Lassen Sie uns beide genauer anschauen:

Das Objekt Ausgabe Ansage stellt Ihnen Dropdown-Listen zur Verfügung, in denen Sie aus allen Prompts, die Sie in das System hochgeladen haben, die gewünschte Ansage auswählen können.

Dahinter verbirgt sich ein fester Wert, also eine eindeutige ID, die mit der Anwendung gespeichert wird.

Das Objekt Ausgabe variable Ansage stellt Ihnen ein Feld zur Verfügung, in das Sie etwas eingeben können. 

Was geben Sie also hier ein?

  • Sie geben die ID der Ansage ein, die Sie abspielen möchten.

Um zum Beispiel die gleiche Ansage wie im Objekt "Ausgabe Ansage" abzuspielen, benötigen Sie die ID der Ansage "JTEL - Willkommen", die in unserem Fall 2 ist.

  • Sie können die ID wie im folgenden Screenshot gezeigt finden:

Warning
iconfalse

Hinweis: Die tatsächlichen IDs werden auf verschiedenen Systemen höchstwahrscheinlich unterschiedlich sein, da die ID ein chronologischer Wert ist, der von der Datenbanksoftware zugewiesen wird, wenn der Datensatz in der Datenbanktabelle erstellt wird.

Wenn Sie also den Wert 2 in das Feld ID - Ansage eingeben, wird "JTEL - Willkommen" abgespielt.

Info
iconfalse

Probieren Sie es aus!

Variablen verwenden

Sie können in dieser Eingabemaske anstatt einer Zahl (in unserem Beispiel die "2") auch Variablen verwenden. Daher haben diese "variablen" Objekte auch ihre Namen.

Stellen wir uns vor, Sie haben eine Variable $myPrompt deklariert und dieser den Wert 2 zugewiesen. 

Dann würden Sie das gleiche Ergebnis erhalten.

Info
iconfalse

Probieren Sie es aus!

Tipp: Fügen Sie direkt nach dem Start-Objekt ein Variablendeklarationsobjekt ein. Ändern Sie dann den ID-Wert im Objekt Ausgabe variable Ansage auf $myPrompt..

Auffüllen der Variablen mit den Servicenummern-Parametern

Jetzt kommt der Trick mit den Parametern bei der Service-Rufnummer.

Wenn Sie Servicenummer-Parameter einrichten, deklariert das System Variablen für Sie, bevor die Anwendung gestartet wird.

Wenn Sie also zum Beispiel Folgendes in der Servicenummer einrichten:

Was tatsächlich passiert, ist, dass das jtel-System der Variablen $announcement1_id (links dargestellt) den Wert der ID der JTEL - Willkommen Ansage zuweist, wenn die Routing-Anwendung gestartet wird.

Sie erhalten also eine Variable namens $announcement1_id, die in diesen Beispiel den Wert 2 enthält.

Ähnlich verhält es sich beim Einrichten dieser beiden Parameter:

  • $holidaylists1_id wird die ID der Feiertagsliste für Bayern enthalten
  • $openingtimes1_id enthält die ID der Öffnungszeitenliste "Munich Office" für das Büro München


Info
iconfalse

Verstehen Sie die Idee, die hinter der Verwendung der variablen Objekte steckt?

Sie brauchen nun die Anwendung nur einmal erstellen, indem Sie variable Objekte nutzen für:

  • Das Objekt Öffnungszeiten / Feiertage prüfen
  • Die Objekte Ausgabe Ansage
  • Die Objekte für das Weiterverbinden zu Vertrieb und Support

Fertige Anwendung

Die fertige Anwendung sieht in etwa so aus:

Variable Objekte

Lassen Sie uns die variablen Objekte genauer anschauen. Wie Sie sehen können, beziehen sich alle auf Variablen, die in der Servicenummer als Parameter definiert sind.

Verteilung Öffnungszeiten

Willkommen

Geschlossen

Verbinde Vertrieb

Verbinde Support

Servicenummer-Parameter

Und schließlich sehen wir uns die relevanten Parameter an, die der Servicenummern zugewiesen sind.

Andere Servicenummern

Die beiden anderen Servicenummern würden auf die gleiche Weise konfiguriert werden - mit der gleichen Routing-Anwendung, aber unterschiedlichen Parametersätzen für die Ansagen, Öffnungszeiten und Feiertagslisten sowie Verbindungsziele.

Info
iconfalse

Denken Sie daran: Sie müssen immer die Sprache für den Sprachparameter angeben!

Schlussfolgerungen

Die Verwendung von "variablen" Objekten ermöglicht es Ihnen, generische, wiederverwendbare Anwendungen zu erstellen.

Sie können diese Anwendungen parametrieren, indem Sie Zuweisungen an Variablen über die Parameter der Service-Rufnummer vornehmen.

Dies ermöglicht eine schnelle und einfache Wiederverwendung von Anwendungen, für die Sie variable Inhalte festlegen können:

  • Die verwendete Sprache
  • die im Routing verwendeten ACD-Gruppen
  • IVR-Statistik-Marker
  • Öffnungszeiten
  • Feiertage
  • Zielrufnummern
  • Benutzerprofile
  • TTS-Engines

Während wir das System weiter entwickeln, halten Sie Ausschau nach neuen Parametern. Sobald Sie eine neue Variable in den Parametern sehen, können Sie sicher sein, dass es ein passendes IVR-Objekt dazu geben wird!

Probieren Sie es aus - viel Spaß und viel Erfolg!