Instant Message - Send

 

Declaration

<AMSENDIM SERVICE="text (options)" USERNAME="text"  PASSWORD="text (encrypted)" TO="text">Text (The Message to Send)</AMSENDIM>

Related Topics

Description

Sends an IM (Instant Message) via Windows Live Messenger, Yahoo Messenger, AIM, Google Talk or ICQ. This action automates three operations; the login, message transmission and logoff process.

Practical Usage

Enhances instant messaging by allowing automated messages to be sent 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

General

Property

Type

Required

Default

Markup

Description

Service

Text (options)

Yes

Windows Live Messenger

  1. SERVICE="windows"

  2. SERVICE="yahoo"

  3. SERVICE="aim"

  4. SERVICE="google"

  5. SERVICE="icq"

The instant messaging service that this action will use to send the message. You must have a valid IM account registered with the specified service. The available services are:

  • Windows Live Messenger (default) - Microsoft instant messaging client for Windows.

  • Yahoo Messenger - Allows you to instant message with anyone on the Yahoo server.

  • AIM - AOL Instant Messenger

  • Google Talk - A Google instant messaging service (also known as "gchat") that provides both text and voice communication through Google Talk servers.

  • ICQ - An easy-to-use IM  program developed by Mirabilis LTD. ICQ is pronounced as separate letters, so that it sounds like "I-Seek-You." 

Username

Text

Yes

(Empty)

USERNAME="me@mydomain.com"

The username of the instant messaging account that will be used to send the message.

Password

Text

Yes

(Empty)

PASSWORD="encrypted"

The password of the instant messaging account in which to authenticate with.

Recipient account

Text

Yes

(Empty)

TO="theAccountID"

The recipient that this activity will send an instant message to. This can be an account ID, account name, email address or other valid form of identification that the selected IM service allows. Press the Load button to load the list of recipients for the selected service.

Message

Text

No

(Empty)

.....>The Message</AMSENDIM>

The message body to send.

Delay (seconds)

Number

No

5

DELAY="7"

This action combines three procedures; the login, message transmission and logoff process. The Delay parameter indicates 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 should be 2 seconds.

 

Description

Error Causes

On Error

example

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

 

Description: Send message "This is the message body." to "theRecipient@domain.com" on "Windows Live Messenger". Port checking is bypassed.

<AMSENDIM USERNAME="user@domain.com" PASSWORD="AM2ooXWPhaeg5OihdM+ZZ7nlw==aME" TO="theRecipient@domain.com" DELAY="10" MESSAGE="This is the message body." CHECKPORT="no" />