View source for Send URL

{{Breadcrumb|0|0|{{dev-en}}|OpenScape Desk Phone CP}}

== Introduction ==
The Send URL function on the OpenScape Desk Phone CP devices, allows a user to send a predefined HTTP or HTTPS request to a server in order to trigger a remote action. The functionality is available from a free programmable key (FPK), that has been configured for this feature.
In the server response to a phones HTTP or HTTPS request, the phone can be triggered to (e.g.)
* turn on the LED of the configured FPK (in different colours)
* use a different blinking mode
* overwrite the FPK label (CP600 only)

== Technical details ==
* The request can be sent in plain HTTP or encrypted HTTPS
* The request can be of type GET or POST
* The phone will not follow any type of redirect (3XX)
* Authentication User ID and password will be sent as Parameters (no HTTP Basic Authentication)
* When using HTTPS, the connected server can be validated according to the Authentication Policy (see Administration Guide)

== Configuration ==
A Send URL FPK can be configured via web based management or DLS. Please see example screenshot from WBM.

[[File:SendURL_DeskPhoneCP_Configuration.png|200px|thumb|left|WBM ’Send URL FPK’ configuration]]<br clear="left" />

This FPK (if pressed) will trigger the following request

  {{#tag:nowiki|https://10.10.0.255:443/?userid=MyUsername&password=MyPassword&id=1&item=2&ipaddress=<IP-OF-DEVICE>&phonenumber=<E164-OF-DEVICE>&devicetype=OpenStage&symbn=MySymbolicName}}

The parts of the URL linked to the configuration items can be seen in the following table

{| {{DefaultTable}}
|-
! width="150" | URL part
! width="200" | Configuration Item
! width="300" | Example Value
|-
| Method
| Method
| GET
|-
| Protocol
| Protocol
| https
|-
| Hostname
| Web server address
| 10.10.0.255
|-
| Port
| Port
| 443
|-
| Path
| Path
| /
|-
| Parameter
| Parameters
| id=1&item=2
|-
| Parameter
| Web server user ID
| userid=MyUsername
|-
| Parameter
| Web server password
| password=MyPassword
|-
| Parameter
| Symbolic name
| symbn=MySymbolicName
|-
| Parameter
| not configurable
| ipaddress=<IP-OF-DEVICE>
|-
| Parameter
| not configurable
| phonenumber=<E164-OF-DEVICE>
|-
| Parameter
| not configurable
| devicetype=OpenStage
|}