For the complete documentation index, see llms.txt. This page is also available as Markdown.

Custom Translators

The AI Tools β†’ Translate β†’ Translators tab holds every translator in your organization. Here you can review the built-in OnlyMonster translators and create your own, running on your agency's model.

Translator Types

Type
Badge
What it is
What you can configure

System

blue System

Built-in OnlyMonster translators: Incoming Default, Outgoing Default and Outgoing Native. They run on the OnlyMonster engine

Languages, model and prompt cannot be changed

Custom

yellow Custom

Translators created by your agency. They run on a preset from AI Gateway

Language, preset, prompt and post-processing

What the Translator Card Shows

  • The translator name

  • Languages: the supported languages for System translators, or a pair such as Auto-detect β†’ German for custom ones

  • A description (Fast and accurate translation) for System translators, or the preset and model (openai/gpt-4o-mini) for custom ones

  • The type: System or Custom

  • The direction: Incoming or Outgoing

  • The Connected status, if the translator is enabled on at least one account

Use the Type and Direction filters, the Hide Connected toggle, and the search field to navigate the list.

Creating a Custom Translator

Create a preset in AI Gateway before you start β€” a translator cannot be saved without one.

Step 1. Choose the Direction

Click New Translator and select which messages the translator will handle:

  • Incoming Messages β€” messages you receive from fans

  • Outgoing Messages β€” messages you send

The selected direction is displayed in the page header next to the Custom badge.

Step 2. Translator Basics

This section sets the name, the language and the preset.

Field
What to enter

Translator Name

The name of the translator β€” this is how you will find it in lists

Translate to

The language messages are translated into

AI Gateway Preset

The preset from AI Gateway that defines the model, the key and the parameters

The source language is detected automatically, so there is no need to select it. This is why a custom translator appears in the list as Auto-detect β†’ target language.

Step 3. Prompt

The Prompt section holds the instructions the model follows when it translates.

System Prompt β€” the main instruction applied to every translation. Use it to describe the tone, the style and any rules the model should follow.

User Message β€” the request sent to the model together with the message itself. This is where the text being translated is inserted.

Both fields are required and empty by default: you need to fill them in yourself. The grey text in a field is an example of the wording, not a saved value.

Variables

Variables are placeholders that are automatically replaced with real data at the moment of translation. The available variables are shown as chips under each field; an asterisk marks a variable that is required in that field.

Variable
What it inserts
Where it is available

{sourceText}

The message being translated

User Message β€” required

{targetLang}

The language the message is translated into

System Prompt; User Message β€” required

{sourceLang}

The original language

System Prompt, User Message

{chatHistory}

Recent messages from the conversation, used as context

System Prompt, User Message

An example of a completed User Message:

Step 4. Post-Processing

Post-processing is applied to the finished translation, after the model has responded. Both options are off by default.

Option
What it does

No Dots Before Emojis

Removes the period before an emoji: Sure. 😊 β†’ Sure 😊

No Dashes

Removes dashes from the text: well β€” I love it β†’ well I love it

Step 5. Test and Save

Test Translator is available on every translator screen. It shows the translation result directly in the control panel, without sending anything to fans. Save your settings before you run a test, then check the output and click Create.

The blue dots next to Translator Basics and Prompt in the left menu mean that the section still has empty required fields.

Once created, the translator appears in the Translators list, but it only starts translating after you connect it to accounts.

Outgoing translators have two additional sections in the left menu β€” Glossary and Customization. You can fill them in while creating the translator or come back to them later.

Translator Actions

Click the Β·Β·Β· icon on a translator card to open the actions menu.

Action
What it does

Edit

Opens the translator settings

Connect to Account

Connects the translator to accounts

Duplicate

Creates a copy of the translator β€” useful for building a variant with a different target language or prompt

Delete

Deletes the translator

Connect to Account

This is the fastest way to enable a translator on several accounts at once. A translator can be connected to:

  • all accounts in the organization,

  • selected accounts,

  • an account group β€” if you use groups, the translator is connected to the entire group.

The same result can be achieved from the account side: the Accounts tab opens the translation setup for a specific account. See Connecting Translators to Accounts.

Editing a Translator

Open a translator from the Translators list, or select Edit in the Β·Β·Β· menu. Apply your changes with Save Changes.

The available sections depend on the direction and the type of the translator:

Section
Incoming
Outgoing

Translator Basics

Custom only

Custom only

Prompt

Custom only

Custom only

Glossary

β€”

System and Custom

Customization

β€”

System and Custom

For System translators, the languages, the model and the prompt cannot be changed.

Glossary and Customization are available for outgoing translators only. Translators that handle incoming messages do not have these sections.

  • Glossary β€” rules for specific words and phrases

  • Customization β€” writing style and typo settings

Which Translator Is Used in Chat

If a custom translator is enabled on the account, it is used by default. Members can switch between the available translators directly in chat β€” both in the message input field and in the page translation widget.

Permissions

Permission
What it allows

View AI Translate

View translators and their settings.

Edit AI Translate

Create and edit translators.

Selecting a preset while creating a translator also requires access to AI Gateway β€” View AI Gateway.

Last updated

Was this helpful?