Synthor Telegram Bot

Synthor is Synthwav's official Telegram bot: @synthwav_bot. Link your Supra wallet to request your Synthwav ID and portfolio summary, and create, manage, and receive Custom Alerts in your private chat or on the website.

Synthor handles wallet linking, portfolio-summary commands, guided Custom Alerts setup and management, and alert delivery. It is not a conversational AI trading assistant and does not place trades or take custody of your funds.

Link your wallet

Open @synthwav_bot in a private Telegram chat.
Press Start, or send /wallet.
Follow the Verify Wallet link to Synthwav. The link expires after 10 minutes.
Connect the Supra wallet you want to link and complete verification. You may be asked to sign a free wallet login message to prove ownership.
Check Telegram for confirmation, then send /id for your summary.

Wallet linking is one-to-one: one Telegram account links to one wallet, and that wallet cannot simultaneously link to another Telegram account. Use /unlink before changing the linked wallet. If the verification link expires, request a new one with /wallet.

Always verify you are using @synthwav_bot and synthwav.io. Never enter a seed phrase or private key into Telegram or a verification form. Wallet linking does not require transferring tokens.

Commands

Command	What it does
`/start`	Starts the wallet-linking flow
`/wallet`	Requests a wallet-verification link
`/id`	Requests a manual portfolio sync and displays your linked wallet's summary
`/alerts`	Opens the Custom Alerts menu and your saved rules
`/newalert`	Starts the guided alert builder
`/cancel`	Cancels the current alert setup without changing saved rules
`/unlink`	Removes the wallet link from your Telegram account
`/help`	Shows all commands and their usage, without interrupting alert setup
`/filtergroup`	Selects a group you administer for canned-response filters
`/filter`	Adds or updates a filter: `/filter hello Hello there!`
`/filters`	Lists filters for your selected group
`/stop`	Removes a filter: `/stop hello`
`/stopall`	Requests confirmation before removing all filters for your selected group

Use Telegram's command menu or type a command directly in your private Synthor chat. A command can work even if it is missing from the menu: the menu is published separately from the bot's features. You do not need to relink your wallet to use /alerts.

Send /help in your private Synthor chat for the full guide. It works before linking a wallet and does not cancel an unfinished alert. Wallet and alert commands do not need extra arguments; follow the bot's prompts. Filter commands use the arguments shown below. Use /cancel if you want to stop alert setup.

Other private messages receive a short introduction and reminder to use /alerts, /id, /wallet, or /help. Replies during alert setup still go to the active prompt. This is a command reminder, not an AI conversation; Synthor does not send these general replies in groups.

Your Synthwav ID summary

The /id summary can include:

Rank, role, creature tier, and badges
Shortened linked-wallet address
Net worth in SUPRA and USD
Wallet-held SUPRAWR and SUPRA balances
Counts of token, LP, farm, stake, bond, and lock positions
Recorded successful/failed trades and inbound/outbound bridges
Last-sync time in UTC

Where supported and available, the card uses your Synthwav profile picture with the creature-tier artwork. Missing information is shown as unavailable rather than invented.

/id follows the website's existing manual-sync permissions, Membership access, cooldowns, and in-progress sync restrictions. Sending it does not bypass those limits. If a sync cannot start or fails, Synthor explains that it is showing saved data; check the last-sync time before treating values as current. The summary is for the linked wallet, not a combined My Wallets portfolio.

Receive Custom Alerts

Configure rules in Synthwav's Custom Alerts manager, or create them in this private chat with /alerts. Enable Telegram Bot under Delivery to receive them here. Linking your wallet alone does not create an alert or enable Telegram for existing rules.

Create and manage alerts in Telegram

After linking your wallet, send /alerts or tap Custom Alerts below your wallet summary or verification confirmation. Choose Create Alert, then One token, My Faves, or Market. The guided buttons cover the same conditions, repeat settings, cooldowns, and optional ATH/ATL Cooldown Recap as the website.

