![]() ![]() ![]() |
||
|
Handles incoming instant messages from other users. Optionally returns a response to the message sender.
onIncomingMessage(CFEvent)
onAddBuddyRequest
, onAddBuddyResponse
, onBuddyStatus
, onIMServerMessage
, Handling incoming messages and Sample IM message handling application
in Using the Instant Messaging Event Gateways in ColdFusion MX Developers Guide
The method must take one parameter, a CFEvent structure with the following fields:
Field |
Description |
---|---|
gatewayType |
Gateway type, either XMPP or SAMETIME. |
gatewayID |
The ID of the Gateway instance as configured in ColdFusion MX Administrator. |
originatorID |
The IM ID of the message originator. |
cfcMethod |
This CFC method; by default, onIncomingMessage. |
data.MESSAGE |
The message that was received. |
data.SENDER |
The senders ID; identical to the originatorID |
data.RECIPIENT |
The recipients ID, as specified in the gateways configuration file |
data.TIMESTAMP |
The date and time when the message was sent |
The function can optionally return a value to send a response message. The return structure must contain the following fields:
Field |
Description |
---|---|
command |
Normally omitted. You can also specify submit. |
buddyID |
ID to which to send the message. Normally, the value of the input parameters Data.SENDER field. |
message |
The message contents. |
The following example shows a simple onIncomingMessage
method that echoes a message back to the sender.
<cffunction name="onIncomingMessage"> <cfargument name="CFEvent" type="struct" required="YES"> <cfset input_mesg = CFEvent.data.MESSAGE> <cfset retValue = structNew()> <cfset retValue.command = "submit"> <cfset retValue.buddyID = CFEvent.originatorID> <cfset retValue.message = "Message Received:" & input_mesg> <cfreturn retValue> </cffunction>
|
||
![]() ![]() ![]() |