# Automation Rules

<figure><img src="/files/u30AwvYXmUvsuis8j5Tl" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}

1. In your project select **Automation.**
2. Go to **Add New Rule.**
3. [Select a Rule Preset](#audio-automation-rules-use-cases) below\
   or
4. [Create Custom Rule](broken://pages/ELkU9604gZyHkG1m8brS).
   {% endhint %}

## Automation Rule Presets  <a href="#audio-automation-rules-use-cases" id="audio-automation-rules-use-cases"></a>

Select Rules that will fit your needs from the selection of rule presets.

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Reject Article by label</strong></td><td>Reject articles based on a label you choose.</td><td></td><td><a href="/pages/t93zfFVB1mm0NnsDHy9j#reject-article-by-label">/pages/t93zfFVB1mm0NnsDHy9j#reject-article-by-label</a></td></tr><tr><td><strong>Reject article by keyword</strong></td><td>Reject articles based on a certain keyword.</td><td></td><td><a href="/pages/t93zfFVB1mm0NnsDHy9j#reject-article-by-keyword">/pages/t93zfFVB1mm0NnsDHy9j#reject-article-by-keyword</a></td></tr><tr><td><strong>Reject articles longer then...</strong></td><td>Reject articles based on the amount of characters in them.</td><td></td><td><a href="/pages/t93zfFVB1mm0NnsDHy9j#reject-articles-longer-then...">/pages/t93zfFVB1mm0NnsDHy9j#reject-articles-longer-then...</a></td></tr><tr><td><strong>Reject articles shorter then...</strong></td><td>Reject articles based on the amount of characters in them.</td><td></td><td><a href="/pages/t93zfFVB1mm0NnsDHy9j#reject-articles-shorter-then...">/pages/t93zfFVB1mm0NnsDHy9j#reject-articles-shorter-then...</a></td></tr><tr><td><strong>Read article in another voice</strong></td><td>Let certain articles be read with another voice.</td><td></td><td><a href="/pages/t93zfFVB1mm0NnsDHy9j#read-article-in-another-voice">/pages/t93zfFVB1mm0NnsDHy9j#read-article-in-another-voice</a></td></tr><tr><td><strong>Don't read title</strong></td><td>Set up this rule to skip the title in the audio version of certain articles.</td><td></td><td><a href="/pages/t93zfFVB1mm0NnsDHy9j#dont-read-title">/pages/t93zfFVB1mm0NnsDHy9j#dont-read-title</a></td></tr></tbody></table>

## **Reject Article by label**

This rule will exclude articles that contain specific labels.

<figure><img src="/files/hZ0hfzXnl0WPbkrpwOCm" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}

1. Determine a label or labels based on which the article will be rejected.
2. Paste this text into the text field on the left.
3. Click **Save**.
   {% endhint %}

## **Reject article by keyword**

This rule will exclude articles that contain specific text.

Example: you have a set of articles that are coming from the news agency. But you want only your original content to receive an audio version.

<figure><img src="/files/TorFUPIOb4Hlm7cg9ilx" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}

1. Determine keywords or text based on which the article will be rejected.
2. Paste this text into the text field on the left.
3. Click **Save**.
   {% endhint %}

## **Reject articles longer then...**

This rule will help you to avoid audifying articles that are too long.

<figure><img src="/files/tg2Ounq9hr9jBdMJ7Bqn" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}

1. Determine the number of characters at which an article is considered as too long.
2. Type this number into the textfield on the left.
3. Click **Save**.
   {% endhint %}

## **Reject articles shorter then...**

This rule will help you to avoid audifying articles that are too short.

<figure><img src="/files/ONmDjX4wzTRuncsrVAeN" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}

1. Determine the number of characters at which an article is considered as too short.
2. Type this number into the textfield on the left.
3. Click **Save**.
   {% endhint %}

## **Read article in another voice**

For a project you choose one voice. This rule makes it possible to read articles in other voices.

<figure><img src="/files/SUpIk7EjNQ2xZyxuV0Au" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}

1. On the right, choose your preferred voice in the dropdown.
2. Remove left **Always(no condition)** field by clicking on the red **X.**
3. **Add Condition** button will appear. Click on it.
4. Choose any condition which fits.
5. Click **Save**.
   {% endhint %}

## **Don't read title**

Do not read the titles of your articles.

<figure><img src="/files/W0aTVipXzw58SFBPCHtY" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}

1. Click **Save**.
   {% endhint %}

#### &#x20;<a href="#reject-articles-that-are-too-short" id="reject-articles-that-are-too-short"></a>

### Volume Boost

<figure><img src="/files/m7bt7aGlEq1ELUeybRbR" alt=""><figcaption></figcaption></figure>

Some of the voices of our wonderful partner elevenlabs have different volume settings.

When you use several voices in your project, it's sometimes great to adjust those volumes.

For this we created a great little feature called "Volume Boost". And this is how it works:

1. Go to Automation
2. Add new Rule
3. In the "IF" section select a Voice
4. In the "Then" section select Volume Boost

All the articles that are converted with that voice will get a volume increase or descrease as you set in the rule.

Automation Rules also allow you to [create custom rules](/docs/text-to-speech/automation-rules/create-custom-rule.md).

### Background Music

{% embed url="<https://youtu.be/fL3uzDf0eyk?si=ifP0Prh7qnH0ng2B>" %}

Bring your audio articles to life by adding background music for a richer, more engaging listening experience.

1. Go to Automation
2. Add new Rule
3. In the "IF" section select a Condition
4. In the "Then" section select Add background audio
5. Upload an audio file (you can upload several)

Your articles will now play with background music — if you’ve uploaded several tracks, one will be randomly assigned; to change the volume, simply edit the track and reupload it.

### Audio Logo <a href="#reject-articles-that-are-too-short" id="reject-articles-that-are-too-short"></a>

{% embed url="<https://youtu.be/K226cp8n2Ok?si=cT-68BOjXRIv-K_S>" %}

Give your articles a signature sound with a custom jingle at the beginning.

1. Go to Automation
2. Add new Rule
3. In the "IF" section select a Condition
4. In the "Then" section select Add audio logo
5. Upload the audio file to BotTalk CDN

Your audio logo will now play at the start of each article that matches your rule — giving your content a consistent and recognizable sound.

### Alternative Voice

{% embed url="<https://youtu.be/uIoOdd46mX4?si=dkBRcMZy2lAGaOWB>" %}

This feature is helpful when you want alternative voices for some sections of your newspaper. Say, you want a sports section to be read out loud with one voice and finances section with another.

1. Go to Automation
2. Add new Rule
3. In the "IF" section select a Condition (e.g. you select all the URLs that end with /sports/ or with the tag)
4. In the "Then" section select Read article with another voice

From there, simply choose the voice you prefer — and your selected sections will be read out loud with the perfect match in tone and style.


---

# 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.bottalk.io/docs/text-to-speech/automation-rules.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.