Anhang

Kenntnisstand

Mai 2025

Tastenkombinationen am Telefon

Die folgenden Tastenkombinationen können an Telefonen, die über die STARFACE autoprovisioniert worden sind, genutzt werden, um verschiedene Features und Funktionen zu steuern.

Tastenkombinationen zur allgemeinen Steuerung

Taste(n)	Zusatzeingabe	Beschreibung
	Zielnummer	Markiert das Telefonat in den Auswertungen der Verbindungsdaten als privat.
	Gruppen-ID	Anmelden des Benutzers bei der Gruppe
	Gruppen-ID	Abmelden des Benutzers von der Gruppe
	Kurzwahl	Kurzwahl aus dem Adressbuch wird gerufen
	Login-ID	Anmelden des Benutzers am Telefon
	Login-ID	Abmelden des Benutzers am Telefon
		Abmelden aller Benutzer am Telefon
	interne Rufnummer	Übernahme des Rufs für Benutzer/Gruppe (Call Grabbing)
		Zufällige Rufübernahme (Call Grabbing)
	ID der Voicemailbox	Abfrage und Konfiguration einer Voicemailbox
	Ziffer	Rufaufbau über die Leitung mit der Leitungspräfix-Ziffer
	z.B. ##2	Eingaben nach der ersten # werden ungefiltert an den Provider signalisiert (Erfordert das Recht "Providerseitige Dienstemerkmale"). Es wird empfohlen diese Tastenkombination nur in Kombination mit einem Leitungspräfix zu verwenden.

Tabelle 22 - Tastenkombinationen zur allgemeinen Steuerung

Tastenkombinationen während eines aktiven Telefonats

Taste(n)	Zusatzeingabe	Beschreibung
		Legt das Gespräch auf alle Telefone des Benutzers (Call2Go)
		Mitschnitt starten oder stoppen. Nach Beendigung des Telefonats wird der Mitschnitt als E-Mail-Anhang versandt.
		Aufruf des Sprachmenüs für einen Transfer mit Rückfrage. Das laufende Gespräch wird währenddessen gehalten. Nach Rücksprache mit dem Transferziel, wird der gehaltene Gesprächspartner durch Auflegen übergeben.
		Starten einer spontanen Telefonkonferenz mit dem aktuellen Gespräch und allen auf Halten gesetzten Rufen
		Für die nächsten 10 Sekunden können beliebige DTMF-Töne übertragen werden

Tabelle 23 - Tastenkombinationen während eines aktiven Telefonats

Tastenkombinationen für zusätzliche Dienstmerkmale

Taste(n)	Zusatzeingabe	Beschreibung
	Zielnummer	Immer-Umleitung einschalten auf Zielnummer (ohne Gruppennummern)
		Aktiviert alle bereits konfigurierten Immer-Umleitungen (ohne Gruppennummern)
	Zielnummer	Alle Immer-Umleitungen ausschalten (ohne Gruppennummern)
	Zielnummer	Besetzt-Umleitung einschalten auf Zielnummer
		Aktiviert alle bereits konfigurierten Besetzt-Umleitungen (ohne Gruppennummern)
		Alle Besetzt-Umleitungen ausschalten
	Zielnummer	Zeitüberschreitung-Umleitung auf Zielrufnummer einschalten
		Aktiviert alle bereits konfigurierten Zeitüberschreitung-Umleitungen (ohne Gruppennummern)
		Alle Zeitüberschreitung-Umleitungen ausschalten
	Zielrufnummer	Immer-Umleitung einschalten auf Zielnummer (ohne Gruppennummern)
		Alle Immer-Umleitungen ausschalten (ohne Gruppennummern)
		Rückruf bei Besetzt einschalten
		Rückruf bei Besetzt ausschalten
	+ 00 bis 99 (Warteplatz-ID)	Gehaltenen Anrufer auf einem Warteplatz parken oder aus dem Warteplatz holen (Park and Orbit)
		Ruhe/DND für den angemeldeten Benutzer aktivieren
		Ruhe/DND für den angemeldeten Benutzer deaktivieren

Tabelle 24 - Tastenkombinationen für zusätzliche Dienstmerkmale

Tastenkombinationen zur Steuerung von Konferenzen

Taste(n)	Zusatzeingabe	Beschreibung
		Sprachmenü der Steuerungsoptionen aufrufen
		Stummschaltung (Mikrofon) ein- und ausschalten
		Sich zu Wort melden, wenn vom Moderator stumm geschaltet
		Konferenzlautstärke zu verringern
		Setzt die Hörerlautstärke auf den Standardwert zurück
		Konferenzlautstärke erhöhen
		Mikrofonlautstärke verringern
		Setzt die Mikrofonlautstärke auf den Standardwert zurück
		Mikrofonlautstärke erhöhen

Tabelle 25 - Tastenkombinationen zur Steuerung moderierter Konferenzen

Übersicht der länderspezifischen Notrufnummern und Sonderrufnummern

Bestimmte interne Rufnummern können nicht an Benutzer, Gruppen usw. vergeben werden. Welche internen Rufnummern nicht zugewiesen werden können, ist abhängig von der konfiguriertem Ländereinstellung auf dem SIP-Trunk.

Die Wildcard * steht dabei für keine oder mehrere beliebige Ziffern. Die Angaben in eckigen Klammern gibt einen Nummernbereich an.

