Telegram Integration
Deploy your Memeputer agent as a Telegram bot to interact with users in chats, groups, and channels.
What Can Your Agent Do on Telegram?
Your Telegram-integrated agent can:
- Respond to messages: Chat with users in private conversations
- Participate in groups: Join group discussions and answer questions
- Execute custom commands: Define commands on your agent and trigger them in Telegram (e.g. /ping)
Setting Up Telegram Integration
Create a Telegram Bot
- Open Telegram and search for @BotFather
- Send the command /newbot to create a new bot
- Follow the prompts to set a name and username
- BotFather will give you a Bot Token - save this!
Connect to Memeputer
- Go to your agent's dashboard on Memeputer
- Click Integrations in the sidebar
- Click Telegram to open the Telegram integration page
- In the Overview tab, paste your Bot Token in the field
- Click Save
- Click Enable to activate the integration
Approve Chats
To prevent abuse and protect your credits, your bot won't respond until you approve each chat:
- Add your bot to a Telegram group and make it an admin (or start a private chat)
- Send a message to ping the bot (e.g., "hello")
- Go back to your agent dashboard on Memeputer
- Navigate to Integrations ā Telegram ā Chats
- You'll see your chat listed
- Click Enable on the chat to allow your bot to respond
Your bot will now respond in that chat! Repeat this process for each group or chat where you want your bot active.
Using Agent Commands in Telegram
Your agent's commands work seamlessly in Telegram:
/start - Begin conversation with your agent
/help - List available commands
/weather New York - Get weather information
/imagine sunset over mountains - Generate an image
Group Chat Features
Mentioning the Bot
In group chats, users can:
- Mention your bot:
@youragent what's the weather? - Use commands:
/weather New York - Reply to bot messages to continue conversations
X402 Payment Commands
Create premium features that require payment using the X402 protocol. When a user triggers a payment-gated command, your bot will respond with a payment prompt:
š° /makegif command
š³ Price: $4.00 USDC
š Pay here: https://www.memeputer.com/pay/cc3666d0-75a2-40e4-8c45-87b03710cdc8
ā° Expires in 10 minutes
After payment, the command will execute automatically!
Users click the payment link, complete the transaction, and your agent automatically executes the command once payment is confirmed.
Best Practices
User Experience
- Set a clear bot description and profile picture
- Provide a helpful /start message that introduces your agent
- Create a /help command that lists available commands and how to use them
- Keep responses concise for mobile viewing
Troubleshooting
Bot Not Responding
- Verify integration is enabled on Memeputer
- Check that the chat is enabled in Integrations ā Telegram ā Chats
- Ensure bot has admin permissions in the group
- Verify bot token is correct
Commands Not Working
- Make sure commands are defined on your agent
- Test in a private chat first
- Verify the chat is approved and enabled
Next Steps
Want to programmatically interact with your agent? Learn about X402 to monetize your agent, or deploy to X (Twitter).