AUTHORIZED PARTNER
Complete Developer & SMB Operations Manual

UnExplores WhatsApp Cloud Services Documentation

Everything you need to automate customer conversations, build 24/7 intelligent chatbots, send real-time business notifications, configure Model Context Protocol (MCP) AI agents, and integrate carrier-grade WhatsApp REST APIs into your software.

For Small Businesses

Zero coding required. Set up instant auto-replies, catalog inquiries, and customer appointment booking in minutes.

For Developers

High-throughput REST API, webhook events, SDKs for Node.js, Python, & PHP, with subsidized rates upon ID validation.

For AI Architects

Plug WhatsApp directly into Claude Desktop, Cursor, or LangChain via standard Model Context Protocol (MCP) tools.

1 Instance Setup & Device Pairing

Connect your existing phone number or official SIM card to your dedicated cloud node.

UnExplores provides two fast, reliable pairing mechanisms. No Facebook Developer App review or complicated Meta Business verification is required to start testing.

Method A: QR Code Scanning
  1. Open your UnExplores Portal Dashboard.
  2. Navigate to WhatsApp Cloud Services → Device Pairing.
  3. Open WhatsApp on your smartphone → Linked Devices.
  4. Tap Link a Device and point your camera at the QR code.
  5. The connection establishes automatically in < 3 seconds.
Method B: 8-Digit Phone Pairing Code
  1. Enter your full international phone number (e.g. +923001234567).
  2. Click Request 8-Digit Pairing Code.
  3. Open WhatsApp on your smartphone → Linked Devices → Link with phone number instead.
  4. Type the 8-digit code displayed on your screen. Your device is now connected!

Credentials & API Keys

Every provisioned instance receives a unique Instance ID and high-entropy API Key. Include these two headers in all HTTP requests to authenticate:

// Required HTTP Request Headers
X-Api-Key: ue_live_8f93e0b291a47c4b12
X-Instance-Id: inst_923001234567_prod
Content-Type: application/json
Number Safety, Anti-Ban & Architecture Guidelines

To maintain high delivery reputation and prevent temporary WhatsApp bans, follow these best practices:

  • Pure Carrier Socket Node vs. Unofficial Extensions: Unlike fragile Chrome browser automation extensions that Meta and WhatsApp actively flag and ban, UnExplores operates hardened binary socket carrier daemons that simulate native WhatsApp multi-device companion protocol with 99.9% persistent uptime.
  • New Numbers: For brand new SIM cards, send 20–50 conversational messages daily for the first 3 days before launching larger broadcasts.
  • Opt-in Messages: Ensure recipients expect your messages (e.g. order alerts, password resets, client confirmations).
  • Anti-Ban Throttling & Spintax: UnExplores automatically spaces automated broadcast messages with a randomized 2–6 second delay and supports Spintax variation ({Hello|Hi|Greetings}). Never send hundreds of identical messages in a single second.
Small & Medium Business Suite

2 WhatsApp Chatbots for Small & Medium Businesses (SMBs)

Why small businesses need automated chatbots, and how to build one in 5 minutes without writing a single line of code.

Most small businesses lose potential buyers because they cannot reply to WhatsApp inquiries immediately. A customer inquiring about product price, clinic timings, or catalog availability at 10:00 PM will buy from a competitor if you don't answer within minutes.

UnExplores Visual Chatbot Rules give you an instant, 24/7 digital receptionist that answers common questions, captures customer names and phone numbers, and sends price lists automatically.

Instant Auto-Replies

Replies in < 1 second when a customer texts "Price", "Location", "Timings", or "Menu".

After-Hours Responder

Greets customers politely when your store is closed and promises a morning callback.

Human Agent Handoff

Routes complex questions directly to your support team when the bot reaches its limits.

How to Configure a Chatbot Rule

  1. Go to your UnExplores Portal Dashboard → WhatsApp Node → Visual Chatbot Rules.
  2. Click Add New Bot Rule.
  3. Select the Trigger Type:
    • Exact Match: Triggers only when the message is exactly "PRICE" or "1".
    • Contains Keyword: Triggers if the customer's text contains words like "address", "timing", or "order status".
    • Regex Pattern: For advanced pattern matching (e.g. detecting order numbers like UX-1234).
  4. Type your automated reply message (you can format text with bold *text*, lists, and emojis).
  5. Click Save Rule. The rule activates immediately on your live WhatsApp instance.

Ready-to-Use Business Templates

πŸ›οΈ E-Commerce / Retail Shop
"Hello! πŸ‘‹ Welcome to [Brand Name].
1️⃣ View Catalog / New Arrivals
2️⃣ Track Your Order
3️⃣ Talk to Sales Representative"
🩺 Medical Clinic / Dental Practice
"Thank you for contacting Dr. [Name]'s Clinic.
Our clinic hours are Mon–Sat, 4 PM – 9 PM.
To book an appointment, reply with your Full Name & Preferred Date."

