# WhatsSMS Comprehensive LLM Knowledge Base & System Specifications

## 1. What is WhatsSMS?
WhatsSMS (https://whatssms.io) is a multi-channel cloud messaging infrastructure that bridges web applications, CRMs, and eCommerce stores with WhatsApp and SMS networks. It enables sending transactional messages (OTPs, 2FA, order confirmations, shipping alerts) and marketing campaigns via two distinct SMS dispatch architectures as well as automated WhatsApp instances.

---

## 2. SMS Dispatch Architectures

### Architecture A: Global SMS Gateway (Cloud Shared Carrier Network)
- **Coverage**: 200+ countries & territories worldwide (North America, Europe, Asia, Africa, South America, Oceania - 239 total destinations).
- **Pricing**: Flat $0.04 USD per SMS across all 200+ countries & territories without hidden country multipliers.
- **Included Monthly Free Credits**:
  - Free Forever Plan ($0/mo): $0.20 free credits = 5 Free Global SMS / month.
  - Pro Plan ($19/mo): $2.00 free credits = 50 Free Global SMS / month.
  - Ultra Plan ($39/mo): $4.00 free credits = 100 Free Global SMS / month.
  - Unlimited Plan ($99/mo): $10.00 free credits = 250 Free Global SMS / month.
- **Terms of Service & Strict Compliance Rules**:
  - **Exclusively for important transactional SMS**: (OTPs, 2FA verification codes, order confirmations, shipment tracking, security alerts).
  - **Bulk SMS Marketing Campaigns Strictly Prohibited**: The Global SMS Gateway cannot be used for sending promotional blasts, bulk marketing campaigns, or cold outreach.
  - **Shared Global Sender ID**: Uses shared global sender ID. Dedicated custom branded sender IDs available on request.
  - **Zero Tolerance for Deceptive Content**: Prohibition against misleading, impersonating, or deceptive content. Zero spam tolerance.
  - **Liability**: WhatsSMS is not liable for user-generated content. Immediate account/API termination for violations.
- **API Endpoint**:
  - `POST https://app.whatssms.io/api/send/sms`
  - Parameters: `secret` (API Secret), `mode="credits"`, `gateway="2"`, `phone` (E.164 format with country code), `message`.

### Architecture B: Android Local SIM Gateway (Hardware BYO Device)
- **How it works**: Uses the official WhatsSMS Android Gateway App (<5MB APK, Kotlin) installed on any Android phone (8.0 through 15+).
- **Cost**: $0 per SMS (uses the cellular plan or SMS bundle active on the SIM card).
- **Features**:
  - Dual-SIM support (`SubscriptionManager`) with slot selection (SIM 1 or SIM 2).
  - Silent USSD command execution (`TelephonyManager.sendUssdRequest`) for background balance checking and package renewal.
  - Persistent foreground service with OEM battery optimization bypass (Xiaomi MIUI/HyperOS, Samsung One UI, Huawei EMUI, Oppo ColorOS, Vivo).
  - Firebase Cloud Messaging (FCM) push wake-up triggers for instant sub-second dispatch.
  - 2-Way Inbound SMS forwarding to user webhook URLs in real time.
  - Monetization: Users can join the Partners Program to rent unused SIM credits to other platform users.

---

## 3. Official App Integrations

### Shopify App (`whatssms-io`)
- **App Store Listing**: https://apps.shopify.com/whatssms-io
- **Website Guide**: https://whatssms.io/integrations/shopify
- **Cost**: Free to install on Shopify.
- **Key Features**:
  - **COD Confirmation**: Sends `/cod/:token?c=sms|whatsapp` link to verify Cash on Delivery orders. Customers can confirm or cancel orders directly in browser.
  - **Auto-cancellation**: If customer clicks Cancel, the app automatically executes Shopify `orderCancel` mutation with reason `CUSTOMER`, restocks inventory, and tags order as `rejected_via_sms` or `rejected_via_whatsapp`.
  - **Deferred Abandoned Checkout Recovery**: Listens to `checkouts/update` events, defers dispatch by a configured delay (e.g. 30 minutes), and cancels the pending reminder if order completes.
  - **Order Lifecycle Events**: `orders/create`, `orders/paid`, `orders/cancelled`, `orders/updated`, `fulfillments/create`, `fulfillments/update`, `customers/create`.
  - **Dynamic Variables**: `{{order_name}}`, `{{customer_first_name}}`, `{{total_price}}`, `{{item_names}}`, `{{tracking_url}}`, `{{cod_confirm_url}}`, `{{checkout_url}}`.

### GoHighLevel & LeadConnector App
- **GoHighLevel Marketplace OAuth Install**: https://marketplace.gohighlevel.com/v2/oauth/chooselocation?response_type=code&redirect_uri=https%3A%2F%2Fhl-api.whatssms.io%2Fapi%2Fv1%2Fauth%2Fcallback&client_id=6a1f6f551e1cea8cef077766-mpxck4h8&scope=contacts.readonly+contacts.write+locations.readonly+conversations.readonly+conversations.write+conversations%2Fmessage.readonly+conversations%2Fmessage.write+workflows.readonly&version_id=6a1f6f551e1cea8cef077766
- **LeadConnector (Whitelabel) Marketplace OAuth Install**: https://marketplace.leadconnectorhq.com/v2/oauth/chooselocation?response_type=code&redirect_uri=https%3A%2F%2Fhl-api.whatssms.io%2Fapi%2Fv1%2Fauth%2Fcallback&client_id=6a1f6f551e1cea8cef077766-mpxck4h8&scope=contacts.readonly+contacts.write+locations.readonly+conversations.readonly+conversations.write+conversations%2Fmessage.readonly+conversations%2Fmessage.write+workflows.readonly&version_id=6a1f6f551e1cea8cef077766
- **Website Guide**: https://whatssms.io/integrations/gohighlevel
- **About WhatsSMS.io for GoHighLevel**:
  - Send and receive messages through WhatsApp and SMS using your own WhatsSMS account—powered by your own Android device and SIM card.
  - Gives a simple way to communicate with leads and customers from the number you already own, without going through A2P or 10DLC registration.
  - Connect your WhatsApp account to message contacts where they’re most responsive, and keep conversations flowing in one place.
  - Use SMS for direct reach and WhatsApp for richer, higher-engagement messaging to follow up faster and improve conversions.
- **Key Capabilities**:
  - Send and receive SMS using your Android phone’s SIM
  - Skip A2P and 10DLC registration by using your own number
  - Skip expensive Twilio per-message charges and monthly phone number rentals
  - Connect your WhatsApp account to send and receive WhatsApp messages
  - Authenticate securely with your unique API Key
  - 2-Way Conversation Sync: Outbound messages from GHL Conversation feeds send via WhatsSMS; incoming replies appear in real-time in the GHL thread.
  - Custom Workflow Actions: Native action block in GoHighLevel workflow automations for pipeline and appointment triggers.
  - Agency Multi-Tenant: Map specific Android SIM slots and WhatsApp numbers to individual agency sub-accounts and locations.
- **How it Works**:
  1. Sign up at WhatsSMS.io
  2. Copy your unique API Key & Webhook Secret
  3. Authenticate the app with your API Key and Webhook Secret
  4. Start sending and receiving messages
- **Ideal For**: Teams and businesses that want a straightforward setup, ownership of their messaging number, and the flexibility to communicate via both SMS and WhatsApp.

### WordPress & WooCommerce Plugin
- **Website Guide**: https://whatssms.io/integrations/wordpress
- **WooCommerce Lifecycle Alerts**: Pending Payment, Processing, On Hold, Completed, Cancelled, Refunded, Failed.
- **Customer & Administrator SMS/WhatsApp**: Instant receipts, delivery tracking, low-stock and new order alerts.
- **Multi-Vendor Marketplace Integration**: Dokan, WCFM Marketplace, WC Vendors, WC Marketplace (WCMp), YITH Multi-Vendor.
- **16+ Ecosystem Plugins**: FluentCRM, Groundhogg CRM, Jetpack CRM, WpERP, MemberPress, MemberMouse, ARMember, S2Member, Simple Membership, LatePoint, BookIt, FAT Services Booking, Restaurant Reservation.
- **OTP Verification**: Checkout phone number verification via OTP codes.
- **Spintax & Dynamic Placeholders**: Native Spintax rotation `{Hi|Hello|Dear}` and shortcodes (`[order_id]`, `[order_total]`, `[tracking_url]`).

### WHMCS Integration Module
- **Website Guide**: https://whatssms.io/integrations/whmcs
- **Dashboard Addon**: v3.9 download from WhatsSMS Dashboard -> System -> Plugins
- **28 Pre-Built Lifecycle Hooks**:
  - **Billing & Invoices**: Invoice Created, Invoice Paid, 1st Overdue Notice, 2nd Overdue Notice, 3rd Final Overdue Notice.
  - **Server & Hosting Provisioning**: Accept Order, Module Create (instant cPanel/Plesk login credentials), Change Package, Suspend, Unsuspend.
  - **Domains**: Registration Success, Renewal Success, Registration/Renewal Failed Alerts, Domain Expiring Renewal Reminders.
  - **Support Tickets**: Ticket Open Admin Alert, Ticket User Reply Admin Alert, Staff Reply Notification, Ticket Closed.
  - **Security**: Client Add, Password Change, Client Login Alert, Admin Staff Login Alert.

### Perfex CRM Integration Module
- **Website Guide**: https://whatssms.io/integrations/perfexcrm
- **Module Version**: v3.9.3 download from WhatsSMS Dashboard -> System -> Plugins
- **Native App_sms Gateway Driver**:
  - **Dual Sending Service**: SMS (Android SIM 1 / SIM 2 or Global Gateway credits) OR WhatsApp (via connected WhatsApp account).
  - **Trigger Automations**: Invoices, Estimates, Proposals, Contracts, Scheduled Reminders, Tasks, Tickets, and Client Onboarding.

---

## 4. WhatsApp AI Chatbot & Automation
- Connect WhatsApp accounts via multi-device WebSockets QR pairing.
- BYO AI Key model: Users connect their own API keys for OpenAI (GPT-4o, GPT-3.5), Google Gemini (Gemini 1.5 Pro/Flash), Anthropic (Claude 3.5 Sonnet), or xAI (Grok).
- Custom system prompt engineering, context memory, and automated handover to human agents.

---

## 5. Pricing Matrix & Plan Limits

| Feature | Free Forever ($0/mo) | Pro ($19/mo) | Ultra ($39/mo) | Unlimited ($99/mo) |
| :--- | :--- | :--- | :--- | :--- |
| **Global SMS Credits Included** | **$0.20 / mo (5 SMS)** | **$2.00 / mo (50 SMS)** | **$4.00 / mo (100 SMS)** | **$10.00 / mo (250 SMS)** |
| **Global SMS Rate** | $0.04 / SMS flat | $0.04 / SMS flat | $0.04 / SMS flat | $0.04 / SMS flat |
| **Global SMS Type** | Transactional Only (No Bulk Marketing) | Transactional Only (No Bulk Marketing) | Transactional Only (No Bulk Marketing) | Transactional Only (No Bulk Marketing) |
| **SMS Send Limit** | 250 / mo | 25,000 / mo | 60,000 / mo | Unlimited |
| **SMS Receive Limit** | 250 / mo | 25,000 / mo | 60,000 / mo | Unlimited |
| **WhatsApp Send Limit** | 250 / mo | 25,000 / mo | 60,000 / mo | Unlimited |
| **WhatsApp Receive Limit** | 250 / mo | 25,000 / mo | 60,000 / mo | Unlimited |
| **Android Devices** | 1 Device | 2 Devices | 3 Devices | 5 Devices |
| **WhatsApp Accounts** | 1 Account | 2 Accounts | 3 Accounts | 5 Accounts |
| **USSD Execution** | 5 / mo | 500 / mo | 1,000 / mo | Unlimited |
| **Scheduled Messages** | 5 | 500 | 1,000 | Unlimited |
| **Saved Contacts** | 50 | 10,000 | 20,000 | Unlimited |
| **Contact Groups** | 5 | 25 | 50 | Unlimited |
| **API Keys** | 1 | 5 | 10 | Unlimited |
| **Webhooks** | 1 | 5 | 10 | Unlimited |
| **Actions & Automations** | 1 | 5 | 10 | Unlimited |
| **Message Templates** | 5 | 25 | 50 | Unlimited |
| **Automation Flows** | 1 | 5 | 10 | Unlimited |
| **AI API Keys** | 1 | 5 | 10 | Unlimited |
| **AI Plugins** | 1 | 5 | 10 | Unlimited |


---

## 6. Official Contact & Company Information
- **Brand**: WhatsSMS
- **Operating Company**: Lagash Ltd
- **Website**: https://whatssms.io
- **Web App / Dashboard**: https://app.whatssms.io
- **Email**: hello@whatssms.io
- **WhatsApp Support**: +44 7770 649691