Land	Nummer	Notruf	Sonderrufnummer	Beschreibung
Afghanistan	112	Ja		Fire
Afghanistan	119	Ja		Police/Ambulance
Andorra	[0-9]*		Ja	Deactivation of number normalization
Australien	106	Ja		Emergency Call
Australien	1100		Ja	Community Service
Australien	112	Ja		Emergency Call
Australien	119[0-9]		Ja	Community Service
Australien	12[0-9]{2}[0-9]*		Ja	Several Network Services
Australien	13[0-9]{2}[0-9]*		Ja	Local Rate Services
Australien	18[0-9]{2}[0-9]*		Ja	Free Phone Services
Australien	180[0-9]*		Ja	Free phone services
Australien	189[0-9]{2}		Ja	Calling Card Services
Australien	19[0-9]{2}[0-9]*		Ja	Premium Rate Services
Österreich	10[0-9]*		Ja	Betreiberauswahl-Praefix
Österreich	111[0-9]*		Ja	Öffentliche Kurzrufnummern fuer Telefonstoerungsannahmestellen
Österreich	112[0-9]*	Ja		Einheitliche europäische Notrufnummer
Österreich	116[0-9]*		Ja	Öffentliche Kurzrufnummern fuer harmonisierte Dienste von sozialem Wert
Österreich	118[0-9]*		Ja	Öffentliche Kurzrufnummern fuer Telefonauskunftsdienste
Österreich	120[0-9]*		Ja	Pannendienste
Österreich	122[0-9]*	Ja		Feuerwehrzentralen
Österreich	123[0-9]*		Ja	Pannendienste
Österreich	128[0-9]*	Ja		Notrufnummer bei Gasgebrechen
Österreich	130[0-9]*	Ja		Landeswarnzentralen
Österreich	133[0-9]*	Ja		Polizei
Österreich	140[0-9]*	Ja		Bergrettung
Österreich	141[0-9]*	Ja		Aerztenotdienst
Österreich	142[0-9]*	Ja		Telefonseelsorge
Österreich	144[0-9]*	Ja		Rettungsdienst
Österreich	1455[0-9]*		Ja	Apothekendienste
Österreich	147[0-9]*	Ja		Notrufdienst fuer Kinder und Jugendliche
Österreich	1484[0-9]*	Ja		Krankentransporte
Belgien	100	Ja		Emergency 100
Belgien	101	Ja		Emergency 101
Belgien	106	Ja		Emergency 106
Belgien	110	Ja		Emergency 110 Missing Children
Belgien	112	Ja		Emergency 112
Belgien	116116	Ja		Harmonisierte Dienste 116116
Brasilien	[0-9]*		Ja	Deactivation of number normalization
Brasilien	100	Ja		Human Rights Secretariat
Brasilien	128	Ja		Standard Emergency Number
Brasilien	190	Ja		Military Police
Brasilien	191	Ja		Federal Highway Patrol
Brasilien	192	Ja		Ambulance
Brasilien	193	Ja		Firefighters
Brasilien	194	Ja		Federal Police
Brasilien	197	Ja		Civil Police
Brasilien	198	Ja		State Highway Patrol
Brasilien	199	Ja		Civil Defense
Bulgarien	116	Ja		Police
Bulgarien	150	Ja		Ambulance
Bulgarien	160	Ja		Fire
Chile	[0-9]*		Ja	Deactivation of number normalization
Komoren	[0-9]*		Ja	Deactivation of number normalization
Kroatien	1\d{2}\d*	Ja		Emergency
Zypern	1[0,4,6,8]{1}[0-9]{2}	Ja		Emergency service 4 digit
Zypern	1[1-3,5,9]{1}[0-9]{1}	Ja		Emergency service 3 digit
Zypern	10[0-9]{2}		Ja	Carrier (pre-)selection codes
Zypern	112	Ja		Emergency Call (Police, Ambulance, Fire service)
Zypern	116[0-9]{3}	Ja		Harmonized numbers for harmonized services of social value
Zypern	118[0-9]{2}		Ja	Directory enquiry services
Zypern	16[0-9]{4}		Ja	Call routing prefixes
Zypern	17[0-9]{3}	Ja		Emergency service 5 digit
Zypern	199	Ja		Emergency Call (Police, Ambulance, Fire service)
Tschechien	10[0-9]{2,3}		Ja	Carrier network selection
Tschechien	112	Ja		Emergency 112
Tschechien	112[0-9]*	Ja		Emergency 112
Tschechien	116[0-9]{3}	Ja		European harmonised numbers
Tschechien	118[0-9]{1}		Ja	Directory enquiry services
Tschechien	12[0-9]{2,3}	Ja		Social, health and assistance services
Tschechien	13[0-9]{3,4}		Ja	Public service numbers of network providers
Tschechien	14[0-9]{3}	Ja		Social, healt, assistance and security services
Tschechien	15[0-9]{1}	Ja		National emergency call numbers 150 to 159
Tschechien	150[0-9]*	Ja		Emergency 150 Fire
Tschechien	55[0-9]*	Ja		Emergency 155 Ambulance
Tschechien	158[0-9]*	Ja		Emergency 158 Police
Tschechien	16[0-9]{2}		Ja	Global service routing
Tschechien	199		Ja	Special number for public service
DENMARK	10[0-9]{2}		Ja	Carrier network selection
DENMARK	112[0-9]*	Ja		Emergency 112
Dänemark	114[0-9]*	Ja		Emergency 114 (Police)
Dänemark	116[0-9]{3}	Ja		Social services
Dänemark	16[0-9]{3}		Ja	Carrier select code for data
Dänemark	18[0-9]{2}		Ja	Service number such as directory enquiry
Osttimor	[0-9]*		Ja	Deactivation of number normalization
Finnland	10[0-9][0-9]*		Ja	Long distance operator prefixes
Finnland	112[0-9]*	Ja		Emergency 112
Finnland	116000	Ja		Hotline for missing children
Finnland	116006	Ja		Helpline for victims of crime
Finnland	116111	Ja		Child helplines
Finnland	116111	Ja		Mannerheim League for Child Welfare
Finnland	116117	Ja		Non-emergency medical on-call service
Finnland	118		Ja	service number of line providing telco
Finnland	99[0-9][0-9]*		Ja	International call-by-call operator prefixes
Frankreich	10[0-9]*		Ja	Services des operateurs de reseau (numeros a 4 chiffres)
Frankreich	112[0-9]*	Ja		Numero durgence europeen (permettant dacceder aux trois services ci-dessus)
Frankreich	115[0-9]*	Ja		Urgences sociales (ou SAMU social)
Frankreich	116[0-9]*	Ja		Services a valeur sociale harmonises
Frankreich	118[0-9]*		Ja	Services de renseignements telephoniques (numeros a 6 chiffres)
Frankreich	119[0-9]*	Ja		Enfance maltraitee
Frankreich	15[0-9]*	Ja		SAMU (Rettungsdienst)
Frankreich	16[0-9]*		Ja	Selection du transporteur (prefixes a 1 ou 4 chiffres)
Frankreich	17[0-9]*	Ja		Police ou Gendarmerie
Frankreich	18[0-9]*	Ja		Pompiers
Frankreich	3[0-9][0-9][0-9][0-9]*		Ja
Georgien	1\d{2}\d*	Ja		Emergency
Deutschland	11[0,2]	Ja		110, 112 Notruf
Deutschland	115		Ja	115 Einheitliche Behördenrufnummer
Deutschland	116[0-9]*	Ja		116xyz EU-Rufnummern fuer Dienste von sozialem Wert
Deutschland	118[0-9]*		Ja	118xy Rufnummern fuer Auskunfts- und Vermittlungsdienste
Griechenland	(00)?800[0-9]*		Ja	Free phone services
Griechenland	100[0-9]*	Ja		Police
Griechenland	108[0-9]*		Ja	Coast Guard
Griechenland	112[0-9]*	Ja		Emergency
Griechenland	116[0-9]*	Ja		Social Numbers
Griechenland	1591[0-9]*	Ja		Forest Fire
Griechenland	166[0-9]*	Ja		Ambulance
Griechenland	199[0-9]*	Ja		Fire
Hongkong	[0-9]*		Ja	Deactivation of number normalization
Italien	(00)?80[0,3][0-9]*		Ja	Free phone services
Italien	112[0-9]*	Ja		Emergency
Italien	113[0-9]*	Ja		Carabinieri
Italien	114[0-9]*	Ja		Youth child helpline (treatment/abuse)
Italien	115[0-9]*	Ja		Fire Service (Vigili del Fuoco)
Italien	116[0-9]*	Ja		Harmonized numbers for hamonized services of social value
Italien	117[0-9]*	Ja		Guardia di Finanza
Italien	118[0-9]*	Ja		Ambulance
Italien	15[0-9][0-9][0-9]*	Ja		Other Emergency and Info Services
Italien	19696[0-9]*	Ja		Helpline for Children
Lettland	[0-9]*		Ja	Deactivation of number normalization
Lichtenstein	10[011020206699]		Ja	Carrier Selection Code
Lichtenstein	112	Ja		European Emergency Number
Lichtenstein	1145		Ja	Blinds inquiry and exchange
Lichtenstein	117	Ja		Police
Lichtenstein	118	Ja		Fire department
Lichtenstein	143	Ja		Die Dargebotene Hand charity
Lichtenstein	144	Ja		Ambulance
Lichtenstein	145	Ja		TOX-Center (Zurich)
Lichtenstein	147	Ja		Helpline for children and juvenile in Liechtenstein
Lichtenstein	150		Ja	Automatic alarm service
Lichtenstein	181[18]		Ja	Telephone directory service
Litauen	[0-9]*		Ja	Deactivation of number normalization
Malta	1\d\d\d*		Ja	Others
Malta	112	Ja		Emergency
Malta	119	Ja		Criminal activity
Niederlande	10[0-9][0-9][0-9][0-9][0-9]*		Ja	Carrier Selection
Niederlande	110[0-9]*		Ja	Standardized European Short Number Services
Niederlande	111[0-9]*		Ja	Standardized European Short Number Services
Niederlande	112[0-9]*	Ja		Emergency
Niederlande	113[0-9]*		Ja	Standardized European Short Number Services
Niederlande	114[0-9]*		Ja	Standardized European Short Number Services
Niederlande	115[0-9]*		Ja	Standardized European Short Number Services
Niederlande	116[0-9][0-9][0-9][0-9]*	Ja		Harmonisierte Dienste von sozialem Wert
Niederlande	12[0-9][0-9][0-9]*		Ja	Standardized Carrier Service Codes
Niederlande	14[0-9][0-9][0-9][0-9]*		Ja	public authorities
Niederlande	144[0-9]*	Ja		Animal Rescue Service
Niederlande	16[0-9][0-9][0-9]*		Ja	Carrier Select Prefixes
Niederlande	18[0-9][0-9][0-9]*		Ja	Number Information
Neuseeland	1\d{2}\d*	Ja		Emergency
Norwegen	110	Ja		Emergency 110
Norwegen	112	Ja		Emergency 112
Norwegen	113	Ja		Emergency 113
Norwegen	116111	Ja		Harmonisierte Dienste 116111
Norwegen	116116	Ja		Harmonisierte Dienste 116116
Polen	112[0-9]*	Ja		Emergency
Polen	116[0-9][0-9][0-9][0-9]*	Ja		Harmonisierte Dienste von Sozialem Wert
Polen	118[0-9][0-9][0-9][0-9]*		Ja	Auskunftsdienste
Polen	984[0-9]*	Ja		River rescue service
Polen	985[0-9]*	Ja		Mountain sea rescue service
Polen	986[0-9]*	Ja		Municipal police
Polen	987[0-9]*	Ja		Crisis management centers
Polen	991[0-9]*	Ja		Power stations brigade
Polen	992[0-9]*	Ja		Gas brigade
Polen	993[0-9]*	Ja		Heating brigade
Polen	994[0-9]*	Ja		Waterworks brigade
Polen	995[0-9]*	Ja		Child alert
Polen	996[0-9]*	Ja		Anti terrorist emergency number
Polen	997[0-9]*	Ja		Police
Polen	998[0-9]*	Ja		Fire brigade
Polen	999[0-9]*	Ja		Ambulance
Portugal	(00)?800[0-9]*		Ja	Free phone services
Portugal	[0-9]*		Ja	Deactivation of number normalization
Portugal	112[0-9]*	Ja		Emergency 112
Portugal	117[0-9]*	Ja		Emergency 117
Singapur	[0-9]*		Ja	Deactivation of number normalization
Slowenien	1\d{2}\d*	Ja		Emergency
Südafrika	101\d{2}\d*	Ja		Emergency
Spanien	(00)?800[0-9]*		Ja	Free phone services
Spanien	1[0-9][0-9][0-9]		Ja	Short Numbers
Spanien	10[3456][0-9]*		Ja	Carrier Selection
Spanien	112[0-9]*	Ja		Emergency Calling
Spanien	116[0-9]*	Ja		Harmonisierte Dienste von Sozialem Wert
Spanien	118[0-9]*		Ja	Auskunftsdienste
Swasiland	[0-9]*		Ja	Deactivation of number normalization
Schweden	112[0-9]*	Ja		Emergency 112
Schweden	11414[0-9]*	Ja		Police - non emergency
Schweden	116[0-9][0-9][0-9][0-9]*	Ja		Harmonisierte Dienste von sozialem Wert
Schweden	1177	Ja		Health care advice
Schweden	118[0-9][0-9]*		Ja	Number enquiries
Schweiz	11[0,2][0-9]*	Ja		Notruf
Schweiz	115	Ja		civil services
Schweiz	116[0-9]*	Ja		social services
Schweiz	118[0-9]*		Ja	Auskunft
TBR21	101	Ja		Emergency Fire
TBR21	102	Ja		Emergency Police
TBR21	103	Ja		Emergency Ambulance
TBR21	104	Ja		Emergency Ambulance
TBR21	104		Ja	Emergency Gas Leaks
TBR21	105	Ja		Emergency Fire
TBR21	107	Ja		Emergency Police
TBR21	112	Ja		Emergency
TBR21	112	Ja		Emergency Medical Help/Ambulance/Fire/Vet/Doctors
TBR21	112	Ja		Emergency Fire
TBR21	113	Ja		Emergency Police
Tunesien	[0-9]*		Ja	Deactivation of number normalization
Türkei	110	Ja		Emergency 110 Police
Türkei	112	Ja		Emergency 112 Fire
Türkei	155	Ja		Emergency
Türkei	156	Ja		Emergency Gendarmerie
Türkei	158	Ja		Emergency Coast Guard
Türkei	177	Ja		Emergency Forest Fire
Vereinigtes Königreich	1[0-9][0-9][0-9]*		Ja	Misc. Access Codes
Vereinigtes Königreich	100[0-9]*		Ja	Operator Service
Vereinigtes Königreich	101[0-9]*	Ja		Emergency
Vereinigtes Königreich	111[0-9]*	Ja		Emergency
Vereinigtes Königreich	112[0-9]*	Ja		Emergency
Vereinigtes Königreich	116[0-9][0-9][0-9][0-9]*	Ja		Harmonisierte Dienste von sozialem Wert
Vereinigtes Königreich	118[0-9][0-9][0-9][0-9]*		Ja	Auskunftsdienste
Vereinigtes Königreich	123[0-9]*		Ja	Speaking Clock
Vereinigtes Königreich	155[0-9]*		Ja	Aufkunftsdienst
Vereinigtes Königreich	1800[0-9][0-9]*		Ja	Access to Voice Text Services for the Deaf
Vereinigtes Königreich	195[0-9]*		Ja	Access to Blind & Disabled Directory Enquiry Facilities
Vereinigtes Königreich	999[0-9]*	Ja		Emergency
USA	(011)?1?8[00,55,66,77,88][0-9]*		Ja	Free phone services
USA	101\d\d\d\d\d*		Ja	Used to select use of an alternative long-distance carrier
USA	211		Ja	Local community information or social services (in some cities)
USA	311		Ja	City government or non-emergency police matters
USA	411		Ja	Local telephone directory service (Some telephone companies provide national directory assistance)
USA	511		Ja	Traffic, road, and tourist information
USA	611		Ja	Telephone line repair service (formerly 4104), mobile telephone company customer service (formerly 811)
USA	711		Ja	Relay service for customers with hearing or speech disabilities
USA	811		Ja	Dig safe pipe/cable location in the United States, non-urgent telehealth/teletriage services in Canada (formerly telephone company business office)
USA	911	Ja		Emergency telephone number (fire department, ambulance, police)

