Tell

28 November 2022

C11 - added.

batchtell (Commands)
Type	Corrade progressive command
Command	`batchtell`
Description	The `batchtell` command can be used to make Corrade batch-send messages to groups, to avatars or to conferences.
Permissions	`talk`
Parameters	`group`, `password`, `entity`
Last Changes	C11 - added.

The batchtell command can be used to make Corrade batch-send messages to groups, to avatars or to conferences.

Command Required Parameters Required Corrade Permissions Required Group Abilities Example

batchtell

group, password, entity

talk

When talking in group: Chat→Join Group Chat

llInstantMessage(CORRADE,
    wasKeyValueEncode(
        [
            "command", "batchtell",
            "group", wasURLEscape(GROUP),
            "password", wasURLEscape(PASSWORD),
            "message", "Good day!",
            "entity", "avatar",
            "type", "Normal",
            // list of avatars
            "item", wasListToCSV(
                [
                    "Mel Resident",
                    "e3e4c07b-a45a-42c1-8b6c-130000af7915",
                    "b0217717-23ef-4941-a933-2a915a3abd2f"
                ]
            ),
            "callback", wasURLEscape(URL)
        ]
    )
);

Parameters	Sub-Parameters	Sub-Parameters	Possible Values	Description	Example
`entity`	`group`	`item`	A list of group names or UUIDs.	Send to a list of groups specified by `item`.	llInstantMessage(CORRADE, wasKeyValueEncode( [ "command", "batchtell", "group", wasURLEscape(GROUP), "password", wasURLEscape(PASSWORD), "message", "Hello group members!", "entity", "group", // list of groups "item", wasListToCSV( [ "c4fd2b09-48e5-41b3-81a3-6f72860c8711", "Chalmer's Referential", "0d6a089b-828e-4819-ba68-a10dad2593dd" ] ), "callback", wasURLEscape(URL) ] ) );
`entity`	`avatar`	`item`		Sends the message to a list of avatars by name or UUID.	llInstantMessage(CORRADE, wasKeyValueEncode( [ // send a start-typing message to an avatar "command", "batchtell", "group", wasURLEscape(GROUP), "password", wasURLEscape(PASSWORD), "entity", "avatar", "dialog", "StartTyping", "item", wasListToCSV( [ "Capto Resident", "95885c96-64c5-44dd-86a4-bad342cd766a", "e51799d9-9f4a-4198-9dd5-6c9339336f67" ] ), "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.
`entity`	`conference`	`item`	A list of conference session UUIDs (for instance, previously retrieved with the conference command).	Send a message to multiple conferences.	llInstantMessage(CORRADE, wasKeyValueEncode( [ // Send a message to a conference. "command", "batchtell", "group", wasURLEscape(GROUP), "password", wasURLEscape(PASSWORD), "entity", "conference", "message", "Hello!", "item", wasListToCSV( [ "fea700a9-6776-16a4-b9cf-c9e755d8b168", "b14c8d22-7e02-4c5b-bcb5-f7730977d708" ] ), "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.