Developers - Pantheon Cloud

Leverage the world's most popular messaging platform to connect with your customers through automated notifications, customer support, and interactive experiences.

Overview

PantheonCloud's WhatsApp Business API integration allows businesses to build scalable customer communication solutions. Send personalized messages, share rich media, and create interactive experiences that enhance customer engagement across the entire customer lifecycle.

Rich Messaging

Send text, images, documents, and interactive messages to customers.

Global Reach

Connect with over 2 billion WhatsApp users worldwide.

Automation

Build chatbots and automated workflows for 24/7 customer service.

Key Features

Template Messages

Pre-approved message templates for business-initiated conversations.

Order confirmations and updates
Appointment reminders
Customer support notifications
Personalized promotional messages

Rich Media Support

Enhance communication with various media types for better engagement.

Images (JPG, PNG up to 16MB)
Documents (PDF, Word, Excel up to 100MB)
Audio files (MP3, OGG up to 16MB)
Video files (MP4, AVI up to 16MB)

Interactive Messages

Create engaging experiences with interactive elements for user input.

Quick reply buttons
List pickers for multiple options
Product catalog integration
Location sharing capabilities

Secure Communications

End-to-end encryption and compliance with global data protection standards.

End-to-end encrypted messages
GDPR compliant data handling
Message retention policies
Secure authentication protocols

Analytics & Insights

Track message delivery and read status to optimize your communication strategy.

Delivery status tracking
Read receipt monitoring
Response rate analysis
Conversation length metrics

Easy Integration

Simple API integration with your existing business systems and workflows.

RESTful API endpoints
Webhook support for real-time events
SDKs for popular programming languages
Detailed documentation and code samples

API Endpoints

Send WhatsApp Message

POST

https://api.bitpanyun.com/v1/whatsapp/messages

Request Body

JSON Example

{
  "from": "14155550000",
  "to": "+12125551234",
  "type": "text",
  "template": {
    "name": "order_confirmation",
    "language": {
      "code": "en_US"
    },
    "components": [
      {
        "type": "header",
        "parameters": [
          {
            "type": "text",
            "text": "#ORD-12345"
          }
        ]
      },
      {
        "type": "body",
        "parameters": [
          {
            "type": "text",
            "text": "John Doe"
          },
          {
            "type": "text",
            "text": "$129.99"
          },
          {
            "type": "text",
            "text": "July 15, 2023"
          }
        ]
      }
    ]
  }
}

Response

JSON Example

{
  "message_id": "msg_123456789",
  "status": "sent",
  "recipient_id": "+12125551234",
  "timestamp": "2023-07-15T10:30:00Z",
  "price": {
    "amount": 0.005,
    "currency": "USD"
  }
}

Get Message Status

GET

https://api.bitpanyun.com/v1/whatsapp/messages/{message_id}

Response

JSON Example

{
  "message_id": "msg_123456789",
  "from": "14155550000",
  "to": "+12125551234",
  "status": "read",
  "timestamp": "2023-07-15T10:30:00Z",
  "sent_at": "2023-07-15T10:30:00Z",
  "delivered_at": "2023-07-15T10:30:02Z",
  "read_at": "2023-07-15T10:31:15Z",
  "message_type": "template",
  "template_name": "order_confirmation"
}

Send Media Message

POST

https://api.bitpanyun.com/v1/whatsapp/media

Request Body

JSON Example

{
  "from": "14155550000",
  "to": "+12125551234",
  "type": "image",
  "media": {
    "link": "https://example.com/invoice.pdf",
    "caption": "Your order invoice"
  }
}

Response

JSON Example

{
  "message_id": "msg_987654321",
  "status": "sent",
  "recipient_id": "+12125551234",
  "timestamp": "2023-07-15T10:35:00Z",
  "media_id": "media_123456789",
  "price": {
    "amount": 0.015,
    "currency": "USD"
  }
}

Error Codes

Code	Description	Resolution
WA_001	Invalid authentication credentials	Verify your API key and secret are correct
WA_002	Recipient not on WhatsApp	Verify the phone number is registered on WhatsApp
WA_003	Template not approved	Submit your template for approval in the WhatsApp Business Manager
WA_004	Media size exceeds limit	Reduce the size of your media file (images: 16MB, documents: 100MB)
WA_005	Rate limit exceeded	Reduce the frequency of your API calls or request a rate limit increase
WA_006	Invalid media format	Ensure your media file is in a supported format (JPG, PNG, PDF, MP3, MP4)
WA_007	Phone number not registered	Register your WhatsApp Business phone number in the Business Manager
WA_008	Business not verified	Complete business verification in the WhatsApp Business Manager