Skip to main content

🚀 Introduction

Welcome to the Whatspie - The most powerful and developer-friendly WhatsApp Business API that enables seamless integration of WhatsApp messaging capabilities into your applications.

✨ What makes Whatspie V2 Special?

Enterprise-grade WhatsApp API with advanced features, real-time webhooks, and multi-device support designed for businesses of all sizes.

🎯 Core Features​

📬 Rich Messaging

  • Text messages with formatting
  • Images with captions
  • Documents and files
  • Location sharing
  • Interactive buttons & lists (deprecated)
  • Template messages (deprecated)

📱 Multi-Device Support

  • QR code authentication
  • Device status monitoring
  • Session management
  • Auto-reconnection
  • Device switching

🔐 Enterprise Security

  • Bearer token authentication
  • Rate limiting protection
  • Secure webhook endpoints
  • Data encryption
  • Compliance ready

🌐 Base URL​

https://api.whatspie.com

🚀 Quick Start​

Get started with Whatspie API in just a few steps:

1. Authentication​

All API requests require a Bearer token in the Authorization header:

curl -H 'Authorization: Bearer YOUR_API_TOKEN' \
     -H 'Content-Type: application/json' \
     -H 'Accept: application/json'

2. Send Your First Message​

curl -X POST 'https://api.whatspie.com/messages' \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "device": "62895383079050",
    "receiver": "6285603051722",
    "type": "chat",
    "params": {
      "text": "Hi!"
    },
    "simulate_typing": 1
}'

3. Handle Responses​

{
    "status": 200,
    "message": "OK",
    "data": {
        "id": 36259782,
        "from_number": "62895383079050",
        "to_number": "6285603051722",
        "type": "chat",
        "msg_type": "outgoing",
        "body": "Hi!",
        "status": "PENDING",
        "wa_id": null,
        "retry": 0,
        "failed_reason": null,
        "file_url": null,
        "file_name": null,
        "file_caption": null,
        "file_size": null,
        "file_mime": null,
        "params": {
            "text": "Hi!"
        },
        "is_group": false,
        "created_at": "2025-08-22T03:36:02.179279985Z",
        "updated_at": "2025-08-22T03:36:02.179280065Z"
    }
}

API Features​

📬 Messaging​

  • Send text messages
  • Send images with captions
  • Send documents and files
  • Send location coordinates

👥 Group Management​

  • Add/remove participants
  • Update group information

🔐 Authentication & Security​

  • JWT token-based authentication
  • Basic authentication for initial setup
  • Secure device connection management

📱 Device Management​

  • QR code generation for WhatsApp Web
  • Device status monitoring
  • Logout and session management
  • Contact verification

Response Format​

All API responses follow a consistent format:

{
  'code': 200,
  'message': 'OK',
  'data': {
    // Response data here
  }
}

Rate Limits​

Please be mindful of WhatsApp's rate limits to avoid being blocked:

  • Group messages: Depends on group size and message frequency
  • QR code requests: Limited to prevent abuse

Let's get started with your WhatsApp integration! 🚀