Tell

10 Auguest 2016

Release 9.111 - added the ability to send messages to conferences via the conference entity.

5 June 2016

Release 9.85 - added extended options for avatar and local entities.

21 May 2016

Release 9.78 - added optional parameter target.

<data Commands> Type: Corrade progressive command Command[wiki]: tell Description[wiki]: The tell command can be used to make Corrade talk in local chat, in a group, send an instant message to an avatar or to a conference. Permissions[wiki]: talk Parameters[wiki]: group, password, entity Last Changes[wiki]: Release 9.111 - added the ability to send messages to conferences via the conference entity. </data>

The tell command can be used to make Corrade talk in local chat, in a group, send an instant message to an avatar or to a conference.

Command	Required Parameters	Required Corrade Permissions	Required Group Abilities	Example
`tell`	`group`, `password`, `entity`	`talk`	When talking in group: `Chat->Join Group Chat`	llInstantMessage(CORRADE, wasKeyValueEncode( [ "command", "tell", "group", wasURLEscape(GROUP), "password", wasURLEscape(PASSWORD), "message", "Good day!", "entity", "local", "type", "Normal" ] ) );

Parameters	Sub-Parameters	Sub-Parameters	Possible Values	Sub-Parameters	Description	Example
`entity`	`local`	`type`	ChatType	`channel`	Sends the message on the specified channel (if the channel is not specified, then channel `0` is assumed).	llInstantMessage(CORRADE, wasKeyValueEncode( [ "command", "tell", "group", wasURLEscape(GROUP), "password", wasURLEscape(PASSWORD), "message", "Good day!", "entity", "local", "type", "Normal" ] ) );
	`group`	`target`	A group name or UUID.		Send to the configured group or a group specified by `target`.	llInstantMessage(CORRADE, wasKeyValueEncode( [ "command", "tell", // Use GROUP for authentication, "group", wasURLEscape(GROUP), "password", wasURLEscape(PASSWORD), "message", "Hello group members!", // and send the message to "A different group" "target", "A different group", "entity", "group" ] ) );
	`avatar`	`firstname`, `lastname` (or `agent` for agent by UUID)			Sends the message to an avatar.	llInstantMessage(CORRADE, wasKeyValueEncode( [ // send a start-typing message to an avatar "command", "tell", "group", wasURLEscape(GROUP), "password", wasURLEscape(PASSWORD), "agent", "0fe3acf3-1526-4b72-a86d-98694932723b", "entity", "avatar", "dialog", "StartTyping", "callback", wasURLEscape(URL) ] ) );
		`dialog`	InstantMessageDialog		An extra instant message dialog type.
		`online`	InstantMessageOnline		Indicating if the message will be set to only online avatars.
		`session`	A session UUID.		Whether to send the message to a specific session UUID.
	`estate`				Send the message to the current estate.
	`region`				Send the message to the current region.
	`conference`	`session`	A conference session UUID (for instance, previously retrieved with the conference command).		Send a message to a conference.	llInstantMessage(CORRADE, wasKeyValueEncode( [ // Send a message to a conference. "command", "tell", "group", wasURLEscape(GROUP), "password", wasURLEscape(PASSWORD), "entity", "conference", "session", "fea700a9-6776-16a4-b9cf-c9e755d8b168", "message", "Hello!", "callback", wasURLEscape(URL) ] ) );

Notes

Sometimes, it so happens that typing in a group will not make the message appear and instead the viewer will seemingly ignore it. It seems that sending a follow-up message will somehow make the second message be delivered, in spite of the fact that the first message has not been delivered. More than likely this has something to do with the connection to the group chat. As with most commands, the success return value of the tell command does not mean, that the message has been either sent nor received.
- One option would be to bind to the group notification and check whether the message has been sent in case sending the message was important.
All avatars, including Corrade, are able to send messages on negative channels but all the messages sent to negative channels are sent with the Normal audible range. In other words, the only valid value to type for the tell command when channel is set to a negative channel is Normal and Whisper or Shout will not work.