Neues SIP Providerprofil konfigurieren

In dieser Dokumentation wird beschrieben welche Konfigurationsmöglichkeiten beim Anlegen eines neuen SIP-Providers zur Verfügung stehen.

Es wird empfohlen nur verifizierte Providerprofile zu nutzen, da diese automatische gegen verschiedene Versionen der STARFACE getestet werden. Nur die mit „Profil bereitgestellt von STARFACE GmbH“ gekennzeichneten Profile werden durch den Support der Firma Starface abgedeckt.

Kopfleiste

Über die gleichnamigen Schaltflächen können verschiedene Funktionen direkt ausgewählt werden:

Profil kopieren
Vorversion anzeigen
TLS-Zertifikat importieren

SIP-Konfiguration

Beispiel Screenshot SIP-Konfiguration

Es stehen die folgenden Konfigurationsfelder zur Verfügung:

type

type
Beschreibung	Erlaubte Verbindungsarten
Syntax	Drop-Down-Menü
Anmerkung
Auswahlmöglichkeiten
friend	Es können ein- und ausgehende Rufe aufgebaut werden.
peer	Es können nur ausgehende Rufe aufgebaut werden.
user	Es können nur eingehende Rufe empfangen werden.

dtmfmode

dtmfmode
Beschreibung	Standard des Tonwahlverfahrens
Syntax	Drop-Down-Menü
Anmerkung
Auswahlmöglichkeiten
auto	Es wird automatisch ermittelt ob "rfc2833" oder "inband" genutzt wird.
rfc2833	DTMF-Töne nach RFC 2833 senden (RTP-Pakete)
inband	DTMF-Töne „inband“ als Audio senden
info	DTMF-Töne als SIP-INFO-Nachrichten senden

