Making phone calls in Web applications

You can embed the ClickToCall widget in an existing application to allow users to enter their phone number and request an immediate callback from your company. You embed the Communications Enabled Applications (CEA) widget using the Dojo Toolkit included with the CEA Feature Pack.

Before you begin

Avoid trouble: For a list of restrictions that are changed based on various service levels of the product, see the topic What is new in the Feature Pack for CEA.gotcha

Dojo widgets are prepackaged components of JavaScript™ code, HTML markup and CSS style declarations that can be used to enhance Web sites with interactive features. You can use the Dojo Toolkit that comes with the CEA feature to embed the CEA widgets in your applications. This capability also requires an IP private branch exchange (PBX) as part of your infrastructure. An IP PBX is a business telephone system designed to deliver voice over a data network and interoperate with the Public Switched Telephone Network (PSTN). A sample IP PBX application is included in the application server installation. The sample IP PBX is in the form of an enterprise application archive (EAR) file and is for test purposes only. The details of installing and configuring the vendor-specific IP PBX are not provided. Along with the sample IP PBX, two soft phones are needed to test the application.

About this task

The ClickToCall widget is built using the functionality provided in the Dojo Toolkit. This widget can be configured to create a call between a hard-coded number provided to the widget during initialization and a number provided by the end user. The ClickToCall widget can also be customized to match the look and feel of the page by overriding the default CSS file. The functionality provided by the widget can also be extended, allowing the user to create their own custom version to handle more advanced tasks.

This task lists the steps needed to enable phone call management in an existing application, including how to install the SIP IP PBX sample application and configure the application server. To quickly learn how the CEA widgets work in an online application, you can install the PlantsByWebSphere Ajax Edition for CEA (PlantsByWebSphereAjax) sample application. For more information about the sample application, see the supporting documentation that is provided with the Feature Pack for CEA at app_server_root /feature_packs/cea/samples/plantsbywebsphere/documentation/index.html, as well as the topic Setting up a CEA Feature Pack demonstration environment.

[Feature Pack for CEA Fix Pack 5 or later] Avoid trouble: In the following procedure, complete either Step 6 or Step 7. Step 6 enables the widget for desktop browsers. Step 7 enables the widget for Apple and Android mobile browsers.gotcha

Procedure

  1. Enable the system application.
  2. Install and configure the IP PBX.
  3. Configure the IP PBX location.
  4. Restart the application server.
  5. Copy the CEA widgets into the application you are enhancing.
  6. Embed the widgets in the application you are enhancing for desktop browsers.
  7. Embed the mobile widgets in the application you are enhancing.
  8. Install and start the application that you have enhanced.
  9. Test the application that you have enhanced.

Results

You have enabled the ClickToCall widget within an application to allow users to enter their phone number and make a phone call.

Avoid trouble: If problems are encountered, troubleshooting can be done to find the source. Here is a checklist. gotcha



Related concepts
What is new in the Feature Pack for CEA
Related reference
CEA call flow
Receiving call notifications in Web applications
Collaborating and cobrowsing in Web applications
Related information
Multiple Versions of Dojo in a Page
Tips for debugging Ajax applications


Terms of Use | Feedback

Last updated: Oct 21, 2010 12:57:02 PM CDT
http://publib.boulder.ibm.com/infocenter/wasinfo/v7r0/index.jsp?topic=/com.ibm.websphere.ceafep.multiplatform.doc/info/ae/ae/tcea_enable_calls_widgets.html