> ## 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.

# Personal User Pingers

> Personalized private pingers for individual users

### Personal User Pingers Guide

Personal User Pingers (PUP) allow individual users to create their own customized notification system. Unlike role pingers that ping entire roles, PUPs will ping the individual users in their private threads when messages matching their keywords appear in their monitored channels.

**How It Works**

```mermaid theme={null}
flowchart LR
S1\[Source Channel 1] -->|Keywords Match| P\[Pinger]
S2\[Source Channel 2] -->|Keywords Match| P
S3\[Source Channel 3] -->|Keywords Match| P
P -->|Pings User| T\[User's Private Thread]
```

**Basic Example**

<Steps>
  <Step title="Step 1">
    Create Your PUP

    *Here you can create your personal pinger. Provide some channels you want your PUP to monitor. A user can only have one PUP at a time.*

    ```
    /pups create channels:#target #amazon #bestbuy #walmart
    ```
  </Step>

  <Step title="Step 2">
    Add Keywords

    *`Add keywords that will trigger notifications for you. You can add multiple positive and negative keywords. We use the OR logic so each keyword will act independently.`*

    ```
    /pups add-keywords keywords:+jordan, +dunks, -socks
    ```
  </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 receive notifications for all messages instead of using positive keywords. However, any configured negative keywords will still apply
</Tip>

### Commands

**Create PUP**

```
/pups create #channels: #target #walmart
```

**View Your PUP Config**

```
/pups config
```

**Add Channels**

```
/pups add-channels channels:#target #scheels #walmart
```

**Remove Channels**

```
/pups rm-channels channels:#target #walmart
```

**Add Keywords**

```
/pups add-keywords keywords:+ps5, +xbox, -used
```

**Remove Keywords**

```
/pups rm-keywords keywords:+ps5
```

**Delete PUP**

```
/pups delete
```

### Admin Commands

<Info>
  Server administrators must select a channel for the server before users can start creating PUPs:
</Info>

**Setup PUPs Channel**

```
/pups admin-setup channel:#member-pingers
```

<Warning>
  This will reset the PUP channel, and remove any existing user pingers!
</Warning>