wapilot-sdk 1.0.0

Official Python SDK for WAPILOT.io - WhatsApp Business API Integration

WAPILOT Python SDK

Official Python SDK for WAPILOT.io - WhatsApp Business API Integration Platform

Overview

WAPILOT SDK provides a simple and intuitive way to integrate WhatsApp Business API functionality into your Python applications. This SDK handles all the complexity of API communication, authentication, and data formatting, allowing you to focus on building your application logic.

Features

• 📱 Contact Management - Create, update, and manage WhatsApp contacts
• 👥 Contact Groups - Organize contacts into groups for better management
• 💬 Message Sending - Send text, media, and interactive messages
• 📝 Templates - Manage and send template messages
• 🤖 Automated Replies - Set up and manage automated responses
• ✨ Modern Architecture - Built with modern Python, supports async/await
• 🔒 Secure - Built-in token-based authentication and HTTPS
• 🚀 Simple API - Intuitive methods for all operations

Installation

pip install wapilot-sdk

Quick Start

from wapilot import WapilotSDK

# Initialize the SDK
wapilot = WapilotSDK(token='your-api-token')  # Get this from your WAPILOT dashboard

# Send a message
try:
    result = wapilot.send_message({
        'phone': '[phone]',
        'message': 'Hello from Python!'
    })
    print(result)
except Exception as e:
    print(f'Error: {e}')

Configuration Options

Option	Type	Required	Default	Description
token	str	Yes	-	Your WAPILOT API token
base_url	str	No	https://app.wapilot.io	API base URL

API Reference

Contact Management

Get All Contacts

contacts = wapilot.get_contacts()

Create Contact

new_contact = wapilot.create_contact({
    'name': 'John Doe',
    'phone': '[phone]',  # International format with country code
    # Optional fields
    'email': '[e-mail]',
    'notes': 'VIP Customer'
})

Update Contact

updated_contact = wapilot.update_contact('contact-uuid', {
    'name': 'John Smith',
    # Include only fields you want to update
})

Delete Contact

wapilot.delete_contact('contact-uuid')

Message Sending

Send Text Message with Interactive Buttons

wapilot.send_message({
    'phone': '[phone]',
    'message': 'Hello! How can we help you today?',
    'header': 'Welcome Message',  # Optional
    'footer': 'Reply with a button',  # Optional
    'buttons': [
        {
            'id': 'support',
            'title': 'Get Support'
        },
        {
            'id': 'sales',
            'title': 'Sales Inquiry'
        }
    ]
})

Send Media Message

wapilot.send_media_message({
    'phone': '[phone]',
    'media_type': 'image',  # 'image', 'video', 'document', 'audio'
    'media_url': 'https://example.com/image.jpg',
    'caption': 'Check out our new product!',  # Optional
    'file_name': 'product.jpg'  # Required for documents
})

Send Template Message

wapilot.send_template_message({
    'phone': '[phone]',
    'template': {
        'name': 'appointment_reminder',
        'language': {
            'code': 'en'  # Language code
        },
        'components': [
            {
                'type': 'header',
                'parameters': [
                    {
                        'type': 'image',
                        'image': {
                            'link': 'https://example.com/appointment.jpg'
                        }
                    }
                ]
            },
            {
                'type': 'body',
                'parameters': [
                    {
                        'type': 'text',
                        'text': 'John Doe'  # Dynamic parameter
                    },
                    {
                        'type': 'text',
                        'text': '3:00 PM'  # Dynamic parameter
                    }
                ]
            }
        ]
    }
})

Contact Groups

Get All Groups

groups = wapilot.get_contact_groups()

Create Group

new_group = wapilot.create_contact_group({
    'name': 'VIP Customers',
    'description': 'Our premium customers'  # Optional
})

Update Group

updated_group = wapilot.update_contact_group('group-uuid', {
    'name': 'Premium Customers'
})

Delete Group

wapilot.delete_contact_group('group-uuid')

Automated Replies

Get All Automated Replies

replies = wapilot.get_canned_replies()

Create Automated Reply

new_reply = wapilot.create_canned_reply({
    'name': 'Welcome Message',
    'message': 'Thank you for contacting us! Our team will respond shortly.',
    'keywords': ['hi', 'hello', 'hey']  # Optional trigger keywords
})

Update Automated Reply

updated_reply = wapilot.update_canned_reply('reply-uuid', {
    'message': 'Thank you for reaching out! We will get back to you soon.'
})

Delete Automated Reply

wapilot.delete_canned_reply('reply-uuid')

Templates

Get All Templates

templates = wapilot.get_templates()

Error Handling

The SDK uses Python's built-in exception handling:

try:
    contacts = wapilot.get_contacts()
except requests.exceptions.RequestException as e:
    if e.response is not None:
        # API Error (4xx or 5xx response)
        print(f'API Error: {e.response.json()}')
        print(f'Status Code: {e.response.status_code}')
    else:
        # Network Error (no response received)
        print(f'Network Error: {e}')
except Exception as e:
    # Other errors
    print(f'Error: {e}')

Common Error Codes:

• 401: Invalid or expired API token
• 400: Invalid request parameters
• 404: Resource not found
• 429: Rate limit exceeded
• 500: Server error

Best Practices

1. Error Handling: Always implement proper error handling using try/except blocks
2. Token Security: Never expose your API token in client-side code
3. Rate Limiting: Implement proper rate limiting in your application
4. Message Templates: Use templates for recurring messages
5. Contact Management: Keep contact information up to date
6. Testing: Test your integration thoroughly in a development environment

Support

For support or inquiries, please contact:

• Email: [e-mail]

License

MIT License - feel free to use this SDK in your projects.