> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blazemonitors.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Parrot Channels

> Scan, and re-post monitor notifications by keywords

### Parrot Channels Guide

Parrot channels allow you to selectively mirror messages from multiple source channels into a single target channel based on keyword filters. Think of it as a smart message aggregator!

**How It Works**

```mermaid theme={null}
flowchart LR
    S1[Source Channel 1] -->|Keywords Match| P
    S2[Source Channel 2] -->|Keywords Match| P
    S3[Source Channel 3] -->|Keywords Match| P
    P[Parrot] ---> T[Target Channel]
    P ---> T
    P ---> T

```

**Basic Example**

<Steps>
  <Step title="Step 1">
    Create a Parrot

    *This is where you'll create the parrot and select a target channel for pings to go.*

    ```
    /parrots create target-channel:#trading-cards
    ```
  </Step>

  <Step title="Step 2">
    Add Source Channels

    *Once the parrot is created, you must add source channels depending on channels the parrot should source from.*

    ```
    /parrots add-source-channels channels:#walmart #target
    ```
  </Step>

  <Step title="Step 3">
    Add Keywords

    *You also must add keywords for parroting to begin. You can add multiple positive and negative keywords. We use the `OR` logic so each keyword wll act independently.*

    ```
    /parrots add-keywords id:trading-cards keywords:+trading card, +tcg
    ```
  </Step>
</Steps>

**Keyword Guide**

* Use `+` prefix for positive keywords. (optional)

* Use `-` prefix for negative keywords.

* Separate keywords with `,`

<Tip>
  You may use the`*` wildcard to forward all messages instead of using positive keywords. However, any configured negative keywords will still apply
</Tip>

### Commands

**List All Parrots**

```
/parrot list
```

**View Parrot Config**

```
/parrot config parrot-id:name~123
```

**Add Source Channels**

```
/parrot add-source-channels parrot-id:name~123 channels:#amazon #walmart
```

**Remove Source Channels**

```
/parrot rm-source-channels parrot-id:name~123 channels:#walmart
```

**Add Keywords**

```
/parrot add-keywords parrot-id:name~123 keywords:+ps5, +xbox, -switch
```

Remove Keywords

```
/parrot rm-keywords parrot-id:name~123 keywords:+xbox
```

**Delete Parrot**

```
/parrot delete parrot-id:name~123
```