auth mode

auth mode
Beschreibung	Authentifizierungsmodus beim Provider
Syntax	Drop-Down-Menü
Anmerkung
Auswahlmöglichkeiten
Username/password	Authentifizierung über Benutzernamen und Passwort
IP address	Authentifizierung über IP-Adresse

auth user

auth user
Beschreibung	Art des Authentifizierungbenutzers beim Provider
Syntax	Drop-Down-Menü
Anmerkung	Das Feld "Authuser" in der Leitungskonfiguration wird erst nach dem speichern eingeblendet.
Auswahlmöglichkeiten
ohne	Es wird kein Authentifizierungsbenutzer übertragen
SIP-Benutzername	Es wird der Eintrag im Feld "Benutzername" der Leitungskonfiguration übertragen
Authuser	Es wird der Eintrag im Feld "Authuser" der Leitungskonfiguration übertragen

nat

nat
Beschreibung	Angabe des verwendeten NATs
Syntax	Drop-Down-Menü
Anmerkung	Es wird empfohlen dieses Feld nicht zu konfigurieren und die Netzwerkeinstellungen der STARFACE zu nutzen.
Auswahlmöglichkeiten
Standard
ja
nein	NAT wird nach RFC3581 behandelt

allow

allow
Beschreibung	Angabe der erlaubten Codec
Syntax	Freifeld / Alle Angaben in Kleinbuchstaben und kommagetrennt
Anmerkung	Die Reihenfolge der Angaben gibt die gewünschte Priorität vor.
Beispiele
<leer>	Erlaubt die folgenden 3 Codec "alaw","ulaw" und "gsm"
all	Erlaubt alle Codec
alaw,ulaw	Erlaubt die Codec "alaw" und "ulaw" in dieser Reihenfolge

