# Commands and the settings card

# Commands and the settings card

Every buy bot command and every button on the settings card.

## Command reference

`/buybothelp` leaves out `/buybotdiscord`, `/buybotdocs`, `/buybotmedium`, `/buybotreddit`, and `/buybotgithub` — they work like the other link commands. The table below is complete.

| Command | Aliases | What it does |
| --- | --- | --- |
| /enablebuybot | — | Turns the buy bot on. In a group: authorizes that group and adds it (up to 10). Asks for the contract address first if none is set. |
| /minbuy \<amount> | — | Sets the minimum buy in USD. Takes the amount inline (`/minbuy 20`, `$20`) or opens a prompt. |
| /buyemoji \<emoji> | — | Sets the size-row emoji — premium or plain. The first emoji in the message wins. |
| /buybotimage | — | Sets the buy media. Attach an image, GIF or video to the command, or send it as the next message. |
| /repeatlastbuy | — | Reposts the last recorded buy through the current layout, media and emoji. |
| /buybotgroups | — | Opens the Manage Groups picker. |
| /buybotsettings | /buybotmenu, /buybot | Opens the settings card. |
| /buybothelp | /buybotcommands | Sends the plain-text command list (incomplete — see above). |
| /buybotwebsite | — | Sets the website link. |
| /buybotx | /buybottwitter | Sets the X (Twitter) link. |
| /buybottelegram | — | Sets the Telegram link. |
| /buybotdiscord | — | Sets the Discord link. |
| /buybotdocs | — | Sets the docs link. |
| /buybotmedium | — | Sets the Medium link. |
| /buybotreddit | — | Sets the Reddit link. |
| /buybotgithub | — | Sets the GitHub link. |
| /forkbuybot | — | Copies another bot's buy post — text, formatting and media — into this bot's layout. Doesn't turn the bot on or add a group. |

Only `/buybotsettings` appears in the bot's command menu, and only for the owner.

## Commands sent without a value

A command sent without its value — `/minbuy` alone, `/buyemoji` alone, a link command with nothing after it — opens a prompt instead of failing.

#### Rules

| Setting | Value |
| --- | --- |
| What answers it | Your next message in that same chat — text, or a photo/video/GIF where media is expected. |
| Timeout | 10 minutes. A message after that is treated as a fresh, unrelated message. |
| Someone else's message | Ignored. The prompt stays open. |

## The settings card

#### Card text

- **$MSAI Buy Bot** ON ✅ or **Buy Bot** OFF ❌.
- Buy media: … — shown only while random gallery mode is on.

#### Buttons

| Label | Opens / does |
| --- | --- |
| Manage Groups | Opens the group picker — see Manage Groups. |
| Min Buy: $\<n> | Prompt: `Send the minimum buy in USD, e.g. 20`. Confirms with `Min buy set to $<n> ✅`. |
| Update Emoji \<glyph> | Prompt: `Send the emoji for the buy row (premium emoji work too)`. Confirms with `Buy emoji set ✅ — it repeats with the size of each buy.` |
| Update Media | Prompt: `Send me the new image, GIF, or video.` While random gallery mode is on, it first asks to confirm switching it off. |
| Update Socials | Opens the links step of the post-fork wizard for the slots the layout uses, any slot that already has a link, and website / X / Telegram. |
| Token: $\<SYM> / Token | Prompt: `Paste the token's contract address.` Same DexScreener lookup and confirm card as setup. |
| Fork a Layout | Shows a hint: `Send /forkbuybot and paste another bot's buy post (or forward it, image included) — I'll keep its emoji and layout and fill in your token's live numbers. Edit it any time on memescale.ai/dashboard → Buy Bot.` It does not start a fork. |
| View Layout | Shows the current post on the card. Nothing is sent to the group. |
| Refresh (blue, full width) | Redraws the card and re-reads group titles. |
| Disable Buy Bot Everywhere (red, full width) | Shown only while the bot is on. Turns it off everywhere; acks `Buy bot disabled everywhere`. |
| Enable Buy Bot (green, full width) | Shown only while the bot is off and at least one group is added. Turns it on; acks `Buy bot enabled`. |
| « Main Menu | Returns to the `/menu` root. |
| Close | Closes the card. |

## Manage Groups

- One row per group the bot is admin in and you are a member of: ✅ Title (gets the buys) or ❌ Title (doesn't). Tapping a row flips it.
- A group the bot has been removed from or demoted in still shows a ✅ row, so it can be removed.

#### Add Groups

1. Tap **Add Groups**.
2. The bot replies: `Let's add a group. Make sure I am in the group as an admin first, and then send me either the link to the group, or the group ID which you can get by typing /getid.`
3. Send the group's public link, `@handle`, a `t.me/c/…` message link, or the numeric ID from `/getid` as your next message.
4. The bot checks the group and replies.

| Situation | Reply |
| --- | --- |
| The bot isn't in the chat | `I'm not in this group yet, add me first and repaste the {what}.` |
| The bot is in the chat but isn't admin | `I'm in the group but not an admin yet, once I am admin repaste the {what}.` |
| The chat is a channel, not a group | `That's not a group. Send the {what} of a group I'm an admin in.` |
| A private invite link | `That's a private invite link, and Telegram doesn't let bots look those up. Send /getid inside the group and paste the group ID here.` |
| Already added | The picker redraws with `<title> already gets the buys ✅` on top. |
| Already at 10 groups | `Limit reached, we're already in 10 groups. Remove a group first and then send the {what} again to enable the buy bot.` |
| Otherwise | The group is added. The picker redraws with `Added <title> ✅` on top. |
| Tapping an unpicked row at the cap | `Limit reached, we're already in 10 groups. Remove a group first.` |