A Telegram bot that integrates with Wallu to provide intelligent support responses in your Telegram chats and groups. The bot uses Wallu's API to process messages and generate helpful responses.
- 👥 Works in both private chats and group conversations
- 🤖 No need to mention the bot for responses (though you can mention it)
- ⚡ Easy setup process
- 🐳 Docker-based deployment
/wallu_help- Shows help information/wallu_setup- Configure the bot (admin only)/wallu_status- Check bot status (admin only)/wallu_remove- Remove configuration (admin only)
- Add the bot to your Telegram chat/group: WalluChatBot
- Get your Wallu API key from panel.wallubot.com/addons
- Use the
/wallu_setupcommand to configure the bot (admin only) - Follow the bot's instructions to complete the setup
- Docker and Docker Compose installed on your system
- A Telegram Bot Token (get it from @BotFather)
- A Wallu API key (get it from Wallu Panel)
- Clone this repository
git clone https://github.com/yourusername/wallu-telegram
cd wallu-telegram- Set up environment variables
cp .env.example .env- Edit the
.envfile with your credentials:
TELEGRAM_BOT_TOKEN=your_telegram_bot_token
# Use this to generate a new one: openssl rand -hex 16
ENCRYPTION_KEY=dc038a7a3ef079e34d9825ffdbaab51b
Why encryption key
Used to store the API key (and possibly other things in the future). Yes, I know having it in .env next to the SQLite DB is not ideal (this feature is mainly meant for the Wallu's own production instance + avoid having the API keys unencrypted in backups)- Start the bot:
- For development:
./start-dev.sh
- For production:
./start-prod.sh
Bot not responding?
- Check if the bot is properly configured using
/wallu_status - Ensure you've set up the Wallu API key correctly
- Verify that the bot has proper permissions in the group
- Contact for help: Wallu Support
If you encounter any issues:
- Visit wallubot.com for general Wallu support
- Check the Wallu documentation for API-related questions
- Create an issue in this repository for bot-specific problems
See the LICENSE file for license of this project.