insecure

insecure
Beschreibung	Sicherheitseinstellungen bezüglich ein- und ausgehender Rufe
Syntax	Freifeld / Alle Angaben in Kleinbuchstaben und Kommagetrennt
Anmerkung	Aktuell wird nur die Option "port,invite" unterstützt und muss eingetragen werden!
Auswahlmöglichkeiten
port	Ignoriert den Port von dem der Request kommt
invite	Keine Authentifizierung bei einkommenden Invites
port,invite	Kombination aus den beiden obrigen Auswahlmöglichkeiten

port

port
Beschreibung	Hier kann ein alternativer SIP-Port konfiguriert werden
Syntax	Freifeld
Anmerkung	Der Standard-SIP-Port der STARFACE ist 5060
Beispiele
<leer>	Port 5060 wenn "transport" ist "udp" / Port 5061 wenn "transport" ist "tls"
5080	Beispiel für eine abweichende Portangabe

transport

transport
Beschreibung	Auswahl des Netzwerkprotokolls
Syntax	Drop-Down-Menü
Anmerkung
Auswahlmöglichkeiten
udp	Unverschlüsselte Übertragung via UDP
tcp	Unverschlüsselte Übertragung via TCP
tls	Verschlüsselte Übertragung via TLS

defaultip

defaultip
Beschreibung	Standard-IP-Adresse bei der Nutzung eines dynamischen Hosts
Syntax	Freifeld
Anmerkung	Dieses Feld wird aktuell nicht beachtet!
Beispiele

rtpholdtimeout

rtpholdtimeout
Beschreibung	Angabe der Zeitdauer bis eine gehaltene Verbindung ohne RTP- und RTPC-Datenverkehr automatisch geschlossen wird
Syntax	Freifeld / Angabe in Sekunden
Anmerkung	Diese Angabe muss größer sein als der Eintrag bei "rtptimeout"
Beispiele
<leer>	Der Standardwert sind 300 Sekunden

fromdomain

fromdomain
Beschreibung	Setzt eine Domain, die von der STARFACE ausgehend signalisiert wird
Syntax	Freifeld
Anmerkung
Beispiele
<leer>	Es wird "starface.de" (ohne Anführungszeichen) als Domain bei ausgehenden Rufen gesetzt.

host

host
Beschreibung	Die IP-Adresse oder der DNS-Name des Providerservers
Syntax	Freifeld
Anmerkung	Es sind keine Mehrfacheintragungen möglich!
Beispiele
sip123.provider.com	Beispiel für einen DNS-Eintrag
60.70.80.90	Beispiel für die Eintragung einer IP-Adresse

Befinden sich in einer manuell eingerichteten Leitung in einem oder mehreren Ziffernblöcken an den führenden Stellen Nullen (z. B. 002.007.165.006), so müssen diese über die manuelle Leitungskonfiguration (Stiftsymbol neben dem Providerfeld) entfernt werden. Klicken Sie dafür auf das Stift-Symbol und entfernen im Feld host die entsprechenden Nullen. Klicken Sie auf "Speichern". Dadurch wird verhindert, dass ausgehende Anrufe mit “404 Not Found” abgebrochen werden.

permit

permit
Beschreibung	Angabe der IP-Adresse(n) mit der sich der Provider bei der STARFACE melden darf
Syntax	Freifeld / Mehrere Einträge kommagetrennt ohne Leerzeichen
Anmerkung
Beispiele
Angabe als IP-Adresse	192.168.0.60
Angabe als Adressraum	192.168.0.60/255.255.255.0
Addressraum in CIDR-Notation	192.168.0.60/24

deny

deny
Beschreibung	Angabe von IP-Adressen mit der sich der Provider bei der STARFACE nicht melden darf
Syntax	Freifeld / Mehrere Einträge kommagetrennt ohne Leerzeichen
Anmerkung
Beispiele
Angabe als IP-Adresse	192.168.0.60
Angabe als Adressraum	192.168.0.60/255.255.255.0
Addressraum in CIDR-Notation	192.168.0.60/24

canreinvite

canreinvite
Beschreibung	Dieses Feld wird in der aktuellen Konfiguration nicht beachtet.
Syntax	Drop-Down-Menü
Anmerkung	Dieses Feld wird in der aktuellen Konfiguration nicht beachtet.
Auswahlmöglichkeiten

disallow

disallow
Beschreibung	Angabe der nicht erlaubten Codec
Syntax	Freifeld / Alle Angaben in Kleinbuchstaben und kommagetrennt
Anmerkung	Es wird empfohlen alle Codec zu sperren und im Feld "allow" die erwünschten Codec zu hinterlegen.
Beispiele
<leer>	Erlaubt alle Codec
all	Sperrt alle Codec
g722,g729	Sperrt die Codec "g722" und "g729"

outboundproxy

outboundproxy
Beschreibung	Angabe des verwendeten Outbound-Proxy
Syntax	Freifeld / Angabe der IP-Adresse oder DNS
Anmerkung	Es sind keine Mehrfacheintragungen möglich!
Beispiele
<leer>	Es wird kein Outbound-Proxy verwendet
60.70.80.90	Angabe einer IP-Adresse
test.starface.de	Beispiel für einen DNS-Eintrag

progressinband

