# Conversation Mode

{% hint style="warning" %}
**Conversation Mode** is a **Pro** exclusive feature. [Learn more about Pro](/overview/premium.md).
{% endhint %}

<figure><img src="/files/7oB93lkUzoCvfFlCVfSL" alt=""><figcaption></figcaption></figure>

### What is Conversation Mode?

Conversation Mode makes iTranslator smarter when users send multiple messages in quick succession. Instead of translating each message individually the moment it arrives, the bot waits for a configurable delay and groups all messages sent by the **same user** in the **same channel** during that window. All batched messages are then translated together as a single unit.

This gives the translation engine more context, producing more natural and coherent results, while also reducing the number of translation calls made on your server.

### How does it work?

1. A user sends a message in a channel where iTranslator is active.
2. Instead of translating immediately, iTranslator starts a timer (your configured delay).
3. Any additional message sent by the **same user** in the **same channel** before the timer expires is added to the batch.
4. Once the timer fires, all batched messages are translated together.

{% hint style="info" %}
Messages that contain embeds are **translated immediately** and are not added to the batch — they always bypass the delay.
{% endhint %}

### Commands

All Conversation Mode commands require the **Manage Server** permission and an active **Pro** subscription.

<table><thead><tr><th width="280">Command</th><th>Description</th></tr></thead><tbody><tr><td><code>/conversation-mode delay &#x3C;delay></code></td><td>Sets the batch delay in seconds (0–10). Setting <strong>0</strong> disables Conversation Mode.</td></tr><tr><td><code>/conversation-mode help</code></td><td>Displays a summary of the feature and the current batch delay configured on your server.</td></tr></tbody></table>

**Example — set a 3-second batch delay:**

```
/conversation-mode delay 3
```

After this, any user who sends several messages within 3 seconds will have all of them translated together.

{% hint style="info" %}
Set the delay to **0** to disable Conversation Mode and return to standard per-message translation.
{% endhint %}

### Conversation Mode vs Standard Translation

|                         | Conversation Mode     | Standard Translation     |
| ----------------------- | --------------------- | ------------------------ |
| **Availability**        | Pro only              | All users                |
| **Processing**          | Batched after delay   | Immediate per message    |
| **API efficiency**      | Higher (fewer calls)  | Lower (one call/message) |
| **Translation context** | Grouped messages      | Each message independent |
| **Embed messages**      | Processed immediately | Processed immediately    |

### Tips

* **Start with a short delay (2–3 s).** It's long enough to catch rapid follow-up messages while still feeling responsive to your users.
* **Use 0 to disable.** Running `/conversation-mode delay 0` disables the feature without any other changes needed.
* **Best for active communities.** The feature shines in busy channels where members often send multiple short messages in a row.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.itranslator.app/amazing-features/conversation-mode.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.