Click to Dial

Calls can also be initiated from the PBX using three different types of web links.

  1. Links without session and password: When the PBX sends out emails, it includes links that contain the number to dial and the account to use, but not the authentication information. These links have the following form:

    http://pbx/remote_call.htm?user=123%40domain.com&dest=123456789

    The parameter "user" identifies the extension that should initiate the call. The parameter "dest" indicates which number should be dialed. The PBX will challenge the user, and the user must answer the challenge with the username and the password. The username must contain the domain (e.g. "123@domain1.com") if there are several domains on the system.

  2. Links without session but with an md5 hash of the concatenation of username, password, destination number and current time in seconds (since 01/01/1970), which are valid for 2 hours:

    http://pbx/remote_call.htm?user=123&extension=true&dest=123456789&time=current_time&auth=hash

    The parameter "user" identifies the extension that should initiate the call. The parameter "extension=true" makes sure the pbx uses the kind of authentication used here. The parameter "dest" indicates which number should be dialed. The parameter "auth" is used for authentication purposes. It is an md5 hash and calculated as md5(user+pass+dest+time). Every parameter must be URL-encoded, including the resulting hash.

  3. Links without session but with password: In some situations, you cannot answer the challenge from the PBX. For example, if you have a script that makes the PBX start a call, you want to include the credentials in the link already. These links have the following form:

    http://pbx/remote_call.htm?user=123%40domain.com&dest=123456789&auth=123%40domain.com%3Asecret

    The parameter "user" identifies the extension that should initiate the call. The parameter "dest" indicates which number should be dialed (like above). The parameter "auth" use used for authentication purposes. It must have the form "username:password" and it must be URL-encoded.

  4. Links without 'press 1' prompt: In some situations, you want to be connected to the destination without having to listen the message 'press 1 to continue' and pressing the digit '1'. You can use 'connect=true' parameter as shown below to achieve this.

    http://pbx/remote_call.htm?user=123%40domain.com&dest=123456789&auth=123%40domain.com%3Asecret&connect=true