Yes, the phone´s HTTP interface allows remote users to simulate the usage of the phone´s keypad and a few special features. (Only applicable for snom desktop phones)

Syntax

The URL to press one or more keys is the address of your phone with the page ’command.htm’ and the post value "key=KEYEVENT":

http://phoneIP/command.htm?key=KEYEVENT[;KEYEVENT]
        

KEYEVENTs are separated by a semicolon from each other. KEYEVENT contains the following values:

KEYEVENT = Key[,Time[,Pause]]


Whereas Key is the key to be pressed, Time is the amount in milliseconds that a key is to be pressed (this way real key presses can be simulated, or a long press of a key can be achieved). Pause is the time in milliseconds that shall elapse between key presses (when the command contains more than one KEYEVENT). The values Time and Pause are optional.

If HTTP user name and HTTP password are enabled, the request must contain the credentials:

http://username:password@192.168.0.1/command.htm?key=KEYEVENT


  • Internet Explorer does not support user names and passwords in Web site addresses (HTTP or HTTPS URLs).
  • This will not work if you have set Authentication Scheme to "on". "On" means that you are using digest-authentication which just supports the username and password as encrypted (MD5-hash-sum) values and not to be given as clear text in the URI. If you want to use digest-authentification, you have to pass the credentials to the tool which calls the URL or the library you are using for calling the URL, most of the tools/library support this method.
  • If you have changed HTTP UserHTTP Password and the Administrator Password from the default value, hidden tags have to be disabled in order to use the remote control feature.


The following KEYEVENTs are known to the firmware of the phone (written exactly as shown below in capital letters):

snom3xx, 7xx and snom8xx

CANCEL = "Cancel" key pressed, e.g. a call can be terminated
ENTER = "Enter" key pressed
OFFHOOK = simulates lifting up the handset
ONHOOK = simulates hanging up the handset
RIGHT = simulates pressing right navigation key
LEFT = simulates pressing left navigation key
UP = simulates pressing "up" navigation key
DOWN = simulates pressing "down" navigation key
VOLUME_UP = increases volume in active audio mode (handset / speaker / headset)
VOLUME_DOWN = reduces volume in active audio mode (handset / speaker / headset)
MENU = simulates pressing MENU key (not used in FW 7 anymore)
REDIAL = simulates pressing REDIAL key
DND = simulates pressing DND key
REC = simulates pressing Record key
F1, F2, F3, F4 = simulates pressing context sensitive soft function keys (located directly below the display of the phone) NOTE: snom 190/200 have no key F4 and snom870 no key F1-F4
SPEAKER = simulates pressing SPEAKER key
HEADSET = simulates pressing HEADSET key
TRANSFER = simulates pressing TRANSFER key
F_HOLD = simulates pressing HOLD key (Before firmware version 8.7.3.7: F_R)
0-9, *, # = simulates pressing the alphanumeric keypad NOTE: with some browsers for # and * you might need to use the ASCII code. For example %23 instead of #, %2A instead of *
P1-PX = simulates pressing free programmable function keys (X=15 for snom870, X=12 for snom320/360/370/820, X=4 for snom300).
EK0- EKmax =  simulates pressing free programmable function keys of expansion module. Note: expansion module Only for snom3xx.

snom2xx/snom1xx only

DISCONNECT = disconnects a call
CLEAR = "Clear" Key pressed
FUNCTION = "F" (Menu Key on snom200/190) pressed
RECALL = "Hold" button in the left lower corner of the keypad of the snom 190/200/220
P1-PX = simulates pressing free programmable function keys (X=5 for snom190/200/220).
EK0- EKmax = extension keyboard snom220

Other Commands

There are also other functions which can be controlled remotely (desktop phones only):

Remote Dialing: http://phoneIP/command.htm?number=NUMBER&outgoing_uri=URI
Remote DTMF tones: http://phoneIP/command.htm?key_dtmf=NUMBER
Remote End all ongoing calls: http://phoneIP/command.htm?RELEASE_ALL_CALLS
Remote Logoff all identities: http://phoneIP/command.htm?LOGOFFALL
Remote Logoff a specific identity: http://phoneIP/command.htm?LOGOFFLINE=1(..12)
Remote Reregister a specific identity: http://phoneIP/command.htm?REREGISTER=1(..12)
Remote Ringtone Playing: http://phoneIP/line_login.htm?PLAY_RINGER:X=+Ringer(X=1..9)
Remote Reboot: http://phoneIP/advanced_update.htm?reboot=Reboot
Remote Reset: http://phoneIP/advanced_update.htm?reset=Reset
Remote Reset of Dialed Numbers: http://phoneIP/index.htm?dialeddel=0
Remote Reset of Missed Calls: http://phoneIP/index.htm?misseddel=0
Remote Reset of Received Calls: http://phoneIP/index.htm?receiveddel=0
Remote Firmware Upgrade: https://phoneIP/dummy.htm?swload=load&firmware=firmwareURL
Fix the line-info-layer for screen.bmp (820/21): http://phoneIP/command.htm?FIX_LIL=true


