onIncomingMessage

Standard message from an IM user. The application processes the message body appropriately; for example, it could display the message in an interface window.

This method can return a response message to the sender.

onAddBuddyRequest

Request from another IM user to add your application's IM ID to their buddy list. The CFC must determine whether to accept or reject the request, or to take no action. No action might be appropriate in cases where the request must be reviewed offline for approval and responses are sent at a later time.

The CFC returns a message with the decision as a command value and optionally a text message specifying the reason. If you accept the request, the requestor automatically gets added to the list of IDs that can get status information for the gateway. If you specify no action, ColdFusion does not respond.

onAddBuddyResponse

Response from another IM user to a request from the gateway to be added to their buddy list. The response message is accept or decline.

Your application can handle this response as appropriate; for example, to add or remove the ID from a list of message recipients.

This method does not return a value.

onBuddyStatus

Message indicating a gateway buddy's status. Received when a buddy's status changes; for example, from OFFLINE to ONLINE.

This method does not return a value.

onIMServerMessage

Status messages from the IM server, such as warning or error messages. The messages you might receive depend on the IM server that sends them. For information on the server messages, see the documentation for the IM server that your gateway instance uses.

This method does not return a value.