Send IM

Declaration

<AMSENDIM SERVICE="aim" USERNAME="theUser"  PASSWORD="AM1CznaRue2JCdyhHCv59LCBw==aME" TO="theAccountID">The Message to Send</AMSENDIM>

See Also

Send Email, HTTP Download, Open a Webpage, HTTP Post

Description

Sends an IM (Instant Message) via ICQ, AIM, Yahoo Messenger, Google Talk, or Windows Live Messenger. This action can further enhance instant messaging by allowing automated messages to be sent, saving time and increasing productivity.

Practical Usage

Mainly used to automate the process of sending instant messages upon schedule or when a particular event or condition takes place on the system. In a business standpoint, instant messaging is essentially the text version of a phone call. Organizations that work in groups, teams or on projects may prefer IM over e-mail because it can be used to share vital information between teammates or group/project members in real-time.

Parameters

Service

Text, Required, Default="wml"
MARKUP: SERVICE="yahoo"

Specifies the IM service that this action will use to send the instant message.

The available service are:

Username

Text, Required
MARKUP: USERNAME="theusername"

Specifies the username of the IM account in which to send a message from.

Password

Text, Required
MARKUP: PASSWORD="thepassword"

Specifies the password of the IM account in which to authenticate with.

To Account

Text, Required
MARKUP: TO="theAccountID"

Specifies the recipient that this action will send an instant message to. This can be a valid account ID, account name, e-mail address or other form of identification (depending on the IM service used).

Delay

Text, Required, Default="5"
MARKUP: DELAY="7"

This action actually combines three actions, which includes the login, message transmission and logoff process. The Delay parameter Specifies the amount of delay time to set for this action to ensure that proper login, IM transmission and logoff occurs. The default value is 5 seconds, which means that a 5 second delay will occur between login and IM transmission and another 5 second delay will occur after transmission and before logoff, totalling 10 seconds.

NOTE: To ensure reliability, the lowest recommended value is 2 seconds.

Notes

Custom Description

This action includes the Description tab for entering a custom step description.

More on setting custom step description

Standard Error Handling Options

This action also includes the standard Error Causes and On Error failure handling options/tabs.

More on Error Handling Options

Variables and Expressions

All text fields allow the use of expressions, which can be entered by surrounding the expression in percentage signs (example: %MYVARIABLE%, %Left('Text',2)%). To help construct these expressions, you can open Expression Builder from these fields by pressing F2.

More on variables
More on expressions

More on the expression builder

Example

NOTE: The code below can be copied and pasted directly into the Steps pane of the Task Builder.

<AMSENDIM SERVICE="aim" USERNAME="theUser" PASSWORD="AM1CznaRue2JCdyhHCv59LCBw==aME" TO="theAccountID" DELAY="10">The Message to Send</AMSENDIM>