# BOT_LISTEN_IM

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

## Variables

The following table shows input values (you send them with the API call) and returned output values.

| **Variable** | **Description** |
|----------|-------------|
| `str`    | —           |
| `id`     | —           |

## Result

One of the following events will be generated:

* [`BOT_EVENT_LISTEN_SUCCESS`](/doc/bot_event_listen_success-Brr4lFi7ZP)
* [`BOT_COMMAND_FAILED`](/doc/bot_command_failed-JVxDdlfZF6)

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

* [`BOT_EVENT_LISTEN_IM`](/doc/bot_event_listen_im-K07iKPMfqm)

## Example

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