User Guide

1016 Chapter 6: ColdFusion MX Event Gateway Reference
IM gateway message sending commands
You use the SendGatewayMessage CFML function or the return value of a CFC listener method
to send outgoing messages. The ColdFusion MX 7 IM gateway accepts the following outgoing
message commands:
The message structure that you return in the gateway listener CFC function or use as the second
parameter in the CFML
SendGatewayMessage function can have the following fields. The table
lists the fields and the commands in which they are used, and describes the field’s use.
In typical use, a ColdFusion application uses the accept, decline, and noact commands in the
return value of the
onAddBuddyRequest method, and uses the submit command (or no
command, because submit is the default command) in
SendGatewayMessage CFML functions
and the return value of the
onIncomingMessage CFC method.
Command Description
submit (Default) Sends a normal message to another IM user.
accept Accepts an add buddy request. Adds the buddy to the list of IDs that get your
presence information and sends an acceptance message to the buddy ID.
decline Declines an add buddy request and sends a rejection message to the buddy ID.
noact Tells the gateway to take no action. The gateway logs a message that indicates that
it took no action, and contains the gateway type, gateway ID, and buddy ID.
Field Commands Description
buddyID All The destination user ID
command All The command; defaults to submit if omitted
message submit A text message to send to the destination user
reason accept,
decline
A text description of the reason for the action or other message to
send to the add buddy requestor