3 REST API Reference & SDKs

Clean, standard JSON endpoints for programmatic WhatsApp dispatching and automation.

Production API Base URL
https://node.unexplores.com/waservices/
HTTPS Only
POST /messages/text Send an interactive text message
Request Body (JSON):
{ "recipient": "923001234567", "message": "Hello from UnExplores! Your OTP code is *849201*." }
Response (200 OK):
{ "success": true, "message_id": "3EB048291A7B9C4E0F", "status": "DELIVERED", "timestamp": 1725458900 }
POST /messages/media Send PDF invoices, images, audio & documents
Request Body (JSON):
{ "recipient": "923001234567", "media_url": "https://unexplores.com/invoices/INV-9021.pdf", "media_type": "document", "caption": "Your monthly cloud hosting invoice #INV-9021", "filename": "Invoice_Aug_2026.pdf" }

Code Examples

curl -X POST "https://node.unexplores.com/waservices/messages/text" -H "Content-Type: application/json" -H "X-Api-Key: YOUR_API_KEY" -H "X-Instance-Id: YOUR_INSTANCE_ID" -d '{ "recipient": "923001234567", "message": "Hello from cURL via UnExplores WhatsApp Node!" }'
Next-Gen Agentic Architecture

4 AI Assistant & Model Context Protocol (MCP) Suite

Connect Google Gemini, Anthropic Claude, OpenAI GPT-4o, Cursor IDE, Windsurf, or custom autonomous LLMs directly to your WhatsApp instances with bidirectional tools and structured output.

Autonomous AI Agent Flow Pipeline

When a customer messages your WhatsApp number, the UnExplores Carrier Node instantly forwards the message to your webhook or MCP agent. The AI analyzes customer intent, calls external tools (e.g. ERP order lookups, database queries, banking APIs), and dispatches the formatted reply back to WhatsApp in under 500ms.

[Customer WhatsApp] ──> [UnExplores Carrier Node (168.222.94.138:3000)] β”‚ (Instant Webhook POST / Inbound JSON) β–Ό [Your AI Agent: OpenAI / Claude / Gemini Enterprise / MCP] β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β–Ό β–Ό [Tool Calls: ERP/DB] [Multimodal OCR: Receipts] β”‚ β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β–Ό [UnExplores REST API POST /messages/text] ──> [Customer Phone Delivered]

UnExplores AI Enterprise Integration

Powered by Google AI Cloud

Deploy UnExplores AI (backed by Google Cloud Vertex AI infrastructure) for high-throughput multimodal reasoning, 2M+ token context windows, and autonomous function calling. Here is an end-to-end Python script connecting an inbound webhook to UnExplores AI and replying automatically:

import os, requests from flask import Flask, request, jsonify from google import genai from google.genai import types app = Flask(__name__) client = genai.Client(api_key=os.environ.get("GEMINI_API_KEY")) # Define Business Tools exposed to Gemini def check_order_status(order_id: str) -> str: """Queries ERP database for live order shipment status.""" # Replace with your actual SQL or ERP query return f"Order #{order_id} is PACKED and scheduled for dispatch tomorrow." tools = [check_order_status] @app.route("/whatsapp/webhook", methods=["POST"]) def whatsapp_webhook(): data = request.json sender = data.get("sender") or data.get("recipient") message_text = data.get("message", "") # Call Gemini Enterprise with automatic function execution response = client.models.generate_content( model="gemini-2.5-flash", # Vertex AI Enterprise Model contents=message_text, config=types.GenerateContentConfig( tools=tools, system_instruction="You are UnExplores WhatsApp Support. Reply politely, concisely, and in the customer's language (Urdu or English)." ) ) reply_text = response.text or "Thank you for reaching out to UnExplores." # Dispatch reply back through UnExplores Carrier Node requests.post( "https://node.unexplores.com/waservices/messages/text", headers={ "Content-Type": "application/json", "X-Api-Key": os.environ.get("UNEXPLORES_WA_API_KEY"), "X-Instance-Id": os.environ.get("UNEXPLORES_WA_INSTANCE_ID") }, json={"recipient": sender, "message": reply_text} ) return jsonify({"status": "handled", "reply": reply_text}), 200 if __name__ == "__main__": app.run(port=5000)
Anthropic Claude Desktop MCP Configuration claude_desktop_config.json

