practical_example.py

#!/usr/bin/env python3
"""
GetResponse API - Practical Contact Management Example
=====================================================

This script demonstrates practical usage of the GetResponseClient
for adding and removing contacts from campaigns.

Features demonstrated:
- Adding contacts to specific campaigns
- Removing contacts by email
- Error handling and validation
- Batch operations

Author: Agent Zero
Date: 2025-11-06
"""

import os
from getresponse_client import GetResponseClient


def add_contact_example(client, campaign_id):
    """Example of adding a contact to a campaign."""
    
    # Example contact data
    contact_data = {
        'email': 'test.user@example.com',
        'name': 'Test User',
        'campaign_id': campaign_id
    }
    
    try:
        print(f"\n➕ Adding contact: {contact_data['email']}")
        result = client.add_contact(
            email=contact_data['email'],
            campaign_id=contact_data['campaign_id'],
            name=contact_data['name']
        )
        print(f"✅ Contact added successfully!")
        print(f"   Contact ID: {result.get('contactId', 'N/A')}")
        return result
        
    except ValueError as e:
        print(f"❌ Failed to add contact: {e}")
        return None


def remove_contact_example(client, email):
    """Example of removing a contact by email."""
    
    try:
        print(f"\n➖ Removing contact: {email}")
        
        # First, check if contact exists
        contact = client.get_contact_by_email(email)
        
        if contact:
            print(f"   Found contact: {contact.get('name', 'No Name')}")
            
            # Remove the contact
            success = client.remove_contact_by_email(email)
            
            if success:
                print("✅ Contact removed successfully!")
            else:
                print("❌ Failed to remove contact")
        else:
            print("⚠️  Contact not found, nothing to remove")
            
    except ValueError as e:
        print(f"❌ Error removing contact: {e}")


def batch_operations_example(client, campaign_id):
    """Example of batch contact operations."""
    
    # Example batch of contacts
    contacts_batch = [
        {'email': 'user1@example.com', 'name': 'User One'},
        {'email': 'user2@example.com', 'name': 'User Two'},
        {'email': 'user3@example.com', 'name': 'User Three'}
    ]
    
    print(f"\n🔄 Processing batch of {len(contacts_batch)} contacts")
    
    added_contacts = []
    
    for contact in contacts_batch:
        try:
            result = client.add_contact(
                email=contact['email'],
                campaign_id=campaign_id,
                name=contact['name']
            )
            print(f"✅ Added: {contact['email']}")
            added_contacts.append(contact['email'])
            
        except ValueError as e:
            print(f"❌ Failed to add {contact['email']}: {e}")
    
    return added_contacts


def main():
    """Main function demonstrating practical usage."""
    
    try:
        # Initialize client
        client = GetResponseClient()
        
        print("🔧 GetResponse Practical Examples")
        print("=" * 50)
        
        # Test connection
        if not client.test_connection():
            print("❌ Connection failed. Please check your API key.")
            return
        
        print("✅ Connection successful!")
        
        # Get campaigns to work with
        campaigns = client.get_campaigns()
        
        if not campaigns:
            print("❌ No campaigns found in your account.")
            return
        
        # Use the first campaign for examples
        campaign = campaigns[0]
        campaign_id = campaign['campaignId']
        
        print(f"\n🎯 Using campaign: {campaign['name']} (ID: {campaign_id})")
        
        # Example 1: Add a contact
        added_contact = add_contact_example(client, campaign_id)
        
        # Example 2: Remove the contact we just added (if successful)
        if added_contact:
            remove_contact_example(client, 'test.user@example.com')
        
        # Example 3: Batch operations (commented out to prevent accidental execution)
        # print("\n💡 Uncomment the batch_operations_example call to test batch operations")
        # added_emails = batch_operations_example(client, campaign_id)
        # 
        # # Clean up batch contacts
        # if added_emails:
        #     print(f"\n🧹 Cleaning up {len(added_emails)} test contacts...")
        #     for email in added_emails:
        #         remove_contact_example(client, email)
        
        print("\n" + "=" * 50)
        print("🎉 Practical examples completed!")
        print("\n📝 Usage Tips:")
        print("• Always handle exceptions when making API calls")
        print("• Validate email addresses before adding")
        print("• Use get_campaigns() to find the right campaign IDs")
        print("• Implement rate limiting for batch operations")
        
    except ValueError as e:
        print(f"\n❌ Setup Error: {e}")
        print("\n🔧 Please ensure you have:")
        print("1. Created a .env file with GETRESPONSE_API_KEY")
        print("2. Installed requirements: pip install -r requirements.txt")


if __name__ == "__main__":
    main()