Difference between revisions of "Bot Playground/Events/chat message"
From SmartBots Developers Docs
| Line 13: | Line 13: | ||
{{API Variable|speaker_uuid}}The UUID of the sender | {{API Variable|speaker_uuid}}The UUID of the sender | ||
{{API Variable|speaker_owner}}The UUID of the owner of the sender object. | {{API Variable|speaker_owner}}The UUID of the owner of the sender object. | ||
| + | {{API Variable|own_message}}If this message has been said by bot itself. | ||
{{API Variable|message}}The text of the message | {{API Variable|message}}The text of the message | ||
{{API Variable|chat_type}}One of the following: Normal, Whisper, Shout, OwnerSay | {{API Variable|chat_type}}One of the following: Normal, Whisper, Shout, OwnerSay | ||
{{API Variables Table End}} | {{API Variables Table End}} | ||
| + | |||
| + | == Important == | ||
| + | |||
| + | Bot does hear what it says, so you will get a *chat_message* immediately after bot says something in local chat. | ||
| + | |||
| + | Make sure to ignore bot's own messages (especially for auto-responders)! | ||
== Example == | == Example == | ||
| Line 22: | Line 29: | ||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
Bot.on("chat_message", function(event) { | Bot.on("chat_message", function(event) { | ||
| + | // Ignore own messages | ||
| + | if(event.own_message) { return; } | ||
| + | |||
console.log(event.speaker_name + " says: \n" + event.message); | console.log(event.speaker_name + " says: \n" + event.message); | ||
}); | }); | ||
Revision as of 13:18, 11 December 2023
Fires when bot receives a message in the local chat
Bot.on("chat_message", function(event) { ... });
Reference
This event comes with the following event object:
| Variable | Required | Description | |
|---|---|---|---|
| event object properties: | |||
| name | The name of the event in this case chat_message | ||
| speaker_type | The sender of the message. Can be AGENT or OBJECT | ||
| speaker_name | The name of the sender | ||
| speaker_uuid | The UUID of the sender | ||
| speaker_owner | The UUID of the owner of the sender object. | ||
| own_message | If this message has been said by bot itself. | ||
| message | The text of the message | ||
| chat_type | One of the following: Normal, Whisper, Shout, OwnerSay | ||
Important
Bot does hear what it says, so you will get a *chat_message* immediately after bot says something in local chat.
Make sure to ignore bot's own messages (especially for auto-responders)!
Example
Bot.on("chat_message", function(event) {
// Ignore own messages
if(event.own_message) { return; }
console.log(event.speaker_name + " says: \n" + event.message);
});
console.log("Bot is listening, local chat");
