Difference between revisions of "Bot Playground/Events/chat message"

From SmartBots Developers Docs
Jump to: navigation, search
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 Variable|own_message}}If this message has been said by bot itself.
  
 
{{API Variables Table End}}
 
{{API Variables Table End}}

Revision as of 13:19, 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.
message The text of the message
chat_type One of the following: Normal, Whisper, Shout, OwnerSay
own_message If this message has been said by bot itself.

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");