# Role Pinger

To add a new pinger to the current channel

```
$pinger {ping phrase} @role
```

To add a new pinger to a different channel

```
$pinger #channel {ping phrase} @role
```

Show pingers on a channel

```
$pinger show #channel @role
```

To remove an existing pinger from a channel

```
$pinger remove #channel @role {ping phrase}
```

To Reset all pingers for a specific role on the current channel

```
$pinger reset @role
```

### Adding Custom Text to pings

If you want to add a custom text to ping, add a , in the ping phrase and put the text after\
\
For example if I want to @Pokemon on the keyword `Booster Box`\
and add the text `Buy only @ 19.99`

```
$pinger #bestbuy Booster Box,title Buy only @ 19.99 @Pokemon
```

#### Custom Text Special Variables

* `title` - Will be replaced with the Embed Title that it was pinged of.
* `price`- Will be replaced with the Embed Price that it was pinged of.
* `any` - Will ping on any message

## Clear old pingers that their roles got removed

```
$pinger clear
```


---

# 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.moonitor.tools/other-tools-and-features/role-pinger.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.
