Keywords

When enabled in a Telegram group or channel, ShillBill listens for chosen words/phrases (e.g., CONTRACT, BUY, PRICE?) and auto‑replies with:

1. your Info Message; and

2. a token card (quick‑buy link, explorer, chart, Rugcheck, token address, price/cap/liquidity/volume, and basic risk flags).

Quick setup

1. Enable in this group

   /keywords on

2. Set the token

   /keywords token <contract_address>

3. Set treasury (referral attribution)

   /keywords treasury https://t.me/Shill_Bill_bot?start=ref_...

4. Set the Info Message

   /keywords text Welcome! Use the quick‑buy links below.

5. Define keywords (words and/or quoted phrases)

   /keywords words CONTRACT BUY PRICE "HOW TO BUY?"

   ╰┈➤ You can set multiple single‑word keywords at once by listing them without quotes. Use quotes only for multi‑word phrases.

Optional: Limit hourly posts, preview, then verify

/keywords limit 10
/keywords preview
/keywords status

Permissions

• Only group admins can configure keywords.

• Non‑admins can trigger keywords by sending matching text.

Commands

/keywords on | /keywords off             # enable/disable in this chat
/keywords text <message>                 # set info message
/keywords token <address>                # set token contract
/keywords treasury <referral_link>       # set treasury wallet
/keywords words <w1 w2 w3 "phrase">      # set full keywords list
/keywords add word <phrase>              # add a keyword/phrase
/keywords remove word <phrase>           # remove a keyword/phrase
/keywords limit <1-100>                  # set hourly cap
/keywords preview                        # show auto‑response privately
/keywords status                         # show current config + stats

╰┈➤ Tip: For multiple single‑word entries, list them unquoted in one command (e.g., /keywords words CONTRACT BUY PRICE). Use quotes for phrases (e.g., "HOW TO BUY?").

Matching rules

• Case‑insensitive: contract, CONTRACT, CoNtRaCt all match.

• Phrases vs words: use quotes for multi‑word phrases.

• Punctuation counts when part of a phrase (e.g., "PRICE?" is distinct from "PRICE").

• Removal tip: removing without quotes tokenizes by spaces. Prefer quotes:

  • ✅ /keywords remove word "how to buy"

  • ❌ /keywords remove word how to buy (may remove only HOW).

Rate limiting & status

• Per‑group hourly cap: Posts this hour: X (configure X with /keywords limit <1–100>).

• Last triggered: <ago> shows the most recent match.

Auto‑response format (what members see)

1. Info Message (your text)

Welcome! Use the quick‑buy links below.

1. Token card (snapshot at trigger time)

STORE (<referral quick‑buy>) | Solana Spaces | $<price>
Explorer (<solscan>) | Chart (<dexscreener>) | Rugcheck (<rugcheck>)
<token_address>

Market Cap: $<cap>
5m: <Δ%> | 1h: <Δ%> | 6h: <Δ%> | 1d: <Δ%>
Liquidity: $<liq>
Volume: $<vol>

Risk Analysis:
Mintable: No
Freezable: No

╰┈➤ Note: Metrics are a snapshot; they refresh on subsequent triggers.

Troubleshooting

• “Only administrators can manage keywords settings.” ┈➤ You’re not an admin; ask a group admin to run the command or grant rights.

• Treasury link rejected. ┈➤ Ensure the referral link belongs to an existing ShillBill wallet.

• Removed the wrong keyword. ┈➤ Use quotes to target the full phrase.

• Too many posts. ┈➤ Lower /keywords limit, or temporarily /keywords off.

• Typos. ┈➤ Unknown subcommands return a help block; re‑enter correctly.