How to Add Claude AI to WooCommerce: Integration Guide

// wp-config.php additions
define('ANTHROPIC_API_KEY', 'your-api-key-here');
define('CLAUDE_MODEL', 'claude-3-sonnet-20240229');
define('CLAUDE_MAX_TOKENS', 1000);
define('CLAUDE_RATE_LIMIT_PER_MINUTE', 50);

composer require anthropic-ai/anthropic-sdk-php

class WooClaudeIntegration {
    private $client;
    private $rate_limiter;
    
    public function __construct() {
        $this->client = new Anthropic\Client(ANTHROPIC_API_KEY);
        $this->rate_limiter = new RateLimiter();
    }
    
    public function generate_content($prompt, $system_message = '') {
        if (!$this->rate_limiter->can_make_request()) {
            return new WP_Error('rate_limit', 'API rate limit exceeded');
        }
        
        try {
            $response = $this->client->messages()->create([
                'model' => CLAUDE_MODEL,
                'max_tokens' => CLAUDE_MAX_TOKENS,
                'system' => $system_message,
                'messages' => [
                    ['role' => 'user', 'content' => $prompt]
                ]
            ]);
            
            $this->rate_limiter->record_request();
            return $response->content[0]->text;
            
        } catch (Exception $e) {
            error_log('Claude API Error: ' . $e->getMessage());
            return new WP_Error('api_error', $e->getMessage());
        }
    }
}

add_action('woocommerce_new_product', 'generate_ai_product_description', 10, 1);
add_action('woocommerce_update_product', 'maybe_regenerate_description', 10, 1);

function generate_ai_product_description($product_id) {
    $product = wc_get_product($product_id);
    
    // Skip if description already exists and isn't marked for regeneration
    if (!empty($product->get_description()) && !get_post_meta($product_id, '_regenerate_description', true)) {
        return;
    }
    
    $claude = new WooClaudeIntegration();
    
    $product_data = [
        'title' => $product->get_title(),
        'short_description' => $product->get_short_description(),
        'categories' => wp_get_post_terms($product_id, 'product_cat', ['fields' => 'names']),
        'attributes' => $product->get_attributes(),
        'price' => $product->get_price()
    ];
    
    $system_message = "You are a professional e-commerce copywriter. Generate compelling product descriptions that highlight benefits, address customer pain points, and include relevant keywords for SEO. Keep descriptions between 150-250 words.";
    
    $prompt = generate_description_prompt($product_data);
    $description = $claude->generate_content($prompt, $system_message);
    
    if (!is_wp_error($description)) {
        wp_update_post([
            'ID' => $product_id,
            'post_content' => $description
        ]);
        
        // Remove regeneration flag
        delete_post_meta($product_id, '_regenerate_description');
        
        // Cache the generated description for prompt optimization
        cache_generated_content($product_id, $description, $prompt);
    }
}

function generate_description_prompt($product_data) {
    $prompt = "Product Title: {$product_data['title']}\n";
    
    if (!empty($product_data['short_description'])) {
        $prompt .= "Brief Description: {$product_data['short_description']}\n";
    }
    
    if (!empty($product_data['categories'])) {
        $prompt .= "Categories: " . implode(', ', $product_data['categories']) . "\n";
    }
    
    if (!empty($product_data['price'])) {
        $prompt .= "Price: $" . $product_data['price'] . "\n";
    }
    
    $prompt .= "\nGenerate a compelling product description that converts browsers into buyers.";
    
    return $prompt;
}

// Hook into WooCommerce email system
add_filter('woocommerce_email_recipient_customer_note', 'intercept_customer_emails', 10, 2);

function intercept_customer_emails($recipient, $order) {
    // Only process if AI customer service is enabled
    if (!get_option('enable_ai_customer_service', false)) {
        return $recipient;
    }
    
    $customer_inquiry = get_last_customer_message($order->get_id());
    
    if ($customer_inquiry && should_auto_respond($customer_inquiry)) {
        $ai_response = generate_customer_service_response($order, $customer_inquiry);
        
        if (!is_wp_error($ai_response)) {
            send_ai_customer_response($order, $ai_response);
            log_ai_interaction($order->get_id(), $customer_inquiry, $ai_response);
            
            // Prevent original email from sending
            return '';
        }
    }
    
    return $recipient;
}

