Get Message Status

import requests
from typing import Optional

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

def get_message_status(message_id: str) -> Optional[dict]:
    """
    Get delivery status of a specific SMS message
    
    Args:
        message_id: The unique message ID returned when SMS was sent
        
    Returns:
        dict: API response with message status, or None on failure
    """
    
    # Construct URL with message ID
    url = f"{API_BASE_URL}/{message_id}/"
    
    # Request headers with Bearer token
    headers = {
        "Authorization": f"Bearer {BEARER_TOKEN}",
    }
    
    try:
        # Make GET request
        response = requests.get(url, headers=headers)
        
        # Check if request was successful
        if response.status_code == 200:
            result = response.json()
            message = result['data']
            
            print("✓ Message status retrieved!")
            print(f"Message ID: {message['id']}")
            print(f"Recipient: {message['recipient_phone']}")
            print(f"Status: {message['status_display']}")
            print(f"Sent at: {message['sent_at']}")
            
            if message['delivered_at']:
                print(f"Delivered at: {message['delivered_at']}")
            
            print(f"SMS Units: {message['sms_units_consumed']}")
            
            return result
            
        elif response.status_code == 404:
            error = response.json()
            print(f"✗ Message Not Found: {error.get('message', 'Invalid message ID')}")
            return None
            
        elif response.status_code == 403:
            error = response.json()
            print(f"✗ Authentication Error: {error['error']['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

def wait_for_delivery(message_id: str, max_attempts: int = 10, interval: int = 5):
    """
    Poll message status until delivered or failed
    
    Args:
        message_id: The unique message ID
        max_attempts: Maximum number of status checks
        interval: Seconds to wait between checks
    """
    import time
    
    for attempt in range(max_attempts):
        print(f"\nCheck {attempt + 1}/{max_attempts}...")
        status_info = get_message_status(message_id)
        
        if not status_info:
            break
            
        status = status_info['data']['status']
        
        if status in ['delivered', 'failed', 'rejected']:
            print(f"\n✓ Final status: {status}")
            return status_info
        
        if attempt < max_attempts - 1:
            print(f"Status: {status} - waiting {interval}s...")
            time.sleep(interval)
    
    print("\n✗ Max attempts reached")
    return None

# Example usage
if __name__ == "__main__":
    # Check specific message
    message_id = "f2672215-c20b-452a-9b6b-1ba51884c55e"
    status = get_message_status(message_id)
    
    # Or wait for delivery
    # wait_for_delivery(message_id)