For a single token, reply to the search prompt with a ticker, name, metadata address, or full Coin type. Select the exact token from the results; check its address when tickers match. Reply to the latest prompt when entering a target or watched wallet. Choose delivery channels, review the summary, and confirm Create Alert. Nothing is saved before confirmation.

New Telegram drafts start with Telegram and DApp Alerts inbox selected. You can toggle all four delivery channels before saving. Editing keeps the rule's existing delivery choices until you change them.

Use My Alerts to inspect, edit, pause, resume, or delete a saved rule. Pause, resume, deletion, and saved edits require confirmation. These are the same wallet-owned rules shown on the website, not a separate Telegram list. The same saved-rule limits apply.

Drafts expire after 15 minutes of inactivity. Old buttons and replies to an earlier prompt cannot change the current draft. If your wallet is unlinked or reverified, start a fresh menu with /alerts. If a website edit conflicts with an open Telegram draft, the bot refreshes instead of overwriting that edit. Send /cancel at any time to discard setup without deleting saved alerts.

Supported conditions include price targets, percentage moves, new ATH/ATL records, large buys/sells, and watched-wallet buys/sells. Market offers New tradable token, New TIP verified token, and Token metadata update, without requiring a token selection or cross-token cooldown. The Token tab also supports My Faves for percentage moves and new ATH/ATL records. See Custom Alerts for scopes, baselines, repeat settings, cooldowns, and optional record recaps.

Messages include relevant details and token-specific links such as Trade, View TIP, View Chart, and Manage Alert. Buy/sell messages can link to the transaction and trader wallet on Suprascan. Condition banners can include the affected token's logo; text-only delivery remains possible.

Telegram delivery is server-side: you do not need to keep Synthwav open. It still depends on successful evaluation and Telegram delivery, so it is not an instant execution signal. Website privacy mode does not mask messages already sent to Telegram; protect access to your Telegram account and configure its notification previews accordingly.

Unlinking removes the verified Telegram destination; it does not delete your saved Custom Alerts or portfolio data in Synthwav. You can manage those separately on the website.

Share @synthwav_bot in a group so members can open their own private chat. Synthor does not need to join the group for this.

Adding the bot to a group does not turn the group into a shared alerts feed. Wallet verification and /id summaries require a private chat, and Custom Alerts are delivered only to the verified private destination. Group-specific alert configuration, automatic community buy/sell announcements, and general chat responses are not currently offered.

Group filters (canned responses)

Group administrators can manage automatic responses in the same private Synthor chat used for Custom Alerts. No wallet link is required for filters. Both you and Synthor must already be administrators of the selected group; Synthor checks current Telegram permissions for every management action. Selecting a group does not grant anyone new permissions.

Add Synthor to your group and make it a group administrator so it can verify permissions and receive trigger messages.
In your private Synthor chat, send /filtergroup and use Select filter group to choose the group.
Add a response with /filter hello Welcome to our group!.
Quote multi-word triggers: /filter "buy token" Visit https://synthwav.io.

Anyone in that group can trigger a saved response. Triggers match whole words or phrases, ignore capitalization, and treat punctuation literally. You can create custom slash triggers such as /price, except for Synthor's built-in commands. If several triggers match one message, Synthor uses the longest match. Bot messages and anonymous messages do not trigger replies. Topic replies stay in their original topic. There is a five-second group cooldown between filter responses.

Save the same reply for multiple triggers with a comma-separated list: /filter (/ca, /contract, token, "buy token") Your reply. Each distinct trigger counts toward the group's 100-filter limit. Saving a list adds or updates all its triggers atomically. To update the shared reply later, resend the list; updating or removing one trigger affects only that trigger. Commas and parentheses inside list entries are not supported; use a single quoted trigger for those phrases.

Line breaks and blank lines are preserved. New replies support <b>/<strong>, <i>/<em>, <u>/<ins>, <s>/<strike>/<del>, <code>, <pre>, <blockquote>, <tg-spoiler>, <a href="https://…">, and <br>. Other tags and attributes are rejected, as are unclosed tags. Use < and > for literal angle brackets in an HTML reply. Existing saved replies stay plain text until you update them. Media attachments are not supported.