Since versions 8.4.34 and 8.7.2 you can also emulate pressing the touchscreen of the snom870.

X must be between 0 and 479, where 0 is the left display edge and 479 the right one. Y must be between 0 and 271, where 0 is the upper display edge and 271 the lower one.

just press, dont release: http://phoneIP/command.htm?touch=X Y press
brief version:            http://phoneIP/command.htm?touch=X Y p
release when formerly pressed: http://phoneIP/command.htm?touch=X Y release
brief version:                 http://phoneIP/command.htm?touch=X Y r
press and release with one cmd: http://phoneIP/command.htm?touch=X Y pr
brief version:                  http://phoneIP/command.htm?touch=X Y
chained commands: http://phoneIP/command.htm?touch=X Y pr X2 Y2 pr X3 Y3 pr

Examples


Attended Transfer (Incoming call A, transferred by B to C):



Related articles:


Ja, die Web-Benutzeroberfläche erlaubt Benutzern den Fernzugriff auf die Telefon-Bedienoberfläche und einige Sonderfunktionen. (Nur für die snom Tischtelefone zutreffend)

Syntax

Die URL um eine oder mehrere Tasten zu drücken besteht aus der IP-Adresse des Telefons, der Seite ’command.htm’ und einem folgenden Wert "key=KEYEVENT":

http://IP-des-Telefons/command.htm?key=KEYEVENT[;KEYEVENT]

Mehrere KEYEVENTS sind dabei durch Semikolon getrennt. Ein KEYEVENT enthält folgende Werte:

KEYEVENT = Taste[,Zeit[,Pause]]

Wobei Taste die zu drückende Taste ist. Zeit ist der Wert in Millisekunden, wie lange die Taste gedrückt werden soll (damit kann ein realer Tastendruck simuliert bzw. das lange Drücken einer Taste erreicht werden). Pause ist die Zeit in Millisekunden, die gewartet werden soll bevor die nächste Taste gedrückt wird (wenn mehrere KEYEVENTs in einem Kommando enthalten sind). Die Werte Zeit und Pause sind optional.

If HTTP user name and HTTP password are enabled, the request must contain the credentials:

http://username:password@192.168.0.1/command.htm?key=KEYEVENThttp://username:password@192.168.0.1/command.htm?key=KEYEVENT


Hinweis: Internet Explorer unterstützt Benutzernamen und Passwörter in Webseiten-Adressen (HTTP oder HTTPS URLs) Microsoft support page


Hinweis: Diese Methode funktioniert nicht, wenn Settings/http_scheme auf "on" gesetzt ist. "On" bedeutet das Digest-Authentifizierung benutzt wird, welche den Benutzernamen und Passwort nur als verschlüsselte Werte akzeptiert und nicht als Klartextwerte. Wenn Sie Digest-Authentifizierung benutzen wollen, müssen Sie die Authentifizierungsdaten an das die URL aufrufende Tool oder die genutzte Bibliothek übergeben, die meisten Tools/Bibliotheken unterstützen diese Methode.


Hinweis: Wenn HTTP User, HTTP Password und das Administrator Passwort gesetzt wurden bzw. nicht dem Standardwert entsprechen, muss die Einstellung Versteckte Merkmale deaktiviert sein.


Die Firmware des Telefons kennt die folgenden KEYEVENTs:

snom3xx, 7xx and snom8xx

CANCEL = "Cancel" Taste wird gedrückt u.a. kann ein Gespräch beeendet werden
ENTER = "Enter" Taste wird gedrückt
OFFHOOK = simuliert das Abnehmen des Hörers
ONHOOK = simuliert das Auflegen des Hörers
RIGHT = simuliert das Drücken der rechten Navigationstaste
LEFT = simuliert das Drücken der linken Navigationstaste
UP = simuliert das Drücken der Navigationstaste nach "oben"
DOWN = simuliert das Drücken der Navigationstaste nach "unten"
VOLUME_UP = erhöht Lautstärke im aktiven Audio-Modus (Hörer / Lautsprecher / Headset)
VOLUME_DOWN = verringert Läutstärke im aktiven Audio-Modus (Hörer / Lautsprecher / Headset)
MENU = simuliert das Drücken der Menutaste(wird in Firmware-Version 7 NICHT mehr verwendet)
REDIAL = simuliert das Drücken der Redial-Taste
DND = simuliert das Drücken der DND-Taste
REC = simuliert das Drücken der Record-Taste
F1, F2, F3, F4 = simuliert das Drücken der kontextsensitiven Funktionstasten (befinden sich direkt unterhalb der Anzeige des Telefons) Beachte: snom 190/200 verfügen nur über F1-F3 und snom870 verfügt über keine kontextsensitiven Funktionstasten
SPEAKER = simuliert das Drücken der Speaker-Taste
TRANSFER = simuliert das Drücken der Transfer-Taste
F_HOLD = simuliert das Drücken der Hold-Taste (Vor Firmware Version 8.7.3.7: F_R)
0-9, *, # = simuliert das Drücken der alphanumerischen Tasten (mit manche Browser für '#' und '*' muss man die ASCII Kodierung benutzen, zB '%23' statt '#')
P1-PX = simuliert das Drücken von frei programmierbaren Funktionstasten (X=12 für snom320/360/370, X=4 für snom300).
EK0- EKmax =  simuliert das Drücken von frei programmierbaren Funktionstasten bei Erweiterungsmodulen. Gilt nur für snom3xx.