Add the following configuration to your Claude Desktop configuration file (found at %APPDATA%\Claude\claude_desktop_config.json on Windows, or ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{ "mcpServers": { "unexplores-whatsapp": { "command": "npx", "args": [ "-y", "@unexplores/mcp-whatsapp-node", "--instance=YOUR_INSTANCE_ID", "--api-key=YOUR_API_KEY", "--endpoint=https://node.unexplores.com/waservices" ] } } }
Cursor IDE & Windsurf MCP Configuration .cursor/mcp.json

In Cursor IDE (Settings → Features → MCP) or inside your workspace root in .cursor/mcp.json:

{ "mcpServers": { "unexplores-whatsapp-dev": { "command": "node", "args": ["./scripts/mcp-whatsapp-bridge.js"], "env": { "UNEXPLORES_WA_ENDPOINT": "https://node.unexplores.com/waservices", "UNEXPLORES_WA_API_KEY": "ux_live_sec_...", "UNEXPLORES_WA_INSTANCE_ID": "ux_wa_inst_01" } } } }

Standard Built-in MCP Tools Exposed to AI

send_whatsapp_message ACTION

Transmits text messages with markdown formatting (*bold*, _italic_, ~strike~) to any recipient phone number.

Params: recipient (str), message (str)
send_whatsapp_media MEDIA

Sends PDF invoice files, order receipt images, audio voice notes, or documents directly to the customer chat.

Params: recipient (str), media_url (str), filename (str)
get_session_status TELEMETRY

Returns active pairing status, carrier node latency, battery percentage, and companion device JID.

Params: instance_id (str, optional)
escalate_to_human_agent HANDOFF

Suspends AI auto-replies for this chat session and immediately notifies the human support operator inbox.

Params: recipient (str), reason (str), summary (str)
Multimodal Image OCR: Bank Slips & Invoices

When a customer uploads an image (e.g. Easypaisa / JazzCash / Bank transfer screenshot), your inbound webhook receives a media_url. Pass this directly to Gemini Enterprise or GPT-4o vision models to verify the Transaction ID, settlement amount, and clearance timestamp before marking an order paid.

Context Memory & Sliding Window Persistence

For multi-turn customer dialogues, maintain a sliding window of the last 6-10 messages keyed by the customer's normalized WhatsApp number (e.g. session_923001234567). UnExplores' high-throughput webhooks guarantee message ordering so your LLM never loses conversational context.

Native E-Commerce Automation

Shopify OrderConnect & E-Commerce Gateway

Open OrderConnect App

UnExplores OrderConnect is an official Shopify embedded companion application engineered to eliminate Return-to-Origin (RTO) courier losses, automate order fulfillment updates, and recover abandoned checkouts using UnExplores AI (Powered by Google Cloud Vertex AI) and pure socket WhatsApp carriers.

1-Click COD Confirmation

Upon checkout, customers instantly receive a WhatsApp message with interactive confirmation buttons: [Confirm Order] and [Cancel Order]. Address verification cuts fake and impulse orders by up to 45%.

Live Courier Tracking Alerts

When an order is fulfilled in Shopify, OrderConnect automatically detects courier tracking numbers (TCS, Leopards, Trax, PostEx, DHL) and delivers real-time tracking links directly into WhatsApp.

UnExplores AI Cart Recovery

Detects abandoned checkouts and triggers personalized WhatsApp recovery messages in fluent Roman Urdu or English with dynamic discount codes generated via UnExplores AI (Powered by Google Cloud Vertex AI).

Shopify Webhook Subscription & Verification

OrderConnect registers automated webhooks with Shopify upon installation. Every payload is cryptographically validated using HMAC SHA-256 signatures:

// Validating incoming Shopify Order Webhook in Node.js const crypto = require('crypto'); function verifyShopifyHmac(rawBody, hmacHeader, secret) { const hash = crypto .createHmac('sha256', secret) .update(rawBody, 'utf8') .digest('base64'); return crypto.timingSafeEqual(Buffer.from(hash), Buffer.from(hmacHeader)); } // Inbound POST /api/webhooks/shopify/orders-create app.post('/api/webhooks/shopify/orders-create', (req, res) => { const hmac = req.headers['x-shopify-hmac-sha256']; if (!verifyShopifyHmac(req.rawBody, hmac, process.env.SHOPIFY_API_SECRET)) { return res.status(401).send('Unauthorized webhook signature'); } const order = req.body; const customerPhone = order.shipping_address?.phone || order.phone; const orderNumber = order.name; // e.g. "#1042" const totalPrice = order.total_price + ' ' + order.currency; // Trigger WhatsApp 1-Click COD Confirmation via UnExplores Carrier Gateway sendWhatsAppConfirmation(customerPhone, orderNumber, totalPrice); res.status(200).send('OK'); });

Triggering OrderConnect from WooCommerce & Custom ERPs

REST Endpoint

Not on Shopify? Trigger identical WhatsApp COD verifications, dispatch notifications, or receipt PDFs from any custom PHP, Python, or WooCommerce store:

# Trigger Order Verification via cURL curl -X POST "https://node.unexplores.com/orderconnect/api/orders/trigger" -H "Content-Type: application/json" -H "X-Api-Key: YOUR_UNEXPLORES_API_KEY" -H "X-Instance-Id: YOUR_INSTANCE_ID" -d '{ "recipient": "923001234567", "event": "order_confirmation", "order_id": "#WC-8492", "items": ["Executive Ortho Chair (x1)", "Lumbar Pillow (x2)"], "total_amount": "₨ 18,500", "payment_method": "Cash on Delivery (COD)", "confirmation_url": "https://yourstore.com/orders/confirm?token=xyz", "cancellation_url": "https://yourstore.com/orders/cancel?token=xyz" }'
Flexible Scaling Without Upgrading

On-Demand Quota Boosters & UnExplores AI Credits (Powered by Google Cloud)

Grow your chatbot rules and AI generative capacity on your own terms. Add-on boosters attach instantly to your active instance, rollover seamlessly, and never expire.

Automated Chatbot Rule Boosters

Never Expire

Expand your chatbot's conversational reach with extra trigger-reply rules across product inquiries, branch FAQs, and lead qualifiers.

+10 Chatbot Automation Rules
Attach to Starter or Growth tiers
₨ 450
+25 Chatbot Automation Rules
Popular package for expanding catalogs
₨ 950
+50 Chatbot Automation Rules
Massive conversational capacity for high-volume lines
₨ 1,600

UnExplores AI Credit Top-Ups (Powered by Google Cloud)

Universal Token Balance

Power generative replies, autonomous Roman Urdu/English conversations, campaign copy generation, and multimodal slip OCR.

500 Extra AI Credits
Instant top-up for copy, replies & OCR
₨ 450
2,000 Extra AI Credits
Bulk value pack for campaign seasons
₨ 1,500
5,000 Extra AI Credits
Agency-grade volume for non-stop autonomous operations
₨ 3,200

UnExplores AI Consumption Matrix (Powered by Google Cloud Vertex AI)

Our platform is powered directly by UnExplores AI running on Google Cloud Vertex AI Enterprise (unexplores-eaa6e project) with zero third-party latency. Compute is deducted predictably according to the following matrix:

AI Operation Engine / Model Credits Deducted Typical Latency
WhatsApp Inbound Auto-Reply gemini-2.5-flash 1 Credit / response ~600ms - 1.2s
AI Campaign Copy Generation (Spintax) gemini-2.5-flash 1 Credit / generation ~1.5s - 2.5s
Automated Chatbot Rule Wizard gemini-2.5-flash 1 Credit / 5 rules ~2.0s - 3.5s
Multimodal Vision OCR (Bank Slip / CNIC) gemini-2.5-flash / vision 2 Credits / document ~1.8s - 3.0s
Deep Contextual Reasoning / Complex Tool Calls gemini-2.5-pro 5 Credits / query ~4.0s - 12.0s
Trust & Compliance Policy

7 Developer Identity Verification & Developer API Pricing

Why developer identity validation is mandatory, and how it unlocks the verified ₨ 2,850 / mo ($10 USD) developer rate.

To ensure zero spam, prevent phishing, and protect the carrier delivery reputation of our cloud clusters, all developers requesting direct programmatic REST API keys must validate their developer identity.

The 1-Minute Developer Verification Process
  1. Sign in to your UnExplores Portal Console.
  2. Navigate to WhatsApp Cloud Services → API & Webhooks.
  3. Click Verify Developer Identity.
  4. Connect your active GitHub profile, LinkedIn Developer account, or submit your active portfolio/company website.
  5. Our automated verification system approves legitimate software engineers within seconds.

Verified Developer API & MCP Account

Specially discounted pricing for verified indie hackers, students, SaaS developers, and software engineers.

₨ 2,850 / month
or $10 USD / mo (₨ 2,280 / $8 annual)
Includes 1 Connected WhatsApp Line, 30 Smart Auto-Reply Rules, 750 Monthly AI Credits, Full REST API & Webhooks, MCP AI Server Suite, Node.js/Python/PHP SDKs, and 7-Day Free Trial.
Mandatory Legal Disclaimer for Sandbox & Test QR Messages

All messages dispatched via our public test QR simulator or sandbox nodes automatically append the official UnExplores secondary carrier disclaimer. UnExplores SMC-Pvt Ltd acts strictly as a transport gateway layer and bears no responsibility or liability for user-generated message content or recipient opt-in consent. Spam, OTP phishing, and abusive transmissions result in instant automated account termination.