Add URL buttons with <button href="https://synthwav.io">Open Synthwav</button>. Each button appears on its own row below the message, in source order. Up to 20 buttons are supported, with plain-text labels of 1–64 characters and absolute HTTP/HTTPS URLs. A button may also contain one custom emoji: <button href="https://synthwav.io/trade/supra-suprawr"><tg-emoji emoji-id="5111765733763714132">🦖</tg-emoji> Get $SUPRAWR</button>. Synthor converts that tag to Telegram's icon_custom_emoji_id field, which displays the icon before the label; the fallback is not duplicated in the button text. A text label is still required, and other formatting tags or multiple custom emoji inside one button are rejected. Message text is required; buttons alone are not accepted. The entire reply source, including markup and buttons, must fit within 3,000 characters. Links are not fetched by Synthor.

Custom emoji use <tg-emoji emoji-id="5111765733763714132">🦖</tg-emoji> (SUPRAWR from the synthwav emoji pack). The ID stays a string; include one fallback emoji between the tags. No other attributes or nested tags are allowed. Telegram controls whether the bot can use custom emoji; the fallback appears in contexts that do not display them. See the Telegram HTML formatting requirements.

Copy-ready example (send as one message after selecting your group):

/filter (/contract, /address, /telegram, /twitter, /x, /tg, /ca, /website, /site, /sct, /community, /treasury, /links, /app, /dapp, /trade, /swap, /tip, token, /cgf) <b>SYNTHWAV INFO &amp; LINKS</b>

📃 CONTRACT ADDRESS: <code>0x82ed1f483b5fc4ad105cef5330e480136d58156c30dc70cd2b9c342981997cee</code>

<button href="https://synthwav.io/trade/supra-suprawr">🔄 GET $SUPRAWR</button>
<button href="https://suprascan.io/fa/0x82ed1f483b5fc4ad105cef5330e480136d58156c30dc70cd2b9c342981997cee/f?tab=holders&amp;pageNo=1&amp;rows=10">🔎 VIEW ON SUPRASCAN</button>
<button href="https://suprascan.io/address/0xed3614f90036c4619b4d150e2c96fc76480a1237215212aebfd86d073e55e61a/f?tab=tokens&amp;pageNo=1&amp;rows=10&amp;tokenType=token">💰 COMMUNITY GROWTH FUND</button>
<button href="https://x.com/SynthwavLabs">🐦 FOLLOW ON X</button>
<button href="https://t.me/synthwavio">🛩 JOIN TELEGRAM GROUP</button>
<button href="https://synthwav.io">📱 WEBSITE/APP</button>
<button href="https://synthwav.io/tip">🪙 UPDATE YOUR TOKEN METADATA</button>

Use /filters to list triggers, repeat /filter with an existing trigger to update its response, or send /stop "buy token" to remove one. /stopall shows the selected group and asks for /stopall confirm within five minutes; /stopall cancel cancels deletion. Changes to the filter list invalidate an earlier confirmation. Deletion cannot be undone.

Each group supports up to 100 filters, with triggers up to 64 characters and replies up to 3,000 characters. All administrators manage the same group list. Your selected group is private to you and expires after a day; use /filtergroup again to change or reselect it. Groups keep separate lists. Filter commands do not cancel unfinished Custom Alert setup or change saved alerts.

Troubleshooting

Expired verification link: send /wallet for a new link
Already linked elsewhere: unlink the existing association before linking another account or wallet
Summary appears old: read the sync-status message and last-sync time; retry /id after any cooldown or temporary failure
No alert message: check the rule's status, trigger, cooldown, and Telegram Bot delivery selection on Synthwav
/alerts is missing from the command menu: type /alerts directly in your private Synthor chat

Visit Synthwav to manage your wallet profile, portfolio, and alerts.