progressinband
Beschreibung	Konfiguration der Klingelsignalisierung
Syntax	Freifeld
Anmerkung
Auswahlmöglichkeiten
never	Wenn nicht der Provider das Klingeln signalisiert, wird dies von der STARFACE gemacht
no	Der Provider muss das Klingeln erzeugen
yes	Die Telefonanlage signalisiert immer das Klingeln
Standard	Der Provider muss das Klingeln erzeugen

qualify

qualify
Beschreibung	Zeitangabe wie lange bei versendeten SIP Options Paketen in Richtung Provider auf eine Rückantwort gewartet wird
Syntax	Drop-Down-Menü
Anmerkung	Es wird alle 60 Sekunden ein Qualify Paket von der Telefonanlage geschickt und diese Zeit kann nicht verändert werden.
Auswahlmöglichkeiten
yes	Es wird 2000ms auf eine Rückantwort auf die Qualify-Anfragen zum Provider gewartet.
no	Es werden keine Qualify-Anfragen in Richtung Provider geschickt.
Standard	Es werden keine Qualify-Anfragen in Richtung Provider geschickt.
Zahlenwert XXX	Es wird XXX auf eine Rückantwort auf die Qualify-Anfragen zum Provider gewartet.

encryption

encryption
Beschreibung	Konfiguration ob SRTP verwendet wird oder nicht
Syntax	Drop-Down-Menü
Anmerkung
Auswahlmöglichkeiten
yes	Es wird SRTP verwendet
no	Es wird kein SRTP verwendet

rtptimeout

rtptimeout
Beschreibung	Angabe der Zeitdauer bis eine aktive Verbindung ohne RTP- und RTPC-Datenverkehr automatisch geschlossen wird
Syntax	Freifeld / Angabe in Sekunden
Anmerkung	Diese Angabe muss niedriger sein als der Eintrag bei "rtpholdtimeout"
Beispiele
<leer>	Der Standardwert sind 60 Sekunden

mask

mask
Beschreibung	Angabe einer Netzwerkmaske für die Felder "deny" und "permit"
Syntax	Freifeld
Anmerkung	Dieses Feld wird aktuell in der Konfiguration nicht beachtet!

fromuser

fromuser
Beschreibung	Setzt einen Benutzer der von der Telefonanlage ausgehend im Invite signalisiert wird
Syntax	Freifeld
Anmerkung
Auswahlmöglichkeiten
<leer>	Als Benutzer wird die Rufnummer signalisiert
???????	Es wird der Benutzername aus den Leitungseinstellungen signalisiert
MaxMustermann	Als Benutzer wird "MaxMustermann" (ohne Anführungszeichen) signalisiert

resolve host

resolve host
Beschreibung	Angabe ob die Eingabe aus dem Feld "host" als IP-Adresse oder Hostname in die Konfiguration geschrieben wird
Syntax	Checkbox
Anmerkung	Wenn die Leitung nicht oder nicht mehr registriert ist, wird einmal pro Minute versucht den Host neu aufzulösen.
Auswahlmöglichkeiten
mit Haken	Der Hostname wird in die IP-Adresse aufgelöst und die IP-Adresse in die Konfiguration geschrieben
ohne Haken	Der Hostname wird nicht aufgelöst und direkt in die Konfiguration geschrieben

Kopfzeilen für SIP REGISTER

In dem Drop-Down-Menü "Contact" muss ausgewählt werden, welche Angabe im SIP-Registrierungspaket an den Provider übergeben wird. In dem nebenstehenden Drop-Down-Menü "Nummernformat" können Sie auswählen, in welchem Format die jeweilige Nummer in das SIP Registrierungspaket eingetragen wird.

Erste Nummer	Die erste Nummer des Rufnummernblocks wird eingetragen.	Alle
Stammnummer	Es wird nur die Stammnummer ohne Rufnummernblock eingetragen.	Alle
Benutzername	Der konfigurierte Benutzername der Leitung wird eingetragen.	keine Auswahlmöglichkeit
Freitext	Es kann ein beliebiger Freitext eingetragen werden.	Freitextfeld

Die Nummernformate bauen sich folgendermaßen auf:

+11 (222) XXX	+49 721 15104 123
11 (222) XXX	49 721 15104 123
0011 (222) XXX	0049 721 15104 123
0 222 XXX	0 721 15104 123
222 XXX	721 15104 123
Ohne Vorwahl	15104 123
No Screening	Dieser Wert sollte nicht verwendet werden.

Einstellungen für Wählformat und Rufnummernanzeige

In diesem Bereich können über die jeweiligen Drop-Down-Menüs das Wählformat und die Anzeige der ein- und ausgehenden Rufnummernanzeige konfiguriert werden. Die notwendigen Einstellungen müssen zu dem vom Provider erwarteten Format passen und auch von diesem vorgegeben werden.

Die Anzeige der Rufnummer wird für das SIP Protokoll in verschiedenen RFCs behandelt. Neben diesen RFCs gibt es noch weitere Einstellmöglichkeiten in der STARFACE, diese wurden teilweise speziell für Provider eingefügt, welche sich nicht in diesen Standards bewegen.

Bei der Nutzung des jeweiligen Typs muss unbedingt das geltende Datenschutzrecht beachten werden. Es muss eigenverantwortlich geprüft werden, ob die zum Provider übertragenen Daten den Anforderungen der Datenschutzbestimmungen genügen.

