Kerry Buckley » Web21C

JohnMac and psd: the real story!

Kerry — Tue, 15 May 2007 11:59:07 +0000

:-)

BT’s Java SDK part two: making phone calls

Kerry — Sun, 18 Feb 2007 12:02:30 +0000

Yesterday we saw how easy it is to send text messages using the SDK, so now let's try making a phone call.

Imagine you're implementing a customer support system where people can submit a problem report along with their phone number, and you want to have the appropriate person ring them to help resolve their fault. Your system does whatever magic is required to find who that appropriate person is, then uses the Web21C SDK to set up the call:

PLAIN TEXT

JAVA:

package com.kerrybuckley.sdk;
import com.bt.sdk.thirdpartycall.ThirdPartyCall;
public class ThirdPartyCallDemo {
public static void main(String[] args) {
new ThirdPartyCallDemo().makeCall("tel:+447700900123",
"tel:+441214960391");
}
public void makeCall(String engineerPhoneNo, String customerPhoneNo) {
ThirdPartyCall tpc = new ThirdPartyCall(customerPhoneNo,
engineerPhoneNo);
tpc.startCall();
}
}

The ThirdPartyCall constructor on line 12 takes two arguments, callee and caller. When the call is connected using startCall(), the caller's phone (the engineer, in our example) rings first. Once they pick up, the callee's phone starts ringing, and the call between the two is connected as though it had been made directly (although neither party sees the other's caller ID).

BT’s Java SDK

Kerry — Sat, 17 Feb 2007 17:01:07 +0000

As I mentioned recently, I now work in the Web21C SDK team. The SDK provides a simple API for programmatically accessing various web services that BT provides, including SMS, conference calls and location services.

The SDK is in public beta, and is currently free (with daily usage limits). Up to now it's only been available for those crazy .NET folks, but the next release (on Monday, all being well) will extend that to Java, PHP and Python. Rumour has it that Ruby's in the works too.

I've been having a play with the Java version – here's a sneak preview...

There are a few steps to get set up. First you need to create an account on the website. You then need to download and run a Java application to register your application and create a certificate to identify you to the underlying services. Then there are a few JARs to put in your classpath, a properties file to update with your username, password and certificate filename, and you're ready to go.

For example, this is all you need to write to send a text message:

PLAIN TEXT

JAVA:

package com.kerrybuckley.sdkdemo;
import com.bt.sdk.sms.Messaging;
import com.bt.sdk.sms.SmsMessage;
public class SmsDemo {
public static void main(String[] args) {
Messaging smsService = new Messaging();
SmsMessage message = new SmsMessage();
message.addRecipient("tel:+447700900123");
message.setSubject("Testing...");
message.setMessageText("Hello world, from the Web21C SDK");
smsService.send(message);
}
}

Pretty self-explanatory, and just to prove it works:

Technorati Tags: web21c, bt, sdk