function generate_customer_service_response($order, $inquiry) {
    $claude = new WooClaudeIntegration();
    
    $order_data = [
        'order_number' => $order->get_order_number(),
        'status' => $order->get_status(),
        'items' => get_order_items_summary($order),
        'shipping' => get_shipping_info($order),
        'total' => $order->get_total()
    ];
    
    $system_message = "You are a helpful customer service representative for an e-commerce store. Provide accurate, empathetic responses based on order information. If you cannot answer a question definitively, suggest contacting human support.";
    
    $prompt = build_customer_service_prompt($order_data, $inquiry);
    
    return $claude->generate_content($prompt, $system_message);
}

function should_auto_respond($inquiry) {
    $auto_respond_keywords = [
        'order status', 'shipping', 'tracking', 'delivery',
        'when will', 'where is', 'cancel order', 'return'
    ];
    
    $inquiry_lower = strtolower($inquiry);
    
    foreach ($auto_respond_keywords as $keyword) {
        if (strpos($inquiry_lower, $keyword) !== false) {
            return true;
        }
    }
    
    return false;
}

// Add analytics to WooCommerce dashboard
add_action('woocommerce_admin_dashboard_setup', 'add_ai_analytics_widget');

function add_ai_analytics_widget() {
    wp_add_dashboard_widget(
        'woocommerce_ai_insights',
        'AI Sales Insights',
        'render_ai_analytics_widget'
    );
}

function render_ai_analytics_widget() {
    $insights = get_cached_ai_insights();
    
    if (!$insights || is_insights_cache_expired()) {
        $insights = generate_fresh_insights();
        cache_ai_insights($insights);
    }
    
    echo '<div class="ai-insights-widget">';
    echo '<h4>Key Insights</h4>';
    echo '<ul>';
    
    foreach ($insights as $insight) {
        echo '<li>' . esc_html($insight) . '</li>';
    }
    
    echo '</ul>';
    echo '<p><a href="' . admin_url('admin.php?page=ai-detailed-analytics') . '">View Detailed Analysis</a></p>';
    echo '</div>';
}

function generate_fresh_insights() {
    $claude = new WooClaudeIntegration();
    
    $analytics_data = [
        'sales_trend' => get_sales_trend_data(),
        'top_products' => get_top_performing_products(),
        'customer_behavior' => get_customer_behavior_metrics(),
        'inventory_levels' => get_low_stock_items()
    ];
    
    $system_message = "You are a business intelligence analyst. Analyze e-commerce data and provide 3-5 actionable insights. Focus on revenue opportunities, inventory optimization, and customer retention strategies.";
    
    $prompt = format_analytics_prompt($analytics_data);
    $raw_insights = $claude->generate_content($prompt, $system_message);
    
    return parse_insights_response($raw_insights);
}

function format_analytics_prompt($data) {
    $prompt = "Analyze this e-commerce performance data:\n\n";
    
    $prompt .= "Sales Trend (last 30 days): " . json_encode($data['sales_trend']) . "\n";
    $prompt .= "Top Products: " . json_encode($data['top_products']) . "\n";
    $prompt .= "Customer Metrics: " . json_encode($data['customer_behavior']) . "\n";
    $prompt .= "Low Stock Items: " . json_encode($data['inventory_levels']) . "\n";
    
    $prompt .= "\nProvide specific, actionable recommendations to improve sales and operations.";
    
    return $prompt;
}

class ClaudeRateLimiter {
    private $redis;
    private $rate_limits = [
        'product_descriptions' => ['limit' => 100, 'window' => 3600],
        'customer_service' => ['limit' => 500, 'window' => 3600],
        'analytics' => ['limit' => 48, 'window' => 3600]
    ];
    
    public function __construct() {
        $this->redis = new Redis();
        $this->redis->connect('127.0.0.1', 6379);
    }
    
    public function can_make_request($category) {
        $key = "claude_rate_limit:{$category}:" . date('H');
        $current = $this->redis->get($key) ?: 0;
        
        if ($current >= $this->rate_limits[$category]['limit']) {
            return false;
        }
        
        $this->redis->incr($key);
        $this->redis->expire($key, $this->rate_limits[$category]['window']);
        
        return true;
    }
}

// Implement prompt caching for repeated requests
function get_cached_prompt_response($prompt_hash) {
    return get_transient("claude_cache_{$prompt_hash}");
}

function cache_prompt_response($prompt, $response) {
    $prompt_hash = md5($prompt);
    set_transient("claude_cache_{$prompt_hash}", $response, 24 * HOUR_IN_SECONDS);
}

// Configure WP-Cron for background AI processing
add_action('wp_loaded', 'schedule_ai_background_tasks');

function schedule_ai_background_tasks() {
    if (!wp_next_scheduled('process_ai_description_queue')) {