HTTP Dialer Tutorial

Configuring the HTTP Dialer

WebFones provides an HTTP interface that allows users to initiate dialing through the applications they use to track customers. This allows them to press a button on the interface of the application to call a customer instead of having to pick up the phone and dial the number. While it is a simple feature, customers say it offers significant time savings.

How Dialing Works

Dialing works by combining a unique identifier called a passcode with a destination phone number and passing it to the WebFones application server. An optional message can be passed in to identify who you are calling on the phone display (such as "Dialing John").

When the URL call is made, WebFones matches the passcode with the phone on the user's desk and initiates an incoming call to that phone. The user only has to pick up the receiver for the call to initiate to the customer.

Preparing Applications For Dialing

The URL dialer works equally as well with desktop and web applications. However, your application needs a user preferences page or panel that will store the passcode.

The WebFones passcode can be found on the User Extensions General Tab for each user. It is a 10-20 character key that is used to uniquely identify the user for dialing purposes. The application needs to store the passcode so it can be used when the user initiates dialing from the application.

Here is an example of what the preferences panel input might look like:

Configure WebFones Dialing

WebFones Passcode: [FIELD      ]

For more information about this service, please visit www.webfones.com.

The tool tip could be: "Enter the passcode found on your User Extensions page or visit www.webfones.com to signup."

When preparing your application for dialing, consider these two scenarios:

  1. If users login to any one of several generic stations (as would be the case if users don't have assigned phones), the passcode needs to be attached to the station since it will dial the phone at that station.
  2. If users have a private phone or set of phones, then the passcode needs to be attached to the user.

In some cases, you may need to support both of these scenarios in your application.

Calling the Dialer

When your user initiates dialing through your application, you combine the passcode of the user with the number they want to dial and call this URL:

https://www.webfones.com/phpscripts/webfones_dial.php?p=passcode&m=message&n=number

Here are the parameters that need to be substituted:

passcode -> Is a long string of numbers and characters that identify your extension. No spaces.

message -> Is what you want to show up on your phone when dialing. Must be web-safe.

number -> This should be a valid 10+ digit number with no punctuation or spaces. Do not specify 1 in front of the number. If this is an international call, dial with a "011" in front of the number.