Skip to content

nirmalab-codes/audalimo-sms

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

15 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ“ฑ SMS Webhook - Real-time SMS Forwarding App

License: MIT Android Ionic React TypeScript Release

Professional SMS to Webhook Forwarder - Forward incoming SMS messages to your webhook endpoints instantly with persistent background monitoring, deduplication, and VPN-like foreground service.

๐Ÿ“ฑ Download

Latest Release

Download APK

Quick Install:

  1. Download the latest APK from Releases
  2. Enable "Install from Unknown Sources" in Android settings
  3. Install the APK file
  4. Grant SMS permissions when prompted

๐Ÿš€ Features

๐Ÿ“จ SMS Management

  • โœ… 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

๐Ÿ”ง Advanced Configuration

  • โœ… 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

๐Ÿ›ก๏ธ Background Processing

  • โœ… 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

๐Ÿ“Š Monitoring & Analytics

  • โœ… 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

๐Ÿ› ๏ธ Technology Stack

Frontend Framework

Mobile Platform

Core Plugins & Services

Development Tools

  • Vite 5 - Fast build tool and dev server
  • ESLint - Code linting and quality
  • Yarn - Package management
  • Cypress - End-to-end testing

Build & Deployment

๐Ÿ“ฆ Installation

Prerequisites

  • Node.js 18+ and Yarn
  • Android Studio with SDK 33+
  • Java 17+ (for Android builds)

Quick Setup

# 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

Development Mode

# Start development server
yarn dev

# Run with live reload on device
npx cap run android --livereload --external

๐Ÿ”ง Configuration

Webhook Setup

  1. Configure Webhook URL: Enter your server endpoint (https://your-server.com/webhook)
  2. Set Secret Key: Optional authentication key for webhook verification
  3. Test Connection: Use built-in webhook testing functionality
  4. Save Configuration: Settings are persisted locally

Android Permissions

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" />

๐Ÿ“ก Webhook API

Request Format

interface WebhookPayload {
  message: string;      // SMS message content
  sender: string;       // Sender phone number
  timestamp: number;    // Unix timestamp
  signature: string;    // HMAC signature for verification
}

HTTP Headers

Content-Type: application/json
X-SMS-Signature: <hmac-signature>
X-SMS-ID: <message-id>
User-Agent: SMS-Webhook-App/1.0

Example Webhook Endpoint

// 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' });
});

๐ŸŽฏ Use Cases

Business Applications

  • 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

Development & Testing

  • 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

Personal Automation

  • 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

๐Ÿ”’ Security Features

  • 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 Support

Platform Status Version
Android โœ… Supported 7.0+ (API 24+)
iOS ๐Ÿšง Planned Coming Soon
Web โœ… Development PWA Ready

๐Ÿค Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Development Guidelines

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

๐Ÿ‘จโ€๐Ÿ’ป Author

Joseph - Full Stack Developer & Mobile App Specialist

๐Ÿ’ Support This Project

If this SMS Webhook app helps your business or development workflow, consider supporting its development:

๐Ÿ’ฐ GitHub Sponsors

Sponsor

๐ŸŽฏ PayPal

PayPal

Send to: joseph@nirmalab.com

๐Ÿช™ Cryptocurrency

  • USDT (BSC/BEP20): 0x096b0fc77a87d5e1d0a1184df656b83dfb2984d5

๐ŸŒŸ Star History

Star History Chart

๐Ÿ“ˆ Project Stats

GitHub stars GitHub forks GitHub issues GitHub pull requests

๐Ÿ” Keywords

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 ๐Ÿ‡ฎ๐Ÿ‡ฉ