custom	From: Name <Nummer>	From: ANONYMOUS <username>
dusnet	From: Name <Nummer>	From: ANONYMOUS <0>
hfotelecom	P-Preferred-Identity: Name <sip:Nummer@starface.de>	From: Name <Nummer> P-Preferred-Identity: anonymous <sip:PAINummer@starface.de>
isdn	From: Nummer	From: anonymous <0>
m-net	From: Nummer <Nummer>	From: anonymous <Nummer> Privacy: id	Nummer ist im e.164-Format
qscconnect	Gleiche wie sipconnect, nur bei Rufweiterleitungen: Diversion: <sip:Nummer@domain>		Nummer ist im e.164-Format
remoteparty	Remote-Party-ID: Name <sip:Nummer@starface.de>
rfc3261	From: Name <Nummer>	From: ANONYMOUS <0>
rfc3323	XXX	XXX	Diese Rufnummernanzeige weißt in der Version 6.2 einige Bugs auf und sollte nicht verwendet werden.
rfc3325	From: Name <Nummer> P-Preferred-Identity: Name <sip:Nummer@starface.de>	From: ANONYMOUS <0> P-Preferred-Identity: ANONYMOUS <sip:0@starface.de> Privacy: id
sipconnect	From: Nummer <Nummer> P-Asserted-Identiy: <sip:Nummer@domain>	From: <sip:anonymous@anonymous.invalid> P-Asserted-Identiy: <sip:Nummer@domain> Privacy: id	Nummer ist im e.164-Format
sipgate	From: Nummer <Username>	From: ANONYMOUS <0>	Die Rufnummer wird normiert und ein führendes „+“ entfernt.
tcom	From: Nummer <Nummer> P-Asserted-Identity: <sip:nummer@domain>	From: Nummer P-Asserted-Identity: <sip:Nummer@domain> Privacy: id	Nummer ist im e.164-Format
tonline	From: Nummer <Nummer>	From: anonymous <0>
toplinkresale	P-Preferred-Identity: Name <sip:Nummer@starface.de>	Privacy: Id P-Asserted-Identity: <sip:Netzwerknummer@starface.de>

Erweiterte Einstellungen

In diesem Bereich kann über die Checkbox "Leitungsübergreifende Nummernerkennung" konfiguriert werden, das die STARFACE prüft ob ein eingehender Ruf auch in den Leitungskontext einer anderen Leitungskonfiguration passt.

Beschreibung der XML-RPC-Schnittstelle der iQueue

Die Klingelstrategie "iQueue" (siehe auch "iQueue konfigurieren" und "Auswertung für die iQueue konfigurieren") bietet für externe Anwendungen einen Zugriff auf die Live-Daten, wie auch auf History-Daten. Für die beiden Schnittstellen wird die XML-RPC Technologie genutzt. Die Live-Daten einer iQueue werden über die XML-RPC-Funktion "Queue.getLiveData" aufgerufen, welche einen Eingabeparameter erwartet:

<name>queueName</name> <string>…</string>

Diese Funktion liefert folgende Rückgabewerte:

callersLiveData (LIST) - Dieser Rückgabewert ist eine Liste, die wiederum Maps als Elemente enthält. Jede Map enthält Informationen (Schlüssel -> Wert) über genau einen Anrufer, der sich zu dieser Zeit in der Warteschlange befindet. Die Liste ist nach der Position des Anrufers in der Queue sortiert. Jede Map enthält die folgenden Schlüssel:

Callerid	String	Die eindeutige ID des Anrufs (z.B.: 995624b0-7385-404d-a658-dc942a1cbfe9)
CallerNumber	String	Die Telefonnummer des Anrufers
CallerName	String	Name des Anrufers in der Form "Gewählte Nummer: AnruferName Anrufernummer" (z.B.: 154813: Hans Mustermann 01238756)
CallerChannel	String	Die eindeutige ID des Anruferkanals (dies ist kein Rufkanal im physischen Sinne!)
CallerPriority	Int	Priorität des Anrufs
CallerTime	String	Der Unix-Timestamp des Eintritts in die Warteschlange (z.B.: 1304682789341)
CallerPosition	Int	Zeigt die aktuelle Position des Anrufers in der Warteschlange an. Die Position kann unter Umständen kurzzeitig von der tatsächlichen Position in der Queue abweichen. Ist der Anruf bereits durchgestellt, ist der Wert des Schlüssels -1.
CallerState	String	Ein Anruf kann einen von vier Zuständen haben: WAITING - Anrufer wartet im Moment in der Warteschlange. RINGING - Es wird versucht den Anrufer an einen Agenten zu vermitteln. CONNECTED - Der Anrufer ist mit einem Agenten verbunden. EXITED - Anrufer ist nicht länger in der Warteschlange, z.B. weil er aufgelegt wurde.
AgentId	String	Die Login-ID des Agenten, mit dem der Anrufer verbunden ist (z.B.: 0013). Dieser Wert ist für Caller-Status "CALLING" und "WAITING" leer
AgentName	String	Name des Agenten, mit dem der Anrufer verbunden ist. Dieser Wert ist für Caller-Status "CALLING" und "WAITING" leer.

agentsLiveData (MAP) - Dieser Rückgabeparameter ist eine Map, die wiederum Maps als Elemente enthält. Schlüssel der Map ist die Login-ID des Agenten. Jede Element-Map enthält Informationen (Schlüssel -> Wert) über einen Agenten:

AgentId	String	Login-ID des Agenten
AgentName	String	Name des Agenten
AgentGroupState	String	Zeigt an, ob der Agent momentan in der Gruppe angemeldet ist oder nicht. Mögliche Werte sind: ACTIVE - Agent ist in der Gruppe angemeldet INACTIVE - Agent ist von der Gruppe abgemeldet
AgentUserState	String	Zeigt den Benutzer-Status eines Agenten an. Mögliche Werte sind: DO_NOT_DISTURB - Der Agent hat DND/Ruhefunktion aktiv und wird deswegen von der Warteschlange nicht angerufen. AVAILABLE - DND ist bei diesem Agenten nicht aktiv und er kann von der Warteschlange angerufen werden (in Abhängigkeit seines Gruppen-/Telefoniestatus) UNAVAILABLE - DND ist bei diesem Agenten nicht aktiv und er kann nicht von der Warteschlange angerufen werden (in Abhängigkeit seines Gruppen-/Telefoniestatus)
AgentPhoneState	String	Zeigt die telefonische Erreichbarkeit (Status) eines Agenten: UNAVAILABLE - Der Agent ist an keinem Telefon angemeldet und kann deswegen nicht angerufen werden. AVAILABLE - Der Agent telefoniert momentan nicht und kann angerufen werden, wenn sein Gruppen- und Benutzer-Status das erlauben. RINGING - Der Agent wird momentan angerufen. ACTIVE - Der Agent ist gerade im Gespräch oder in der Rufaufbauphase. QUEUE_PAUSE - Der Agent ist gerade in der Nachberarbeitungszeit.

History Schnittstelle

Die historischen Daten einer iQueue werden über die XML-RPC-Funktion "Queue.getHistoryData" aufgerufen. Der Eingabeparameter hierfür ist ein "struct" mit drei Wertangaben:

