Auto Clone Button
Overview
Auto Clone Button automatically copies inline buttons from source messages to your forwarded messages. This preserves call-to-action (CTA) buttons, purchase links, sign-up forms, and any interactive elements that make your content engaging.
What Problem Does It Solve?
When forwarding messages that contain buttons, you face these challenges:
β Buttons disappear when forwarding normally β CTAs are lost - your audience can't click through to products/services β Affiliate links don't transfer - you lose tracking and commissions β User engagement drops - no easy way for audience to take action β Manual button creation is tedious and error-prone
Auto Clone Button solves all of these automatically.
Key Benefits
β Preserve engagement - Keep all interactive elements β Maintain affiliate links - Don't lose referral commissions β Replace URLs automatically - Convert source links to your own β Filter buttons selectively - Choose which buttons to keep β Smart deduplication - Remove duplicate buttons automatically β Flexible layouts - Control max buttons and rows
How It Works
Processing Flow
Message arrives from source with inline buttons
Bot analyzes button structure (text, URL, type)
Filters applied based on your whitelist/blacklist rules
URLs replaced if you configured replacement patterns
Buttons cloned to the forwarded message
Deduplication removes any duplicate buttons (optional)
Layout optimized within your max buttons/rows limits
Technical Details
Button types supported: URL buttons (most common), callback buttons (limited)
Per message limit: Up to 10 buttons / 5 rows (configurable)
Processing time: < 1 second per message (instant for users)
URL validation: Automatic checks for valid URLs
Merge modes: Append to existing buttons or replace completely
Getting Started
Prerequisites
Before you can use Auto Clone Button:
β Purchase the addon using credits
β Have an active forwarding task
β Source messages contain inline buttons
Quick Start (Recommended for Most Users)
For most users, the "All Buttons Mode" is perfect:
Step 1: Purchase & Enable
Menu β My Addons β Auto Clone Button β Unlock
Open your task settings
Find Button Settings section
Toggle Auto Clone Button to ON
Step 2: Choose "All Buttons" Mode
In Button Settings, select Mode: All Buttons
This will clone every button from source messages
No filters needed - simplest setup
Step 3: Save & Test
Tap Save
Forward a message with buttons through your task
Verify buttons appear in forwarded message
Done! π
Operating Modes
Auto Clone Button has two operating modes. Choose based on your needs:
Mode 1: All Buttons (Recommended)
What it does: Clones every button from the source message.
Best for:
Most users who just want to preserve buttons
Simple, no-configuration-needed setup
General content forwarding
Maintaining all CTAs
Pros:
Easiest to set up (5 seconds)
No configuration needed
No missed buttons
Cons:
Can't filter out unwanted buttons
No selective control
Configuration required: NONE - just toggle ON
Mode 2: URL Only (Advanced)
What it does: Clones only buttons that match your URL filtering rules.
Best for:
Affiliate marketers who need specific links
Content curators who filter spam/unwanted links
Advanced users who need precise control
Replacing URLs with your own
Pros:
Full control over which buttons appear
Filter spam or competitor links
Replace URLs with your tracking links
Cons:
Requires configuration (whitelist/blacklist)
More complex to set up
Risk of filtering too much if patterns are wrong
Configuration required: Whitelist and/or Blacklist patterns
Configuration Guide: All Buttons Mode
Since this mode requires minimal configuration, focus on these optional settings:
Max Buttons
Default: 10 Range: 1-20 Purpose: Limit total buttons per message
When to use:
Source sends too many buttons (cluttered appearance)
You want clean, minimal messages
Mobile users prefer fewer options
Example:
Source has 15 buttons
Max Buttons = 5
First 5 buttons are cloned, rest are ignored
Max Rows
Default: 5 Range: 1-10 Purpose: Limit button rows (Telegram displays buttons in rows)
How Telegram arranges buttons:
Usually 1-3 buttons per row (depends on text length)
Long button text = 1 button per row
Short text = 2-3 buttons per row
Example:
Source has 8 buttons arranged in 6 rows
Max Rows = 3
First 3 rows are kept (5-6 buttons typically)
Deduplicate
Default: OFF Options: ON/OFF Purpose: Remove duplicate buttons automatically
When to enable:
Source sometimes sends same button multiple times
Multiple similar buttons (e.g., "Buy Now", "BUY NOW", " Buy Now")
Want clean, non-repetitive interface
How it works:
Compares button URLs (not text)
If URL matches, button is removed
First occurrence is kept
Merge Mode
Default: Append Options: Append / Replace Purpose: How to handle existing buttons in your forwarded message
Append (recommended):
Cloned buttons are added after any existing buttons
Useful if you manually add your own buttons to tasks
Combines source buttons + your custom buttons
Replace:
Cloned buttons replace all existing buttons
Use if you only want source buttons, nothing else
Most users: Keep on Append
Configuration Guide: URL Only Mode (Advanced)
This mode gives you powerful filtering and replacement capabilities.
Whitelist Patterns
Purpose: Only clone buttons whose URLs match these patterns.
When to use:
You want specific domains only (e.g., only Amazon links)
Filtering for partner/affiliate links
Only official website buttons
How to configure:
Enter patterns, separated by commas
Use
*as wildcard
Pattern examples:
Matches:
β t.me/yourchannel
β t.me/joinchat/abc123
β telegram.me/channel (different domain)
Matches:
β shop.example.com/product
β www.example.com/page
β blog.example.com/article
β example.org (different TLD)
Matches:
β amazon.com/dp/B08XYZ
β amazon.co.uk/gp/product/123
β ebay.com (not in pattern)
Multiple patterns:
Buttons matching ANY pattern will be cloned.
Blacklist Patterns
Purpose: Exclude buttons whose URLs match these patterns.
When to use:
Remove competitor links
Filter spam or shortener links
Block specific domains
Priority: Blacklist is checked AFTER whitelist. If a URL matches both, blacklist wins (button is blocked).
Pattern examples:
Blocks: All URL shortener links
Blocks: All links to competitor.com
Blocks: All subdomains of spam-site.com
Combined example (Whitelist + Blacklist):
Result:
β Clones: t.me/yourchannel, shop.yoursite.com/product
β Blocks: bit.ly/abc, competitor.com/offer
β Blocks: anyothersite.com (not whitelisted)
URL Replacement
Purpose: Automatically replace parts of button URLs with your own.
Use cases:
Insert your affiliate ID into product links
Change source channel links to your channel
Update old domains to new domains
Add tracking parameters
How to configure:
Add replacement rules with From and To fields:
Example 1: Affiliate Links
Original button: https://exchange.com/trade/BTC-USD
Replaced button: https://exchange.com/trade/BTC-USD?ref=YOUR_AFFILIATE_ID
Example 2: Channel Redirect
Original: https://t.me/oldchannel
Replaced: https://t.me/yourchannel
Example 3: Domain Update
All buttons pointing to old domain will use new domain.
Example 4: Tracking Parameters
Adds Google Analytics tracking to all product links.
Advanced Replacement Rules
Multiple replacements: Add as many rules as needed. Each is applied independently.
Processing order:
Whitelist/Blacklist filters buttons
Remaining buttons have URL replacements applied
Buttons are cloned with new URLs
String matching:
Replacements are exact substring matches
Case-sensitive
Not regex (wildcards don't work in replacements)
Example - Multiple rules:
Both rules apply independently to matching URLs.
Common Use Cases
Add Affiliate Links
Example: Insert referral codes into trading buttons
Filter Trusted Sources Only
Example: News aggregation - official sites only
Replace Links
Example: Redirect competitor links to your service
Add Tracking Parameters
Example: Add UTM parameters for analytics
Advanced Features
Button Deduplication Logic
When enabled, the system:
Extracts URLs from all buttons
Normalizes URLs (removes trailing slashes, converts to lowercase)
Compares each button URL to previous buttons
Removes duplicates (keeps first occurrence)
Example:
Pattern Matching Deep Dive
Wildcard rules:
* matches any characters:
t.me/*matches anything starting witht.me/*.example.com/*matches any subdomain of example.com
Exact matching:
No wildcard = must match exactly
example.commatches onlyexample.com, notwww.example.com
Common mistakes:
β example.com (too strict - misses https://example.com/page)
β
example.com/* (correct - matches all pages)
β t.me (too strict - misses https://t.me/channel)
β
t.me/* (correct - matches all Telegram links)
Testing your patterns:
Use Preview or test with a few messages first
Check which buttons appear/don't appear
Adjust patterns if needed
Merge Mode In-Depth
Scenario comparison:
Setup: You manually added a "Subscribe to Our Channel" button to your task.
Append Mode:
Your custom button appears first
Source buttons appear after
Total: Your button + all cloned buttons
Replace Mode:
Your custom button is removed
Only source buttons appear
Total: Only cloned buttons
Best practice: Use Append unless you specifically want source buttons only.
Troubleshooting
Issue: No Buttons Appearing
Checklist:
Fix:
Switch to "All Buttons" mode temporarily to test
If buttons appear now, your filters are too strict
Review whitelist/blacklist patterns
Test with more permissive patterns
Issue: Wrong Buttons Are Cloned
Cause: Whitelist/Blacklist patterns are too broad or too narrow.
Fix:
Too many buttons: Add blacklist patterns to filter unwanted ones
Too few buttons: Broaden whitelist or check blacklist isn't blocking good buttons
Debug method:
Temporarily use "All Buttons" mode
Note which buttons appear
Switch back to URL Only
Craft patterns to match desired buttons
Issue: URL Replacement Not Working
Common causes:
1. "From" string doesn't match exactly
2. Case sensitivity
3. Not a substring of URL
Fix: Use the exact substring that appears in button URLs.
Testing tip: Check source button URLs first, then craft your "From" pattern to match.
Issue: Pattern Syntax Errors
Invalid patterns:
β *.com (too broad - matches everything)
β t.me (missing path - should be t.me/*)
β example.com, www.example.com (space after comma - should be no space)
Valid patterns:
β
*.example.com/*
β
t.me/*,telegram.me/* (no spaces)
β
amazon.com/*,amazon.co.uk/*
Validation: App will warn you if pattern syntax is invalid when you save.
Issue: Too Many Buttons (Cluttered)
Solutions:
Option 1: Reduce Max Buttons
Set Max Buttons to 3-5 for cleaner appearance
First few buttons are usually most important
Option 2: Use URL Only Mode
Whitelist only critical button URLs
Filter out secondary/less important buttons
Option 3: Reduce Max Rows
Set Max Rows to 2-3
Limits vertical space used by buttons
Issue: Buttons Showing in Wrong Order
Explanation: Auto Clone Button preserves source button order. It doesn't reorder.
If you need custom order:
This isn't possible with Auto Clone Button
Consider manually creating buttons in task settings
Or request priority button feature from support
Issue: Some Button Text Looks Strange
Explanation: The addon clones button text exactly as source sends it.
Common issues:
Emoji issues: Some emojis may not display correctly
Language encoding: Rare character encoding problems
Long text: Button text might be truncated by Telegram
These are Telegram limitations, not addon issues. The addon preserves whatever the source sends.
Best Practices
Start with All Buttons Mode
Use this for most cases. Only switch to URL Only mode if you need filtering or URL replacement.
Test Before Production
Create a test task, send 5-10 test messages, verify buttons appear correctly, then apply to main task.
Pattern Tips
Use wildcards:
t.me/*,*.example.com/*Test patterns with actual source messages first
Document your working patterns for future reference
URL Replacement Tips
Match exact substrings from button URLs
Case-sensitive matching
Test with actual buttons to verify replacement works
Use Responsibly
Don't mislead users with replaced links
Follow Telegram Terms of Service
Be transparent about affiliate links
Respect content creators' rights
Combine with Other Addons
Crypto: Auto Clone Button + AlphaGardeners Extract
Marketing: Auto Clone Button + Smart Image Crop + Dialog Broadcast
News: Auto Clone Button + Caption filters
Performance Considerations
Processing Speed
All Buttons mode: <0.5s per message (instant)
URL Only mode: ~1s per message (pattern matching)
URL Replacement: +0.5s per replacement rule
Total: Usually 1-2s - negligible delay users won't notice.
High-Volume Usage
If forwarding 100+ messages/hour:
All Buttons is faster than URL Only
Keep replacement rules minimal (3-5 max)
Monitor task performance in Statistics
Button Limits
Telegram's limits (not addon limits):
Max ~100 buttons per message (theoretical)
Practical limit: 10-20 buttons for good UX
Max text length per button: ~64 characters
Recommendation: Set Max Buttons to 5-10 for best user experience.
Frequently Asked Questions
Can I clone buttons and modify button text?
No. The addon clones buttons exactly as they appear (text and URL). You can replace URLs but not button text.
Workaround: Manually create custom buttons in task settings with your preferred text.
Do callback buttons work?
Limited support. URL buttons (most common) work perfectly. Callback buttons (buttons that trigger bot commands) may not work as expected.
Why: Callback buttons are tied to the source bot. When cloned to your message, they won't function (no bot to handle the callback).
Best for: URL buttons, which work everywhere.
Can I add my own buttons in addition to cloned ones?
Yes! Use Merge Mode: Append.
Add your custom buttons in task settings
Enable Auto Clone Button with Append mode
Your buttons appear first, cloned buttons appear after
Does it work with media groups (albums)?
Yes, but buttons apply to the whole group, not individual photos. Telegram limitation.
Can I clone buttons from one source to multiple targets?
Yes! Configure the addon once in your task. All targets in that task receive the same cloned buttons.
What if source changes their button URLs?
URL Replacement rules still apply - they replace whatever substring matches, regardless of full URL.
Example:
Rule: From
shop.com/Toshop.com/?ref=123Works for:
shop.com/productA,shop.com/productB,shop.com/any-page
No need to update rules unless domain completely changes.
Can I temporarily disable without losing configuration?
Yes! Toggle "Auto Clone Button" OFF. All your patterns, replacements, and settings are saved. Toggle back ON anytime to resume with same settings.
How do I know which buttons were cloned vs filtered?
Testing method:
Forward message to a test channel
Check which buttons appear
Compare with source message
Adjust filters if needed
No built-in log, but easy to verify visually.
Getting Help
If you're stuck after reading this guide:
Review Addons FAQ - More Q&A
Check Quick Reference - Pattern examples
Test in isolation - Create test task, send test messages
Contact support with:
Your whitelist/blacklist patterns
Example source message/buttons
What you expected vs. what happened
Screenshots
Support channels:
In-app: Menu β Help & Support
Email: [email protected]
Community: Telegram group for user tips
Summary
Auto Clone Button gives you powerful control over button forwarding:
β Preserve engagement - Keep CTAs and interactive elements β Flexible filtering - Whitelist/blacklist patterns for precision β URL replacement - Automatically insert your affiliate links β Smart deduplication - Clean, non-repetitive button layouts β Combine modes - Use with other addons for powerful workflows
Key decision: Start with All Buttons mode (simple). Upgrade to URL Only mode when you need advanced filtering and replacement.
Next steps:
Purchase the addon from My Addons
Enable in task settings
Start with All Buttons mode
Test with a few messages
Upgrade to URL Only if you need filtering/replacement
Related documentation:
All Addons Overview
Addons Quick Reference
Addons FAQ
Last Updated: March 2026 Addon Version: 1.0 App Version: 1.0.44+
Last updated