Whatever message this page gives is out now! Go check it out!

IM gateway message sending commands

Last update:
May 18, 2026
You use the SendGatewayMessage CFML function or the return value of a CFC listener method to send outgoing messages. The ColdFusion IM gateway accepts the following outgoing message commands:
CommandDescription
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.
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.
FieldCommandsDescription
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
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.

Share this page

Was this page helpful?
We're glad. Tell us how this page helped.
We're sorry. Can you tell us what didn't work for you?
Thank you for your feedback. Your response will help improve this page.

On this page