queueName	String	Name der gewünschten iQueue-Gruppe
from	dateTime.iso8601	Beginn der Zeitspanne (muss einen XML-RPC konformen Zeit-Wert enthalten)
to	dateTime.iso8601	Ende der Zeitspanne (muss einen XML-RPC konformen Zeit-Wert enthalten)

Diese Funktion hat einen Rückgabewert:

queueHistoryData (LIST) - Die Elemente der Liste sind Maps und jede Map enthält Informationen über genau einen Anruf. Die Liste ist nach dem Timestamp der Anrufe sortiert. Jedes Element der Liste enthält die folgenden Schlüssel:

callId	String	ID des Calls in der DB beginnend mit 1.
callStepId	Int	Fügt mehrere Einträge verschiedener User zusammen, wenn sie zu einem Call gehören.
callLegUUID	String	Eindeutige ID des CallLegs
agentId	String	Login des Agenten der den Ruf angenommen hat / Leeres Feld = Nicht angenommener Ruf
cdrAccountId	Int	Account ID des Users dem der Ruflisteneintrag gehört.
callerAccountId	Int	Account ID des Anrufers, falls es ein interner User war, sonst leer.
calledAccountId	Int	Account ID des Angerufenen, falls es ein interner User war, sonst leer.
calledCallerId	String	Callerid wie sie auf dem Telefon angezeigt wird.
startTime	String	Startzeitpunkt des Calls als Unix Timestamp
ringingtime	String	Startzeitpunkt des Klingelns beim Agenten des Calls als Unix Timestamp
linktime	String	Vebunden mit dem Agenten als Unix Timestamp
callresulttime	String	Der Anruf wurde beendet als Unix Timestamp
callresult	String	Das Ergebnis des Callabschnitts.
callResultCauseBy	Int	Accountid des Users der das Ergebnis ausgelöst hat.
lineid	Int	Die verwendete Leitung
lineName	String	Name der verwendeten Leitung
callbacknumber	String	Die Rückrufnummer des Gegenparts zu dem dem der Ruflisteneintrag gehört
answeredelswere	String	Nur gefüllt, wenn der Anruf von jemand anderem beantwortet wurde
incoming	Boolean	True für einen eingegangen Anruf
answered	Boolean	True für einen beantworteten Anruf
hasvoicemail	Boolean	True falls eine Voicemail aufgezeichnen wurde.
hasmonitor	Boolean	True für eine Aufzeichnung des Gesprächs
callbacknumberextern	Boolean	True falls die Rückrufnummer eine externe Nummer ist

Beispiel

Per Post Methode:

http://IP-ADRESSE/xml-rpc?de.vertico.starface.auth=$LoginID:SHA512($LoginID*SHA512($Passwort))

Das Passwort wird im ersten Schritt mit SHA512 gehasht. Danach wird dieser Hash nochmals mit der LoginID als Präfix und dem Trennzeichen * erneut gehasht. Für einen Benutzer mit den folgenden Eckdaten:

LoginID = 0001
Passwort = starface
IP-Adresse der STARFACE = 192.168.0.100

ergibt sich als Aufruf-URL für XML-RPC:

http://192.168.0.100/xml-rpc?de.vertico.starface.auth=0001:5273503e607e5b24eeb48a3f71c53eb50df6b6622839ecd7149e248893f627d05d8d4af88cf36b3d7d5cd5d1d559dfa1c10404067d8c0f37a138c6546dad7ef7

Der Body würde dann z .B. so aussehen:

Beispiel

<?xml version="1.0" encoding="UTF-8"?>
<methodCall>
   <methodName>Queue.getHistoryData</methodName>
   <params>
      <param>
         <value>
            <struct>
               <member>
                  <name>queueName</name>
                  <value>
                     <string>testIq</string>
                  </value>
               </member>
               <member>
                  <name>from</name>
                  <value>
                     <dateTime.iso8601>20150701T12:59:05</dateTime.iso8601>
                  </value>
               </member>
               <member>
                  <name>to</name>
                  <value>
                     <dateTime.iso8601>20160701T12:59:05</dateTime.iso8601>
                  </value>
               </member>
            </struct>
         </value>
      </param>
   </params>
</methodCall>

Beschreibung der CSV-Datei für "Leitungsnutzungsdaten exportieren"

Klicken Sie hier, um zu erweitern...

Die Auswertungsdaten zeigen, welche Leitungen innerhalb eines Calls genutzt worden sind (z. B. welche Leitung für einen ausgehenden Ruf genutzt wurde). Die Ausgabe der Leitungsdaten erfolgt als CSV-Datei mit dem Namen „output.csv". Die Ausgabedatei ist dabei folgendermaßen aufgebaut:

id	long	Fortlaufende Listen-ID
callid	long	ID des Rufes
callleguuid	String (UUID)	ID des Calllegs
calleraccountid	int (id von Tabelle account, 0 für extern)	Interne Benutzer ID des Anrufenden
callerlogin	String	Login ID des internen Benutzers (Start)
callernumber	String	Primäre Nummer des anrufenden Benutzers
calledaccountid	int (id von Tabelle account, 0 für extern)	Interne Benutzer ID des Angerufenen
calledlogin	String	Login ID des internen Benutzers (Ziel)
callednumber	String	Primäre Nummer des angerufenen Benutzers
starttime	String (format: dd.MM.yyyy HH:mm:ss)	Startzeitpunkt des Rufes
ringingtime	String (format: dd.MM.yyyy HH:mm:ss)	Startzeitpunkt des Klingelns
linktime	String (format: dd.MM.yyyy HH:mm:ss)	Annahmezeitpunkt des Rufes
hanguptime	String (format: dd.MM.yyyy HH:mm:ss)	Endzeitpunkt
callresult	String (CONNECTED oder NOT_CONNECTED)	Status des Rufes
lineid	int	ID der verwendeten Providerleitung
linename	String	Name der verwendeten Providerleitung
channelname	String	Asterisk Benennung der Leitung
incoming	Boolean	Eingehender Ruf über eine Leitung? (Statusfeld)
answered	Boolean	Ruf angenommen? (Statusfeld)
duration	long	Dauer des Rufes