Professional SMS to Webhook Forwarder - Forward incoming SMS messages to your webhook endpoints instantly with persistent background monitoring, deduplication, and VPN-like foreground service.
Quick Install:
- Download the latest APK from Releases
- Enable "Install from Unknown Sources" in Android settings
- Install the APK file
- Grant SMS permissions when prompted
- โ Real-time SMS monitoring with persistent background service
- โ Instant webhook forwarding for incoming SMS messages
- โ Duplicate prevention system to avoid multiple webhook calls
- โ Message history with comprehensive logging
- โ OTP & notification forwarding perfect for automation
- โ Custom webhook URLs with HTTPS support
- โ Secret key authentication for secure webhook calls
- โ Webhook testing with detailed response logging
- โ Auto-retry mechanism for failed webhook deliveries
- โ Request signature generation for webhook verification
- โ VPN-like foreground service for persistent monitoring
- โ Battery optimization handling to prevent service termination
- โ Background task management with automatic restart
- โ System boot auto-start capability
- โ Android 14+ compatibility with latest foreground service APIs
- โ Real-time statistics and message counters
- โ Webhook delivery status tracking
- โ Service health monitoring with automatic diagnostics
- โ Activity logs with detailed error reporting
- โ Performance metrics and response time tracking
- Ionic Framework 8 - Cross-platform mobile app development
- React 18 - Modern UI library with hooks
- TypeScript 5 - Type-safe JavaScript development
- Capacitor 7 - Native mobile app runtime
- Android SDK - Native Android functionality
- Cordova Plugins - Device API access
- @capawesome-team/capacitor-android-foreground-service - Persistent foreground service
- @anuradev/capacitor-background-mode - Background processing
- @capawesome/capacitor-background-task - Background task management
- capacitor-sms-inbox - SMS reading capabilities
- Vite 5 - Fast build tool and dev server
- ESLint - Code linting and quality
- Yarn - Package management
- Cypress - End-to-end testing
- Capacitor Assets - Icon and splash screen generation
- Android Gradle - Android build system
- ProGuard - Code obfuscation
- Node.js 18+ and Yarn
- Android Studio with SDK 33+
- Java 17+ (for Android builds)
# Clone the repository
git clone https://github.com/nirmalab-codes/audalimo-sms.git
cd audalimo-sms
# Install dependencies
yarn install
# Build the app
yarn build
# Add Android platform
npx cap add android
# Sync and open in Android Studio
npx cap sync android
npx cap open android# Start development server
yarn dev
# Run with live reload on device
npx cap run android --livereload --external- Configure Webhook URL: Enter your server endpoint (https://your-server.com/webhook)
- Set Secret Key: Optional authentication key for webhook verification
- Test Connection: Use built-in webhook testing functionality
- Save Configuration: Settings are persisted locally
The app requires the following permissions:
<uses-permission android:name="android.permission.READ_SMS" />
<uses-permission android:name="android.permission.RECEIVE_SMS" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />interface WebhookPayload {
message: string; // SMS message content
sender: string; // Sender phone number
timestamp: number; // Unix timestamp
signature: string; // HMAC signature for verification
}Content-Type: application/json
X-SMS-Signature: <hmac-signature>
X-SMS-ID: <message-id>
User-Agent: SMS-Webhook-App/1.0
// Node.js Express example
app.post('/webhook', (req, res) => {
const { message, sender, timestamp, signature } = req.body;
// Verify signature
const expectedSignature = generateSignature(message, sender, timestamp, SECRET_KEY);
if (signature !== expectedSignature) {
return res.status(401).json({ error: 'Invalid signature' });
}
// Process SMS
console.log(`SMS from ${sender}: ${message}`);
res.json({ status: 'received' });
});- OTP Forwarding: Automatically forward verification codes to your systems
- Customer Communication: Route customer SMS to CRM or support systems
- Transaction Alerts: Forward banking/payment SMS to accounting systems
- Order Notifications: Integrate SMS confirmations with e-commerce platforms
- API Testing: Receive SMS-based API responses during development
- Webhook Testing: Test SMS-triggered workflows and automations
- Integration Testing: Validate SMS-dependent application features
- Monitoring: Track SMS-based alerts and notifications
- Smart Home: Trigger home automation based on SMS commands
- Backup Communications: Forward important SMS to multiple channels
- Travel Notifications: Route travel confirmations to itinerary apps
- Security Alerts: Forward security codes to password managers
- HMAC Signature Verification: Cryptographic webhook authentication
- HTTPS Enforcement: Secure webhook communication
- Local Data Encryption: Sensitive settings stored securely
- Permission Management: Granular Android permission controls
- Request Deduplication: Prevent replay attacks and duplicate processing
| Platform | Status | Version |
|---|---|---|
| Android | โ Supported | 7.0+ (API 24+) |
| iOS | ๐ง Planned | Coming Soon |
| Web | โ Development | PWA Ready |
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
Joseph - Full Stack Developer & Mobile App Specialist
- ๐ GitHub: @josephvoxone
- ๐ง Email: joseph@nirmalab.com
- ๐ข Company: Nirmalab
- ๐ผ LinkedIn: Joseph Shandy
If this SMS Webhook app helps your business or development workflow, consider supporting its development:
Send to:
joseph@nirmalab.com
- USDT (BSC/BEP20):
0x096b0fc77a87d5e1d0a1184df656b83dfb2984d5
sms webhook android sms forwarder sms to webhook real-time sms sms automation ionic sms app capacitor sms webhook forwarding sms monitoring background sms service foreground service android sms api integration otp forwarding sms bridge webhook relay sms gateway mobile webhook android background service sms notification forwarding real-time messaging
โญ Star this repository if it helps you! โญ
Made with โค๏ธ by Joseph from Indonesia ๐ฎ๐ฉ