Utility & Administrative Commands

Group Lifecycle Management

To prevent unsolicited messaging, Clyr maintains an explicit state machine for every WhatsApp group stored in the group_settings database table.

                  ┌───────────────┐
                  │  GROUP JOIN   │
                  └───────┬───────┘
                          │ (Defaults to Silent Mode)
                          ▼
                  ┌───────────────┐
           ┌─────>│ INACTIVE / OFF│<─────┐
           │      └───────┬───────┘      │
   /bot-off│              │ /bot-on      │/bot-off
           │              ▼              │
           │      ┌───────────────┐      │
           └──────│  ACTIVE / ON  │──────┘
                  └───────────────┘

`/bot-on` — Activate Bot in Group

Enables active listening in the current WhatsApp group. Once active, the bot processes raw contract addresses, executes commands, and unfurls media.

/bot-on

Aliases: /boton, /start-bot, /activate

Requires Group Administrator privileges.

`/bot-off` — Deactivate Bot (Silent Mode)

Switches the bot into dormant Silent Mode. While dormant, Clyr ignores all incoming contract addresses, cashtags, and user commands except for /bot-on and /bot-status.

/bot-off

Aliases: /botoff, /stop-bot, /deactivate

Requires Group Administrator privileges.

`/bot-status` — Inspect Feature Flags

Returns the current operating state of the bot in the active group, including specific toggles for Twitter Sentinel, NFT Floor Radar, and Mint Drop alerts.

/bot-status

Response Format

⚙️ Clyr Bot Status Report
Group: MANDEM 🫂❤️🦅

• Core Engine: ACTIVE 🟢
• Token Contract Scanner: ENABLED 🟢
• Twitter Previews: ENABLED 🟢
• OpenSea NFT Detection: ENABLED 🟢
• Daily Mint Radar: ENABLED (08:00 WAT) 🟢
• Active X Trackers: 3 handles
• Active Raffles: 0

Interactive Event Poll Reminders

Clyr integrates directly with WhatsApp’s native interactive polling protocol to coordinate Twitter Spaces, community AMAs, and trading sessions.

`/alert` — Schedule an Event Poll

Creates an attendance poll with built-in background reminders.

/alert <event_title> <time>

Parameters

Parameter	Type	Required	Description
`event_title`	String	Yes	Name of the space or community event (e.g. `Base Alpha Space with Founders`).
`time`	String	Yes	Event start time (e.g. `6:00pm WAT`, `8:00pm UTC`, `tomorrow 7pm`).

Automated Reminder Schedule

Poll Creation: Clyr posts an interactive WhatsApp poll with options:
- ✅ Going (Reminder at T-15m)
- 🤔 Interested
- ❌ Can’t Make It
T-15m Pre-Warning: 15 minutes before the scheduled time, the background scheduler sends a notification tagging participants who selected “Going”.
Kick-Off Ping: At the exact start time, Clyr dispatches the live link notification.

/alert Founders AMA on Base 7:00pm

`/alerts` — List Upcoming Events

Displays all upcoming event reminders scheduled for the active group.

/alerts

Aliases: /events, /alert-list

`/alert-cancel` — Cancel an Event Reminder

Removes a scheduled event poll from the background scheduler (Admin only).

/alert-cancel <alert_id>

`/help` — Command Directory

Renders the complete, categorized command menu tailored to the sender’s permission level.

/help

Aliases: /menu, /commands

`/hello` — Connection Latency Handshake

Performs an immediate ping-pong handshake with the WhatsApp socket connection to verify uptime and latency.

/hello

Aliases: /ping, /hi

Response

Hi @2348057416596! ⚡ Clyr Bot is online and responsive.
Socket Latency: 142ms

Super-Administrator Broadcasts

Broadcast commands are strictly restricted to the Clyr Bot Owner Phone Number defined in the system environment (ADMIN_PHONE_NUMBER). Attempts by unauthorized users are rejected.

`/broadcast` — Multi-Group System Announcement

Dispatches an announcement across all active WhatsApp groups where Clyr is deployed. The engine employs an automated 300ms inter-group throttling delay to protect the host phone number from WhatsApp anti-spam bans.

