FLYINGVOICE Action URL and Active URI User Guide
- August 14, 2024
- FLYINGVOICE
Table of Contents
User Guide of Action URL and Active URI
Version:1.0
Jul.2020
Introduction
Overview
Action URL is used by the phone to report the current status to the remote
console. The remote console uses Active URI to control the phone to perform
various operations.
Action URL and Active URI are mainly used in Computer Telephony Integration
(CTI) scenarios. The phone reports its own status to the PC, and the PC
controls various operations of the phone. The call center is a typical
application scenario, the operator uses the CTI software on the PC to control
the phone.
Action URL
2.1 Introduction
Each action on the phone will generate a URL, which is Action URL, such as
Off-hook, On-hook, Incoming call, Outgoing call, etc. The URL can be
customized by the user. When there is a certain action, the phone will send an
HTTP Get request to the URL to report its own status.
2.2 Protocol Description
The HTTP URL format of Action URL is defined by the HTTP Server of the
console, and the phone is only responsible for sending HTTP Get requests when
the status changes. In general, the HTTP URL format of Action URL as follows.
http://192.168.20.76/outgoing.xml?ip=$ip
- 192.168.20.76 is the IP address of the remote console.
- outgoing indicates the phone status, ip=$ip indicates the phone’s IP address.
The URL means when the phone makes an outgoing call, the remote console ( with
IP address 192.168.20.76) receives the phone( with IP address $IP) status is
making outgoing call.
2.3 Action URL Configuration
Log in to the phone’s management page and go to Phone -> Action URL
, enter the URL for the corresponding event. For example, for an outgoing call
event, enter the URL
http://192.168.20.76/outgoing.xml?ip=$ip.
When there is an outgoing call, the phone will send an HTTP Get request
GET /outgoing.xml?ip=192.168.20.134 2.4 Predefined Events List
Event|
Description
---|---
Off-hook| When the IP phone is off hook.
On-hook| When the IP phone is on hook.
Outgoing Call| When the IP phone places a call.
Incoming Call| When the IP phone receives a call.
Established| When the IP phone establishes a call.
Terminated| When the IP phone terminates a call.
Missed Call| When the IP phone misses a call.
Activate DND| When the IP phone enables the DND mode.
De-activate DND| When the IP phone disables the DND mode.
Activate Always Forward| When the IP phone enables the Always Forward.
De-activate Always Forward| When the IP phone disables the Always Forward.
Activate Busy Forward| When the IP phone enables the Busy Forward
De-activate Busy Forward| When the IP phone disables the Busy Forward.
Activate No Answer Forward| When the IP phone enables the No Answer Forward.
De-activate No Answer Forward| When the IP phone disables the No AnswerFor
ward
Hold| When the IP phone places a call on hold.
Unhold| When the IP phone resumes a held call.
Registered| When the IP phone successfully registers an account.
Registration Failed| When the IP phone fails to register an account.
Unregistered| When the IP phone logs out of the registered account.
Transfer Call| When the IP phone transfers a call.
Blind Transfer| When the IP phone performs the blind transfer.
Attended Transfer| When the IP phone performs the attended transfer.
Idle to Busy| When the state of the IP phone changes from idle to busy.
Busy to Idle| When the state of the IP phone changes from busy to idle.
Setup Completed| When the IP phone setup completed.
IP Changed| When the IP address of the IP phone changes.
2.5 Variable Values List
Variable Value
|
Description
---|---
$mac| The MAC address of the IP phone.
$ip| The IP address of the IP phone.
$model| The model number of the IP phone.
$firmware| The firmware version of the IP phone.
$active_url| The SIP URI of the current account when the IP phone places a
call, receives an incoming call or in a conversation.
$active_user| The user part of the SIP URI for the current account when the
IP phone places a call, receives an incoming call or in a conversation.
$active_host| The host part of the SIP URI for the current account when the
IP phone places a call, receives an incoming call or in a conversation.
$local| The SIP URI of the callee (valid in outgoing calls and incoming
calls).
$remote| The SIP URI of the caller when the IP phone receives an incoming
call.
$display_local| The display name of the callee (valid in outgoing calls and
incoming calls).
$display_remote| The display name of the caller when the IP phone receives an
incoming call.
$call_id| The call-id of the active call. (Valid in incoming calls, outgoing
calls, and conversations)
Active URI
3.1 Introduction
Active URI is the HTTP Get request initiated by the remote console, then the
phone’s HTTP Server parses the command and responds to the request for the
console to control the phone remotely.
3.2 Variable Values List
Variable Value | Description |
---|---|
key=ok | key=Enter |
pick up the phone; send the number; enter the menu under standby.
key=Speaker| Turn on the Speakerphone mode.
key=F_TRANSFER| Transfer a call to another party.
key=VOLUME_UP| Increase the volume.
key=VOLUME_DOWN| Decrease the volume.
key=MUTE| Mute a call.
key=F_HOLD| Place an active call on hold.
*** key=X| Cancel actions, reject incoming calls or mute or un-mute calls.
key=F_CONFERENCE| Press the Conf/Conference key.
key=F1| Press the first soft key.
key=F2| Press the second soft key.
key=F3| Press the third soft key.
key=F4| Press the fourth soft key.
key=MSG| Press the MESSAGE key.
key=HEADSET| Press the HEADSET key.
key=RD| Press the Redial key.
key=UP| Press the UP navigation key.
key=DOWN| Press the DOWN navigation key.
key=LEFT| Press the LEFT navigation key.
key=RIGHT| Press the RIGHT navigation key.
key=Reboot| Reboot the phone.
key=AutoP| Detect auto provision update.
key=DNDOn| Activate DND mode.
key=DNDOff| Deactivate DND mode.
key=0-9| Press the keypad 0-9.
key=| Press the keypad *.
key=POUND| Press the keypad #.
key=L1-L8| Press the Linekeys.
key=D1-D10| Press the Linekeys.
3.3 Protocol Description
The format of HTTP URL of Active URI is as follows.
http:’192.108.1.190/cgi-bin’ConfigManApp.com?key=OK”
- 192.168.1.190 is the IP address of the phone.
- /egi-bin/ConfigManApp.com is the Active URL, it is the fixed format of Active URI.
- ?key=OK is the instruction type, it indicates the action to be performed by the phone.Generally, this instruction is a key event.
When using the URI function, you will be redirected to a login interface,
enter the login username and password to continue,the default username and
password are admin.
3.4 Send a Number with Active URI
The preceding Active URI instruction only supports initiating one event to
the phone at a time, which is inconvenient. Active URI supports sending the
number in the URI.
For the following Active URI, we can replace phoneIP with the phone’s IP
address, replace the number=xxx to the number that you want to dial, replace
the outgoing uri=xxx to the number that you used to dial.
hup://phonelP/cgi-bin/ConfigManApp.com?number=xxxGoutgoing_un=Xxxx
For example:
hitp://192.168.20.177‘cgi-bin‘ConfigManApp.com?number=2G outgoing _uni=3ia.
192. 168.20.22
number=2 indicates will dial number 2, outgoing uri=3@192.168.20.22 indicates
the phone use number 3 to make the outgoing call, the PBX server’s IP address
is 192.168.20.22.