# sim_send_message

Sends a message to all visitors of the sim.

```csharp
// See "LSL Helper Functions" page for this function
smartbotsAPI("sim_send_message", ["message", "Hello sim!"]); 

// or for the whole estate
smartbotsAPI("sim_send_message", [
  "message", "Hello sim!",
  "all_estates", "1"
]);
```

```snippet http-api-variables-OmJyUigTgO
```

```snippet http-api-input-basic-parameters-5FcVlaJbq0 action="sim_send_message"
```

```snippet http-api-input-q5yvAagqsZ
message     | yes      | The message to send
all_estates | optional | Set to TRUE (or 1) to return on all estates available for bot
```

```snippet http-api-output-JAwUcmg7i7
```

# Comments

The message is being delivered to all visitors of the sim. It is visible as a separate window in viewer.

Also:

* You have to teleport to the region first.
* To execute this function your bot needs to be an [Estate Manager](http://wiki.secondlife.com/wiki/Estate_Manager).
* You **don't** need a "Sim Governor" add-on to use this function.

# Examples

Teleport to DuoLife region and welcome everyone there:

```csharp
// You need to adjust the vars below:
string sbApiKey = "...";
string sbBotName = "...";
string sbBotApiToken = "...";

string myHome = "DuoLife/128/128/20";

// First, teleport to the desired region

string params = llDumpList2String([
  "action="  + "teleport",
  "location=" + llEscapeURL(myHome),
  "apikey="  + llEscapeURL(sbApiKey),
  "botname=" + llEscapeURL(sbBotName),
  "secret="  + llEscapeURL(sbBotApiToken)
  ], "&");
 
llHTTPRequest("https://api.mysmartbots.com/api/bot.html",
  [HTTP_METHOD,"POST"], params);

// Then restart it:
params = llDumpList2String([
  "action="  + "sim_send_message",
  "message=" + llEscapeURL("Welcome to DuoLife!")
  ], "&");
 
llHTTPRequest("https://api.mysmartbots.com/api/bot.html",
  [HTTP_METHOD,"POST"], params);
```