Send Bulk SMS

import requests
import json

# Configuration
# Get your API key from: https://roycetalk.com/
# Format: XXXX_XXXXXXXXXXXXXXXXXXXXXXXX_
API_URL = "https://roycetalk.com/api/v1/sms-api/send-bulk/"
BEARER_TOKEN = "XXXX_XXXXXXXXXXXXXXXXXXXXXXXX_"

def send_bulk_sms(phone_numbers: list, message: str, sender_id: str):
    """
    Send bulk SMS to multiple recipients via RoyceBulkSMS API
    
    Args:
        phone_numbers: List of recipient phone numbers (format: +254XXXXXXXXX)
        message: SMS message content
        sender_id: Your approved sender ID
        
    Returns:
        dict: API response with batch status
    """
    
    # Request headers with Bearer token
    headers = {
        "Authorization": f"Bearer {BEARER_TOKEN}",
        "Content-Type": "application/json"
    }
    
    # Request payload
    payload = {
        "phone_number": phone_numbers,
        "sender_id": sender_id,
        "text_message": message
    }
    
    try:
        # Make POST request
        response = requests.post(API_URL, json=payload, headers=headers)
        
        # Check if request was successful
        if response.status_code == 200:
            result = response.json()
            print("✓ Bulk SMS queued successfully!")
            print(f"Batch ID: {result['data']['batch_id']}")
            print(f"Total Recipients: {result['data']['total_recipients']}")
            print(f"Messages Queued: {result['data']['messages_queued']}")
            print(f"Messages Failed: {result['data']['messages_failed']}")
            print(f"Total Cost: KES {result['data']['total_cost']}")
            print(f"Balance: {result['data']['balance_remaining']} units")
            return result
            
        elif response.status_code == 403:
            error = response.json()
            print(f"✗ Authentication Error: {error['error']['message']}")
            return None
            
        elif response.status_code == 400:
            error = response.json()
            print(f"✗ Validation Error: {error['message']}")
            if 'errors' in error and error['errors']:
                for err in error['errors']:
                    print(f"  - {err['message']}")
            return None
            
        else:
            print(f"✗ Unexpected Error: {response.status_code}")
            print(response.text)
            return None
            
    except requests.exceptions.RequestException as e:
        print(f"✗ Request failed: {str(e)}")
        return None

# Example usage
if __name__ == "__main__":
    # List of recipients
    recipients = [
        "+254712345678",
        "+254722334455",
        "+254733445566"
    ]
    
    result = send_bulk_sms(
        phone_numbers=recipients,
        message="Hello! This is a bulk message to all recipients.",
        sender_id="RoyceLTD"
    )
    
    if result:
        print("\nFull Response:")
        print(json.dumps(result, indent=2))