/broadcast <announcement_message>

Aliases: /bcast, /announce

Example Invocation

/broadcast 🚨 System Update v2.1: Solscan RPC nodes upgraded. Zero-latency token scanning is now live across all groups!

`/broadcast-tracker` — Daily Alpha Project Digest

Dispatches a structured, formatted alpha project digest to all subscribed groups, ranking top-performing tokens with gain percentages and contract addresses.

/broadcast-tracker <project_list_payload>

Group Feature Toggles (Admin)

Group administrators can selectively enable or mute background automation engines to customize notification volume:

Feature Toggle	Description	Default State
`/scan-on` \| `/scan-off`	Toggle passive Solana & EVM contract address scanning	Enabled (when bot is on)
`/twitter-on` \| `/twitter-off`	Toggle rich X/Twitter link unfurling in chat	Enabled
`/nft-on` \| `/nft-off`	Toggle automatic OpenSea collection floor previews	Enabled
`/mint-on` \| `/mint-off`	Toggle daily 09:00 AM WAT NFT mint drop radar broadcasts	Enabled

Direct Message (DM) Account Management

When messaging the bot in private DM (+234 805 741 6596), community owners can manage group slots and subscriptions:

Message	Action
`FREE`	Claim your 1 free group slot and send invite link
`STATUS`	View active plan, subscription expiration, and linked groups
`BUY 5`	Generate invoice to add +1 extra group slot ($5/mo via Crypto)
`BUY 15`	Generate invoice for Dedicated Own-Number Mode ($15/mo)
`PAIR`	Request an 8-character pairing code to connect your personal WhatsApp number
`VERIFY <tx_hash>`	Submit an on-chain transaction hash for instant subscription activation

Getting Started

Commands Reference

Automatic Features

Help & Support

Utility & Administrative Commands

Group Lifecycle Management

`/bot-on` — Activate Bot in Group

`/bot-off` — Deactivate Bot (Silent Mode)

`/bot-status` — Inspect Feature Flags

Response Format

Interactive Event Poll Reminders

`/alert` — Schedule an Event Poll

Parameters

Automated Reminder Schedule

`/alerts` — List Upcoming Events

`/alert-cancel` — Cancel an Event Reminder

Diagnostics & Navigation

`/help` — Command Directory

`/hello` — Connection Latency Handshake

Response

Super-Administrator Broadcasts

`/broadcast` — Multi-Group System Announcement

Example Invocation

`/broadcast-tracker` — Daily Alpha Project Digest

Group Feature Toggles (Admin)

Direct Message (DM) Account Management

​Group Lifecycle Management

​/bot-on — Activate Bot in Group

​/bot-off — Deactivate Bot (Silent Mode)

​/bot-status — Inspect Feature Flags

​Response Format

​Interactive Event Poll Reminders

​/alert — Schedule an Event Poll

​Parameters

​Automated Reminder Schedule

​/alerts — List Upcoming Events

​/alert-cancel — Cancel an Event Reminder

​Diagnostics & Navigation

​/help — Command Directory

​/hello — Connection Latency Handshake

​Response

​Super-Administrator Broadcasts

​/broadcast — Multi-Group System Announcement

​Example Invocation

​/broadcast-tracker — Daily Alpha Project Digest

​Group Feature Toggles (Admin)

​Direct Message (DM) Account Management

Group Lifecycle Management

`/bot-on` — Activate Bot in Group

`/bot-off` — Deactivate Bot (Silent Mode)

`/bot-status` — Inspect Feature Flags

Response Format

Interactive Event Poll Reminders

`/alert` — Schedule an Event Poll

Parameters

Automated Reminder Schedule

`/alerts` — List Upcoming Events

`/alert-cancel` — Cancel an Event Reminder

Diagnostics & Navigation

`/help` — Command Directory

`/hello` — Connection Latency Handshake

Response

Super-Administrator Broadcasts

`/broadcast` — Multi-Group System Announcement

Example Invocation

`/broadcast-tracker` — Daily Alpha Project Digest

Group Feature Toggles (Admin)

Direct Message (DM) Account Management