![]() ![]() ![]() |
||
|
Adds a buddy to the buddy list for the gateway user ID and asks to have the IM server send messages with the buddys online presence state to the gateway.
Boolean = addBuddy(name, nickname, group)
getBuddyInfo, getBuddyList, removeBuddy, Using the GatewayHelper object in Using the Instant Messaging Event Gateways in ColdFusion MX Developers Guide
Parameter |
Description |
---|---|
name |
The unique instant messaging user name for the person about whom you want to receive periodic status messages. |
nickname |
The nickname that the application can use to refer to the user. |
group |
The name of the group you wish to add the user to in your Buddy List. If the group specified does not exist, it will be created. If the group parameter is the empty string, the gateway uses the General group. |
True if the ID was added to the gateways buddy list; False, otherwise.
This method adds the buddy to the buddy list for the gateways ID and sends a subscription request (to automatically get presence information about the buddys online status) to the remote buddy. It does not wait for a response from the buddy, so it returns True (and the gateway adds the buddy to the list) even if the buddy denies the subscription request. Use the listener CFC onAddBuddyResponse method to monitor the buddys response. If the CFEvent.data.MESSAGE field value is decline, the listener method can call the gatewayHelper object removeBuddy
method to remove the buddy from the buddy list.
See GatewayHelper example, in Using the Instant Messaging Event Gateways in ColdFusion MX Developers Guide, which uses all GatewayHelper class methods.
|
||
![]() ![]() ![]() |