Konfiguration / Einstellungen
| Info |
|---|
Die Dokumentation für ältere Versionen von Reverse Lookup PRO finden Sie hier. |
Allgemeine Konfiguration
Erstellen Sie eine Modulinstanz und benennen diese mit einem Namen Ihrer Wahl, z.B. "Reverse Lookup PRO".
Lookup-Einstellungen
Damit für einen eingehenden Anruf der Anrufername. Nach Eingabe des Namens muß einmalig zwingend oder
geklickt werden:
Sollte beim Wechsel auf den Reiter 
keine Benutzeroberfläche zu sehen sein, deaktivieren und reaktivieren Sie bitte die soeben angelegte Modulkonfiguration. Sollten Sie weiterhin Probleme beim Zugriff auf die Moduloberfläche haben, verwenden Sie im ersten Schritt, einen anderen Browser (wir bevorzugen Google Chrome) und stellen Sie anschließend sicher, dass keine Popup-Blocker oder Browser-Plugins aktiv sind, die das Laden der Moduloberfläche verhindern könnten.
Prüfen Sie bitte im nächsten Schritt, ob bereits ein Modullizenzschlüssel im Bereich Lizenzierung eingetragen ist.
Falls nicht, kopieren Sie den Modullizenzschlüssel aus Ihrem Lieferschein. Überprüfen Sie hierbei, dass der im Bereich Support-Informationen angezeigte Serverlizenzschlüssel dem auf dem Lieferschein angegebenen Serverlizenzschlüssel entspricht. Serverlizenz- und Modullizenzschlüssel gehören immer zusammen.
In der oberen rechten Ecke finden Sie einen Schalter zum Aktivieren oder Deaktivieren des Expertenmodus:
Im Expertenmodus stehen erweiterte Einstellungen und Funktionen zur Verfügung, die sich an Benutzer mit entsprechender Fachkenntnis richten.
Bei aktiviertem Expertenmodus lassen sich in neueren Fluxpunkt Modulen automatisierte Updates aktivieren und Backups der Modulkonfiguration exportieren und importieren. Diese können sogar für die Installation auf anderen STARFACE-Installationen verwendet werden.
| Inhalt | ||||
|---|---|---|---|---|
|
| Info | ||
|---|---|---|
| ||
Begriffsdefinitionen finden Sie in unserem Glossar. |
Einstellungen
Suchanbieter
Damit für einen ein- oder ausgehenden Anruf der Name des Gesprächspartners im Display des Telefons angezeigt werden kann, muß
dessen Rufnummer durch mindestens einen der aktivierten Suchanbieter aufgelöst worden sein. Aktivierte Suchanbieter werden zeitgleich abgefragt. Länderübergreifende Anbieter werden immer, länderspezifische Anbieter nur für Rufnummern aus dem entsprechenden Land abgerufen. Für einige Länder stehen mehrere Suchanbieter zur Verfügung, die alle auch zeitgleich verwendet werden können.
Das in die STARFACE integrierte Adressbuch sowie ein modulinterner Cache werden wie länderübergreifende Suchanbieter behandelt und können einzeln aktiviert bzw. deaktiviert werden. Sie unterscheiden sich nur dadurch von anderen länderübergreifenden Anbietern, dass sie zeitlich vorgelagert überprüft werden. Ist im STARFACE Adressbuch oder im Cache eine Rufnummer hinterlegt, werden keine weiteren Suchanbieter mehr überprüft. Für jeden Suchanbieter kann bestimmt werden, ob dessen erfolgreiche Auflösungen im Cache gespeichert werden (dazu später mehr).
Für eine Namensauflösung steht ein Zeitraum von rund 700ms zur Verfügung, der durch die STARFACE begrenzt wird. Ein länger andauernder Vorgang wird abgebrochen und ohne Namensauflösung fortgesetzt. Auf diese Weise wird verhindert, dass ein eingehender Anruf im Rufaufbau festhängt, weil z.B. ein externer Dienst nicht erreichbar ist.
Kann innerhalb der
Zeit eine Rufnummer aufgelöst werden, so werden alle übrigen und noch ausstehenden Abfragen
abgebrochen. Der Dienst, der zuerst eine erfolgreiche Namensauflösung liefert, hat Priorität.
| Info | ||
|---|---|---|
| ||
|
Suchanbieter verändern/anpassen
Vorhandene Suchanbieter können im Expertenmodus (
) verändert werden, indem man mit der Maus über den Suchanbieter fährt und auf den sich einblendenen Stift klickt.
Es öffnet sich ein Dialog zur Konfiguration des Suchanbieters. Die konkreten Einstellungen hängen vom Suchanbieter ab. Für manche Suchanbieter ist die Eingabe eines API-Schlüssels oder Angabe eines kundenspezifischen Hostnamens erforderlich. Reverse Lookup PRO öffnet in diesen Fällen auch ohne Expertenmodus einen Dialog, in dem die notwendigen Einstellungen vorgenommen werden können.
Manche Suchanbieter verändern von Zeit zu Zeit ihre Webseiten, auf denen die Suchergebnisse präsentiert werden. In diesen Fällen sind Anpassungen an den regulären Ausdrücken (Parser) notwendig, die die Seiteninhalte extrahieren.
| Info |
|---|
Da Suchanbieter die Inhalte ihrer Suchergebnisseiten von Zeit zu Zeit modifizieren und automatisierte Abfragen unterbinden können, besteht keine Gewährleistung, dass bestimmte Suchanbieter dauerhaft funktionieren. Die im Modul vordefinierten Suchanbieter stellen Vorlagen dar, die vom Benutzer angepasst werden können und zum Funktionserhalt eventuell angepasst werden müssen. Mit dem Erwerb von Reverse Lookup PRO gehen keine Nutzungsrechte oder Ansprüche auf Nutzbarkeit einzelner Drittanbieterdienste einher. |
Eigene Suchanbieter
Sie können in Reverse Lookup PRO beliebig viele eigene Suchanbieter hinzufügen. Bei Suchanbietern handelt es sich technisch um Webdienste und/oder SQL-Datenbanken, denen eine aufzulösende Rufnummer als Suchbegriff übermittelt wird und die daraus eine Antwort generieren, die von Reverse Lookup PRO verarbeitet wird. Bei der Antwort kann es sich um eine HTML-Webseite, eine Textantwort, strukturierte Daten (z.B. JSON) oder eine Antwortzeile einer SQL-Datenbankabfrage handeln. Voraussetzung für das Hinzufügen eigener Suchanbieter-Dienste ist, dass Sie den Expertenmodus () aktivieren.
Neue Suchanbieter können durch einen Klick auf das Plus-Symbol am unteren rechten Rand hinzugefügt werden. Es öffnet sich ein Dialog, in dem alle notwendigen Einstellungen vorgenommen werden können. Die Suchanbieter-Konfiguration ist sehr dynamisch gestaltet. Ein Anbieter besteht zwingend aus einem Namen, der in der Liste aller Anbieter angezeigt wird und einer optionalen Beschreibung, die – wenn sie ausgefüllt wird – unterhalb des Anbieternamens in der Übersichtsliste zu sehen ist.
Der Resolver-Typ ist entweder HTTP (für HTTP-GET-Abfragen) oder SQL (zur Abfrage eigener Datenbanken). Weitere Resolver-Typen für komplexere Anwendungen, wie z.B. OAuth-Authentifizierung oder HTTP-POST-Abfragen, sind in Arbeit. Die Auswahl des Resolver-Typs bestimmt weitere Konfigurationsmöglichkeiten:
| Bereich | ||||
|---|---|---|---|---|
|
HTTP-Resolver
| Bereich |
|---|
|
SQL-Resolver
| Bereich | |||||||||
|---|---|---|---|---|---|---|---|---|---|
Erlaubt die Rufnummernauflösung per SQL-Anfrage gegen eine konfigurierbare Datenbank. Der SQL-Query-String ist dabei üblicherweise ein SELECT-Statement, das unter Berücksichtigung des konkreten Datenbankschemas die Anruferrufnummer gegen eine oder mehrere Datenbanktabellen auflöst, z.B.:
Als variable Bestandteile innerhalb des SQL-Statements können Sie alle im Dialog angezeigten Platzhalter verwenden. Der Platzhalter {tel} wird durch die aufzulösende Rufnummer im gewählten Rufnummernformat ersetzt. Die genaue SQL-Syntax hängt vom eingesetzten Datenbanktyp und der Datenbankversion ab. Für jede im SELECT-Statement ausgewählte Spalte (hier: name, company und city) muß je ein Parser angelegt werden. Der Matcher des ersten Parsers evaluiert die erste Spalte, der Matcher des zweiten Parsers die zweite Spalte und so weiter. Aus den Datenbankinhalten lassen sich so beliebige Teilinhalte herausfiltern und mit Hilfe der jeweiligen Formatter in eine Ergebniszeichenfolge verwandeln. Die Ergebniszeichenfolge steht anschließend in Form des Platzhalters {0}, {1}, {2}, etc. zur Verfügung.
|
Basisrufnummern
Erfolgreich aufgelöste Anrufernamen können per Lookup-Caching in einer modulinternen Datenbank gespeichert und bei Folgeanrufen beschleunigt aufgelöst werden. Wird Lookup-Caching aktiviert entfallen somit wiederholende Anfragen an externe Dienste. Bekannte Rufnummern werden in Zukunft direkt und ohne Verzögerung aus dem Cache beantwortet. Eine Abfrage gilt als erfolgreich, wenn sie entweder einen Namen zurückliefert, oder innerhalb der Timeout-Zeit nach Abfrage aller konfigurierten Basisrufnummern kein Ergebnis zustande kommt (sprich: der Anrufer nicht über Telefonbücher aufgelöst werden kann). Die modulinterne Datenbank kann gelöscht bzw. zurückgesetzt werden, indem die konfigurierte Modulinstanz gelöscht und neu angelegt wird.
Basisrufnummerauflösen
Üblicherweise werden für die Rufnummernblöcke von Geschäftskundenanschlüssen nur Teilnehmerdaten für die Stammrufnummer bzw. erste Durchwahl des Blocks in Telefonbüchern hinterlegt (für einen Rufnummernblock +49 1234 5678[0–999] z.B. für die +49 1234 5678-0). Ein Anrufer, der eine von der Stammrufnummer abweichende Durchwahl eines Rufnummernblocks signalisiert, wird über eine Inverssuche in Online-Telefonbüchern in der Regel nicht aufgelöst.
Die Funktion
Maximale Durchwahllänge aktiviert bei HTTP- und SQL-Suchanbietern die Abfrage verkürzter Varianten der Anruferrufnummer für den Fall, dass die exakte Rufnummer des Anrufers keinen Treffer in Online-Telefonbüchern erzeugt.
Reverse Lookup PRO
berechnet verschiedene wahrscheinliche Varianten für die signalisierte Rufnummer
. Dabei wird die Länge der Rufnummer und die konkret enthaltenen Ziffernfolgen berücksichtigt. Meist enden "wichtige" Rufnummern auf 0; Durchwahlen werden jedoch nie an einer 0 getrennt. Für zweistellige Durchwahlen sind 10er-Schritte wahrscheinlich (-0, -10, -20), während bei dreistelligen Durchwahlen sowohl 10er- als auch 100er- Schritte wahrscheinlich sind.
Bei Teilnehmeranschlüssen mit Rufnummernblöcken ist so unter Umständen eine Auflösung der Basisrufnummer möglich, obwohl für die übermittelte Durchwahl kein Eintrag in einem Telefonbuch vorliegt.
Da die Größe des Rufnummernblocks eines Anrufers nicht bekannt ist, kann eine maximale Durchwahllänge konfiguriert
werden. Je größer die Durchwahllänge, desto mehr mögliche Kombinationen der Rufnummer müssen berücksichtigt werden.
Suchanbieter
Da in manchen Ortsnetzen verkürzte Varianten von Rufnummern teilweise an andere Kunden vergeben sind, muß eine kürzere aufgelöste Rufnummer nicht zwingend dem tatsächlich anrufenden Teilnehmer zugewiesen sein. Es ist daher möglich, dass ein falscher Anrufername im Display bzw. den Ruflisten auftaucht, wenn die Rufnummernauflösung nur über eine verkürzte Rufnummer zustande kommt. Die Funktion Aufgelöste Basisrufnummer kenntlich machen kennzeichnet in einem solchen Fall den aufgelösten Namen durch Anhängen eines Fragezeichens ("?" ). Durch das Fragezeichen ist erkennbar, dass nicht die exakte Rufnummer für eine Inverssuche verwendet wurde, sondern eine verkürzte Variante davon.
STARFACE Adressbuch
Reverse Lookup PRO startet eine Inverssuche nur für Anrufer, deren Rufnummer nicht bereits durch das STARFACE-Adressbuch (oder ein konfiguriertes LDAP-Adressverzeichnis) aufgelöst werden konnte. Das STARFACE- oder LDAP-Adressbuch hat normalerweise immer Vorrang.
Die Funktion STARFACE Adressbuchauflösung deaktivieren sorgt dafür, dass eine Inverssuche auch dann durchgeführt wird, wenn die STARFACE dem Modul mitteilt, bereits eine Namensauflösung durchgeführt zu haben. Online-Telefonbücher haben damit die Möglichkeit, STARFACE-Adressdaten zu überschreiben. In manchen STARFACE-Versionen gab es zudem einen Bug, durch den die STARFACE immer eine positive Namensauflösung durch das STARFACE-Adressbuch vorgab (auch wenn dem nicht so war). Die Deaktivierung der Adressbuchauflösung durch STARFACE ist in solchen Version zwingende Voraussetzung für eine Namensauflösung durch Reverse Lookup PRO.
Online-Telefonbücher für Rufnummernauflösung
Online-Telefonbücher (Deutschland/Schweiz/USA)
Reverse Lookup PRO enthält Abfragefunktionen zur Rückwärtsauflösung von Rufnummern über verschiedene Internet-Telefonbücher. Abhängig von der Landeskennzahl der Anruferrufnummer (0049 für Deutschland, 001 für USA, 0041 für die Schweiz) werden Suchanbieter der jeweiligen Länder abgefragt. Existieren mehrere Suchanbieter für ein Land und sind diese für die Rufnummernauflösung aktiviert, werden diese parallel abgefragt. Der erste Suchanbieter, der die angefragte Rufnummer auflöst, bestimmt die Namensanzeige.
Individuelle Suchanbieter
Reverse Lookup PRO unterstützt neben allgemein zugänglichen Online-Telefonbüchern auch die Abfrage eigener Datenbanken und CRM-Systeme. Die Zugangsdaten bzw. die genaue Konfiguration eigener Suchanbieter erfolgt auf dem Tab 
.
Abfrage der Salesforce-REST-API, wenn Kundenkontakte im Salesforce CRM gepflegt werden.
SQL-Datenbank
Abfrage einer SQL-Datenbank über ein konfigurierbares SELECT-Statement, in das die Anruferrufnummer per Platzhaltervariable eingefügt werden kann.
Individueller Suchanbieter
Abfrage von HTTP/HTTPS-URLs und Selektion von Anrufername und -ort per regulären Ausdrücken.
Details zur Konfiguration individueller Suchanbieter finden Sie im Abschnitt Suchanbieter.
Anruferbewertung
Der Dienst bzw. die "Community" tellows bietet Informationen zur Identifizierung von seriösen bzw. unseriösen Anrufern. Tellows kategorisiert Anrufe per Score von 1 bis 9, wobei 1 ein maximal seriöser Anrufer und 9 ein maximal unseriöser Anrufer ist. Wird tellows aktiviert, fragt Reverse Lookup PRO den Score eines Anrufers ab.
Über tellows Score-Verwendung läßt sich bestimmen, wie mit dem Ergebnis zu verfahren ist:
Der ermittelte Score kann entweder als numerischer Wert dem Anrufernamen vorangestellt werden oder über die Angabe eines tellows Anrufer Maximal-Score dazu verwendet werden, Anrufer automatisiert abzulehnen. Bei Auswahl der Option Anrufer mit Score >x abweisen und Angabe eines Maximal-Scores, werden unseriöse Anrufer mit einem größeren Score automatisch abgewiesen.
Anzeigeeinstellungen
Stellt den Namen der angerufenen Person oder Gruppe vor den Namen des Anrufers um das Ziel des Anrufs kenntlich zu machen.
| Info |
|---|
Die Funktionen der Anzeigeeinstellungen sind seit STARFACE Version 6.2 obsolet und nur für die Verwendung mit älteren STARFACE-Versionen enthalten. Bitte verwenden Sie in neueren STARFACE Versionen stattdessen die Funktion ID-Anzeige. |
| Inhalt | ||||
|---|---|---|---|---|
|
Suchanbieter
Bitte beachten Sie die Nutzungsbedingungen der einzelnen Anbieter.
GoYellow
GoYellow wird für Anrufer aus Deutschland verwendet. Es wird die GoYellow-Website abgerufen und die Ergebnisseite durch das Modul ausgewertet.
Für GoYellow ist keine weitere Konfiguration erforderlich.
Search.CH
Search.CH wird für Anrufer aus der Schweiz verwendet. Zur Verwendung der Search.CH-API ist die Angabe eines API-Schlüssels erforderlich, der bei Search.CH beantragt werden kann.
ETV Inside
Für umfangreiche bzw. häufige Anfragen zur Rufnummernauflösung von schweizer Anrufern, kann der kostenpflichtige Dienst ETV Inside der Swisscom Directories AG verwendet werden. Nach der Registrierung erhält man einen Benutzernamen und ein Kennwort, das im Modul angegeben werden kann.
WhitePages PRO
Anrufer aus den USA können über den Dienst Whitepages PRO aufgelöst werden. Für die Nutzung ist ein API-Schlüssel notwendig.
tellows
Für die Abfrage von tellows ist ein Partnerlogin sowie API-Key notwendig. Diese Daten erhalten Sie nach der Registrierung vom Anbieter.
Salesforce
SQL-Datenbank
Erlaubt die Rufnummernauflösung per SQL-Anfrage gegen eine konfigurierbare Datenbank. Der SQL-Query-String ist dabei üblicherweise ein SELECT-Statement, das unter Berücksichtigung des konkreten Datenbankschemas die Anruferrufnummer gegen eine oder mehrere Datenbanktabellen auflöst, z.B.:
| Codeblock | ||||
|---|---|---|---|---|
| ||||
SELECT name AS Anrufername, company AS Firmenname, city AS Ort FROM myaddresstable WHERE phonenumer=#CALLERID_INT# |
Als variable Bestandteile innerhalb des SQL-Statements werden folgende Terme unterstützt:
- #CALLERID_INT#
Wird durch die Anruferrufnummer im internationalen nicht-kanonischen Format (00xx...), umschlossen von einfachen Anführungszeichen, ersetzt. - #CALLERID_INT+#
Wird durch die Anruferrufnummer im internationalen kanonischen Format (+xx...), umschlossen von einfachen Anführungszeichen, ersetzt.
Die erste Spalte des SQL-Resultats wird als Anrufername verwendet, die zweite Spalte als Firmenname. Die verfügbaren Platzhalter werden vom Modul in Hochkommata gesetzt. Somit können die Platzhalter nicht innerhalb anderer Zeichenketten verwendet werden (z.B. wird like '%<PlatzhalterRufnummer>' in like '%''0049123456' übersetzt). Komplexe SQL Anfragen müssen mithilfe von SQL Views datenbankseitig vorbereitet werden. Unterstützt werden folgenden Datenbanken: PostgreSQL, Microsoft SQL Server, MySQL, Derby.
Achtung: in neueren STARFACE Versionen stehen keine nationalen Rufnummernformate zur Verfügung. Es wird mittlerweile nur noch international signalisiert.
| Info |
|---|
Bitte haben Sie Verständnis dafür, dass wir Sie bei der Anbindung Ihrer individuellen Datenbank nicht unterstützen können. Um Ihre eigene Datenbank anzubinden, benötigen Sie neben den Zugangsdaten auch Kenntnis des Datenbankschemas (Tabellen, Spaltennamen, Relationen, etc.), sowie grundlegende Kenntnisse in der Abfragesprache SQL. |
Individueller Suchanbieter
Für die Abfrage individuelle Suchanbieter kann neben einem Länderkennzeichen, das definiert, für welches Anruferland der Suchanbieter in Frage kommt, eine Lookup-URL angegeben werden. Gegen die URL wird ein HTTP(S) ausgeführt, wobei der URL Parameter oder URL-Bestandteile, bestehend aus der Anruferrufnummer, übergeben werden können.
| Codeblock | ||||
|---|---|---|---|---|
| ||||
http://mein-lookup-dienst.com/resolve?callerid=#CALLERID_INT# |
Als variable Bestandteile innerhalb der Lookup-URL werden folgende Terme unterstützt:
- #CALLERID_INT#
Wird durch die Anruferrufnummer im internationalen nicht-kanonischen Format (00xx...), umschlossen von einfachen Anführungszeichen, ersetzt. - #CALLERID_INT+#
Wird durch die Anruferrufnummer im internationalen kanonischen Format (+xx...), umschlossen von einfachen Anführungszeichen, ersetzt.
Die Antwort des abgefragten Webservices wird mit Hilfe von Name (regulärer Ausdruck) und Ort (regulärer Ausdruck) gefiltert, wobei jeweils die erste Untergruppe eines zutreffenden regulären Ausdrucks als Wert für den Namen bzw. den Ort übernommen wird:
| Codeblock | ||||
|---|---|---|---|---|
| ||||
<span id="name">(.*)<\/span> |
| Tipp | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
Der Online RegExp-Tester regex101.com kann beim Erstellen der regulären Ausdrücke hilfreich sein.
|
| Info |
|---|
Die hier vorgestellten Einstellungen und regulären Ausdrücke stellen ein konkretes und nicht allgemein gültiges Anwendungsbeispiel dar. Grundsätzlich lassen sich Texte mit Hilfe regulärer Ausdrücke sehr umfangreich filtern durchsuchen oder vergleichen. Für einen konkreten Anwendungsfall machen Sie sich bitte mit der Syntax und Anwendung regulärer Ausdrücke vertraut. Wir können diesbezüglich leider keine individuelle Hilfestellung leisten. Sie können Ihre regulären Ausdrücke unter https://regex101.com/ gegen Testzeichenfolgen prüfen. |
Erweiterte Einstellungen
Im Bereich Erweiterte Einstellungen finden Sie Konfigurationsoptionen, die nur für besondere Betriebskonstellationen gedacht sind. Die Standardeinstellungen sollten für die meisten Anwendungsfälle korrekt sein. Bitte ändern Sie Einstellungen in diesem Bereich nur auf ausdrückliche Anweisung des Supports.