Diese Funktionen gelten nur für snom2xx und snom1xx Telefone:

DISCONNECT = disconnects a call
CLEAR = "Clear" Key pressed
FUNCTION = "F" (Menu Key on snom200/190) pressed
RECALL = "Hold" button in the left lower corner of the keypad of the snom 190/200/220
P1-PX = simulates pressing free programmable function keys (X=5 for snom190/200/220).
EK0- EKmax = extension keyboard snom220

Andere Befehle

Es gibt auch andere Funktionen, die ferngesteuert werden können (nur Tischtelefone).

Fernwahl: http://phoneIP/command.htm?number=NUMBER&outgoing_uri=URI
            
Entfernte DTMF-Töne: http://phoneIP/command.htm?key_dtmf=NUMBER
Remote Beenden aller laufenden Anrufe: http://phoneIP/command.htm?RELEASE_ALL_CALLS
Entfernte Abmeldung aller Identitäten: http://phoneIP/command.htm?LOGOFFALL
Remote Logoff eine bestimmte Identität: http://phoneIP/command.htm?LOGOFFLINE=1(..12)
Remote Reregistrierung einer bestimmten Identität: http://phoneIP/command.htm?REREGISTER=1(..12)
Remote-Klingelton Wiedergabe: http://phoneIP/line_login.htm?PLAY_RINGER:X=+Ringer(X=1..9)
Fernneustart: http://phoneIP/advanced_update.htm?reboot=Reboot
Fernrückstellung: http://phoneIP/advanced_update.htm?reset=Reset
Fernrückstellung der gewählten Nummern: http://phoneIP/index.htm?dialeddel=0
Fernrückstellung verpasster Anrufe: http://phoneIP/index.htm?misseddel=0
Fernrückstellung empfangener Anrufe: http://phoneIP/index.htm?receiveddel=0
Fern-Firmware-Upgrade: https://phoneIP/dummy.htm?swload=load&firmware=firmwareURL
Korrigiert die Zeilen-Info-Schicht für screen.bmp (820/21): http://phoneIP/command.htm?FIX_LIL=true


Seit den Versionen 8.4.34 und 8.7.2 können Sie auch das Drücken des Touchscreens des snom870 emulieren.

X muss zwischen 0 und 479 liegen, wobei 0 der linke Bildschirmrand und 479 der rechte ist. Y muss zwischen 0 und 271 liegen, wobei 0 der obere und 271 der untere Rand der Anzeige ist.

einfach drücken, nicht loslassen: http://phoneIP/command.htm?touch=X Y Presse
Kurzfassung: http://phoneIP/command.htm?touch=X Y p
Freigabe bei vorheriger Betätigung: http://phoneIP/command.htm?touch=X Y Freigabe
Kurzfassung: http://phoneIP/command.htm?touch=X Y r
drücken und loslassen mit einem cmd: http://phoneIP/command.htm?touch=X Y pr
Kurzfassung: http://phoneIP/command.htm?touch=X Y
verkettete Befehle: http://phoneIP/command.htm?touch=X Y pr X2 Y2 pr X3 Y3 pr

Examples


Attended Transfer (Eingehender Anruf A, weitergeleitet von B nach C):

  1.     http://192.168.6.252/command.htm?key=F_HOLD --> Hält den Anruf "A".
  2.     http://192.168.6.252/command.htm?key=X (X=0-9) --> Wiederholen Sie dies für jede Ziffer der zu übertragenden Zahl "C".
  3.     http://192.168.6.252/command.htm?key=ENTER --> "B" ruft "C" an und kündigt die Übertragung an.
  4.     http://192.168.6.252/command.htm?key=TRANSFER --> Anruf wird weitergeleitet
HINWEIS: Wenn der Parameter "Call Join on Xfer (2 Anrufe)" auf "ON" gesetzt wurde, wird stattdessen die Liste "Calls on Hold" angezeigt (in diesem entfernten Szenario nicht empfohlen, da dies eine Navigation durch die Liste und einen letzten Befehl erfordern würde: http://192.168.6.252/command.htm?key=TRANSFER/ENTER).




Verwandte Artikel: