# BOT_LISTEN_IM

Commands bot to listen to IMs sent to the bot and forward them to the script.

```snippet totalcontrol-variables-EsRYwBUh4J
str | —
id  | —
```

## Result

One of the following events will be generated:

* [BOT_EVENT_LISTEN_SUCCESS](/doc/994aec1c-cba2-4773-8eb9-4a3de6e53443)
* [BOT_COMMAND_FAILED](/doc/845c20e0-6816-49fc-9d3e-ce8f552f79ac)

Additionally, the following event is generated every time the bot receives an IM:

* [BOT_EVENT_LISTEN_IM](/doc/023cd39c-042d-42a0-9380-cdec0a8a5486)

## Example

```csharp
llMessageLinked(LINK_SET, BOT_LISTEN_IM, "", "");
```