claude-flow-novice 2.18.5 → 2.18.6

package/.claude/cfn-extras/skills/marketing/cfn-marketing-sms-campaigns/operations/create-campaign.sh

@@ -0,0 +1,183 @@
+#!/bin/bash
+# CFN Marketing SMS Campaigns - Create Campaign Operation
+# Version: 1.0.0
+# Purpose: Create SMS campaign configuration
+
+set -euo pipefail
+
+# Parse arguments
+NAME=""
+MESSAGE=""
+AUDIENCE="{}"
+SENDER_ID="${SMS_SENDER_ID:-CFN Marketing}"
+SCHEDULE=""
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --name)
+      NAME="$2"
+      shift 2
+      ;;
+    --message)
+      MESSAGE="$2"
+      shift 2
+      ;;
+    --audience)
+      AUDIENCE="$2"
+      shift 2
+      ;;
+    --sender-id)
+      SENDER_ID="$2"
+      shift 2
+      ;;
+    --schedule)
+      SCHEDULE="$2"
+      shift 2
+      ;;
+    *)
+      echo '{"error": "Unknown parameter: '$1'", "code": "INVALID_PARAMETER"}' >&2
+      exit 1
+      ;;
+  esac
+done
+
+# Validate required parameters
+if [[ -z "$NAME" ]]; then
+  echo '{"error": "Missing required parameter: --name", "code": "MISSING_PARAMETER"}' >&2
+  exit 1
+fi
+
+if [[ -z "$MESSAGE" ]]; then
+  echo '{"error": "Missing required parameter: --message", "code": "MISSING_PARAMETER"}' >&2
+  exit 1
+fi
+
+if [[ -z "$AUDIENCE" || "$AUDIENCE" == "{}" ]]; then
+  echo '{"error": "Missing required parameter: --audience", "code": "MISSING_PARAMETER"}' >&2
+  exit 1
+fi
+
+# Validate message length
+if [[ ${#MESSAGE} -gt 160 ]]; then
+  echo '{"error": "Message too long. Maximum 160 characters", "code": "MESSAGE_TOO_LONG", "length": '${#MESSAGE}'}' >&2
+  exit 1
+fi
+
+# Ensure opt-out instructions included (TCPA requirement)
+if ! echo "$MESSAGE" | grep -qiE 'STOP|opt.*out|unsubscribe'; then
+  echo '{"error": "Message must include opt-out instructions (TCPA requirement)", "code": "MISSING_OPT_OUT", "severity": "critical"}' >&2
+  exit 3
+fi
+
+# Validate audience JSON
+if ! echo "$AUDIENCE" | jq empty 2>/dev/null; then
+  echo '{"error": "Invalid audience JSON format", "code": "INVALID_AUDIENCE"}' >&2
+  exit 1
+fi
+
+# Validate environment variables
+if [[ -z "${N8N_BASE_URL:-}" ]]; then
+  echo '{"error": "Environment variable N8N_BASE_URL not set", "code": "MISSING_ENV_VAR"}' >&2
+  exit 2
+fi
+
+if [[ -z "${N8N_API_KEY:-}" ]]; then
+  echo '{"error": "Environment variable N8N_API_KEY not set", "code": "MISSING_ENV_VAR"}' >&2
+  exit 2
+fi
+
+# CRITICAL: TCPA Compliance - Verify audience excludes opted-out numbers
+EXCLUDE_SEGMENTS=$(echo "$AUDIENCE" | jq -r '.exclude_segments // [] | @json' 2>/dev/null || echo "[]")
+if ! echo "$EXCLUDE_SEGMENTS" | grep -q "opted_out"; then
+  echo '{"error": "Audience must explicitly exclude opted_out segment (TCPA requirement)", "code": "MISSING_EXCLUSION", "severity": "critical"}' >&2
+  exit 3
+fi
+
+if ! echo "$EXCLUDE_SEGMENTS" | grep -q "dnc"; then
+  echo '{"error": "Audience must explicitly exclude dnc segment (TCPA requirement)", "code": "MISSING_EXCLUSION", "severity": "critical"}' >&2
+  exit 3
+fi
+
+# Generate campaign ID
+CAMPAIGN_ID="camp_$(date +%s)_$(shuf -i 10000-99999 -n 1)"
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+# Prepare request payload
+PAYLOAD=$(jq -n \
+  --arg campaign_id "$CAMPAIGN_ID" \
+  --arg name "$NAME" \
+  --arg message "$MESSAGE" \
+  --argjson audience "$AUDIENCE" \
+  --arg sender_id "$SENDER_ID" \
+  --arg schedule "$SCHEDULE" \
+  --arg timestamp "$TIMESTAMP" \
+  '{
+    campaign_id: $campaign_id,
+    name: $name,
+    message: $message,
+    audience: $audience,
+    sender_id: $sender_id,
+    schedule: $schedule,
+    created_at: $timestamp,
+    status: "draft",
+    compliance_verified: true
+  }')
+
+# Create campaign via n8n webhook
+RESPONSE=$(curl -s -w "\n%{http_code}" \
+  -X POST \
+  -H "Content-Type: application/json" \
+  -H "X-N8N-API-KEY: ${N8N_API_KEY}" \
+  -d "$PAYLOAD" \
+  "${N8N_BASE_URL}/webhook/sms/create-campaign" 2>&1) || {
+  echo '{"error": "Network error: Failed to connect to n8n", "code": "NETWORK_ERROR"}' >&2
+  exit 2
+}
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+# Handle HTTP errors
+if [[ "$HTTP_CODE" -ge 400 ]]; then
+  if [[ "$HTTP_CODE" -eq 401 ]]; then
+    echo '{"error": "Authentication failed", "code": "AUTH_ERROR"}' >&2
+    exit 2
+  else
+    ERROR_MSG=$(echo "$BODY" | jq -r '.error // "Unknown API error"' 2>/dev/null || echo "Unknown API error")
+    echo '{"error": "'"$ERROR_MSG"'", "code": "API_ERROR", "http_code": '$HTTP_CODE'}' >&2
+    exit 2
+  fi
+fi
+
+# Parse response
+if ! echo "$BODY" | jq empty 2>/dev/null; then
+  echo '{"error": "Invalid JSON response from API", "code": "INVALID_RESPONSE"}' >&2
+  exit 2
+fi
+
+# Store campaign metadata in Redis
+if command -v redis-cli &> /dev/null; then
+  redis-cli HMSET "sms:campaign:${CAMPAIGN_ID}" \
+    name "$NAME" \
+    message "$MESSAGE" \
+    created_at "$TIMESTAMP" \
+    status "draft" \
+    > /dev/null 2>&1 || true
+  redis-cli EXPIRE "sms:campaign:${CAMPAIGN_ID}" 2592000 > /dev/null 2>&1 || true
+fi
+
+# Return success response
+echo "$BODY" | jq \
+  --arg campaign_id "$CAMPAIGN_ID" \
+  --arg name "$NAME" \
+  --arg timestamp "$TIMESTAMP" \
+  '{
+    campaign_id: ($campaign_id),
+    name: $name,
+    status: (.status // "draft"),
+    created_at: $timestamp,
+    estimated_recipients: (.estimated_recipients // 0),
+    compliance_cleared: true
+  }'
+
+exit 0

package/.claude/cfn-extras/skills/marketing/cfn-marketing-sms-campaigns/operations/get-delivery-status.sh

@@ -0,0 +1,139 @@
+#!/bin/bash
+# CFN Marketing SMS Campaigns - Get Delivery Status Operation
+# Version: 1.0.0
+# Purpose: Check SMS delivery status
+
+set -euo pipefail
+
+# Parse arguments
+MESSAGE_ID=""
+PHONE=""
+CAMPAIGN_ID=""
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --message-id)
+      MESSAGE_ID="$2"
+      shift 2
+      ;;
+    --phone)
+      PHONE="$2"
+      shift 2
+      ;;
+    --campaign-id)
+      CAMPAIGN_ID="$2"
+      shift 2
+      ;;
+    *)
+      echo '{"error": "Unknown parameter: '$1'", "code": "INVALID_PARAMETER"}' >&2
+      exit 1
+      ;;
+  esac
+done
+
+# Validate required parameters (at least one must be provided)
+if [[ -z "$MESSAGE_ID" && -z "$PHONE" && -z "$CAMPAIGN_ID" ]]; then
+  echo '{"error": "Missing required parameter: --message-id, --phone, or --campaign-id", "code": "MISSING_PARAMETER"}' >&2
+  exit 1
+fi
+
+# Validate phone format if provided
+if [[ -n "$PHONE" ]] && ! echo "$PHONE" | grep -qE '^\+[1-9][0-9]{1,14}$'; then
+  echo '{"error": "Invalid phone format. Use E.164 format (+1XXXXXXXXXX)", "code": "INVALID_PHONE"}' >&2
+  exit 1
+fi
+
+# Validate environment variables
+if [[ -z "${N8N_BASE_URL:-}" ]]; then
+  echo '{"error": "Environment variable N8N_BASE_URL not set", "code": "MISSING_ENV_VAR"}' >&2
+  exit 2
+fi
+
+if [[ -z "${N8N_API_KEY:-}" ]]; then
+  echo '{"error": "Environment variable N8N_API_KEY not set", "code": "MISSING_ENV_VAR"}' >&2
+  exit 2
+fi
+
+# Build query parameters
+QUERY_PARAMS=""
+if [[ -n "$MESSAGE_ID" ]]; then
+  QUERY_PARAMS="message_id=${MESSAGE_ID}"
+fi
+
+if [[ -n "$PHONE" ]]; then
+  if [[ -n "$QUERY_PARAMS" ]]; then
+    QUERY_PARAMS="${QUERY_PARAMS}&phone=${PHONE}"
+  else
+    QUERY_PARAMS="phone=${PHONE}"
+  fi
+fi
+
+if [[ -n "$CAMPAIGN_ID" ]]; then
+  if [[ -n "$QUERY_PARAMS" ]]; then
+    QUERY_PARAMS="${QUERY_PARAMS}&campaign_id=${CAMPAIGN_ID}"
+  else
+    QUERY_PARAMS="campaign_id=${CAMPAIGN_ID}"
+  fi
+fi
+
+# Get delivery status via n8n webhook
+RESPONSE=$(curl -s -w "\n%{http_code}" \
+  -X GET \
+  -H "X-N8N-API-KEY: ${N8N_API_KEY}" \
+  "${N8N_BASE_URL}/webhook/sms/delivery-status?${QUERY_PARAMS}" 2>&1) || {
+  echo '{"error": "Network error: Failed to connect to n8n", "code": "NETWORK_ERROR"}' >&2
+  exit 2
+}
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+# Handle HTTP errors
+if [[ "$HTTP_CODE" -ge 400 ]]; then
+  if [[ "$HTTP_CODE" -eq 404 ]]; then
+    echo '{"error": "Message not found", "code": "MESSAGE_NOT_FOUND", "message_id": "'"$MESSAGE_ID"'"}' >&2
+    exit 3
+  elif [[ "$HTTP_CODE" -eq 401 ]]; then
+    echo '{"error": "Authentication failed", "code": "AUTH_ERROR"}' >&2
+    exit 2
+  else
+    ERROR_MSG=$(echo "$BODY" | jq -r '.error // "Unknown API error"' 2>/dev/null || echo "Unknown API error")
+    echo '{"error": "'"$ERROR_MSG"'", "code": "API_ERROR", "http_code": '$HTTP_CODE'}' >&2
+    exit 2
+  fi
+fi
+
+# Parse response
+if ! echo "$BODY" | jq empty 2>/dev/null; then
+  echo '{"error": "Invalid JSON response from API", "code": "INVALID_RESPONSE"}' >&2
+  exit 2
+fi
+
+# Handle bulk status (campaign-level)
+if [[ -n "$CAMPAIGN_ID" ]]; then
+  echo "$BODY" | jq \
+    --arg campaign_id "$CAMPAIGN_ID" \
+    '{
+      campaign_id: $campaign_id,
+      total_messages: (.total_messages // 0),
+      delivered: (.delivered // 0),
+      failed: (.failed // 0),
+      pending: (.pending // 0),
+      delivery_rate: (.delivery_rate // 0),
+      messages: (.messages // [])
+    }'
+else
+  # Handle single message status
+  echo "$BODY" | jq \
+    --arg message_id "$MESSAGE_ID" \
+    '{
+      message_id: ($message_id),
+      phone: (.phone // ""),
+      status: (.status // "unknown"),
+      delivered_at: (.delivered_at // null),
+      carrier: (.carrier // "unknown"),
+      error: (.error // null)
+    }'
+fi
+
+exit 0

package/.claude/cfn-extras/skills/marketing/cfn-marketing-sms-campaigns/operations/opt-out.sh

@@ -0,0 +1,150 @@
+#!/bin/bash
+# CFN Marketing SMS Campaigns - Opt-Out Operation
+# Version: 1.0.0
+# Purpose: Process opt-out request (CRITICAL - must execute within seconds)
+
+set -euo pipefail
+
+# Parse arguments
+PHONE=""
+SOURCE="manual"
+REASON=""
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --phone)
+      PHONE="$2"
+      shift 2
+      ;;
+    --source)
+      SOURCE="$2"
+      shift 2
+      ;;
+    --reason)
+      REASON="$2"
+      shift 2
+      ;;
+    *)
+      echo '{"error": "Unknown parameter: '$1'", "code": "INVALID_PARAMETER"}' >&2
+      exit 1
+      ;;
+  esac
+done
+
+# Validate required parameters
+if [[ -z "$PHONE" ]]; then
+  echo '{"error": "Missing required parameter: --phone", "code": "MISSING_PARAMETER"}' >&2
+  exit 1
+fi
+
+# Validate phone format (E.164: +1XXXXXXXXXX)
+if ! echo "$PHONE" | grep -qE '^\+[1-9][0-9]{1,14}$'; then
+  echo '{"error": "Invalid phone format. Use E.164 format (+1XXXXXXXXXX)", "code": "INVALID_PHONE"}' >&2
+  exit 1
+fi
+
+# Validate source
+if [[ "$SOURCE" != "inbound_sms" && "$SOURCE" != "web" && "$SOURCE" != "manual" ]]; then
+  echo '{"error": "Invalid source. Must be inbound_sms, web, or manual", "code": "INVALID_SOURCE"}' >&2
+  exit 1
+fi
+
+# Check if already opted out
+if command -v redis-cli &> /dev/null; then
+  CURRENT_OPT_IN=$(redis-cli GET "sms:opt_in:$PHONE" 2>/dev/null || echo "")
+  if [[ "$CURRENT_OPT_IN" == "false" ]]; then
+    OPTED_OUT_AT=$(redis-cli HGET "sms:opt_out:$PHONE" "opted_out_at" 2>/dev/null || echo "")
+    echo '{"error": "Phone number already opted out", "code": "ALREADY_OPTED_OUT", "phone": "'"$PHONE"'", "opted_out_at": "'"$OPTED_OUT_AT"'"}' >&2
+    exit 3
+  fi
+else
+  echo '{"error": "Redis not available for opt-out processing", "code": "REDIS_UNAVAILABLE"}' >&2
+  exit 2
+fi
+
+# Generate timestamp
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+# CRITICAL: TCPA Compliance - Immediate opt-out processing
+# Step 1: Update opt-in status (blocks all future sends)
+redis-cli SET "sms:opt_in:$PHONE" "false" > /dev/null 2>&1 || {
+  echo '{"error": "Failed to update opt-in status", "code": "REDIS_ERROR"}' >&2
+  exit 2
+}
+
+# Step 2: Add to Do Not Call registry
+redis-cli SET "sms:dnc:$PHONE" "true" > /dev/null 2>&1 || {
+  echo '{"error": "Failed to update DNC registry", "code": "REDIS_ERROR"}' >&2
+  exit 2
+}
+
+# Step 3: Add to global opt-out set
+redis-cli SADD "sms:global_opt_out" "$PHONE" > /dev/null 2>&1 || {
+  echo '{"error": "Failed to add to global opt-out set", "code": "REDIS_ERROR"}' >&2
+  exit 2
+}
+
+# Step 4: Store detailed opt-out metadata
+redis-cli HMSET "sms:opt_out:$PHONE" \
+  phone "$PHONE" \
+  opted_out_at "$TIMESTAMP" \
+  source "$SOURCE" \
+  reason "$REASON" \
+  > /dev/null 2>&1 || true
+
+redis-cli EXPIRE "sms:opt_out:$PHONE" 31536000 > /dev/null 2>&1 || true  # 1 year retention
+
+# Step 5: Cancel any pending messages for this phone number
+redis-cli SADD "sms:cancelled_recipients" "$PHONE" > /dev/null 2>&1 || true
+
+# Validate environment variables for confirmation message
+CONFIRMATION_SENT=false
+if [[ -n "${N8N_BASE_URL:-}" && -n "${N8N_API_KEY:-}" ]]; then
+  # Prepare confirmation payload
+  CONFIRMATION_MESSAGE="You have been unsubscribed. No further messages will be sent."
+
+  PAYLOAD=$(jq -n \
+    --arg phone "$PHONE" \
+    --arg message "$CONFIRMATION_MESSAGE" \
+    --arg opted_out_at "$TIMESTAMP" \
+    --arg source "$SOURCE" \
+    '{
+      phone: $phone,
+      message: $message,
+      opted_out_at: $opted_out_at,
+      source: $source,
+      type: "opt_out_confirmation"
+    }')
+
+  # Send confirmation and persist to database (async, non-blocking)
+  curl -s -X POST \
+    -H "Content-Type: application/json" \
+    -H "X-N8N-API-KEY: ${N8N_API_KEY}" \
+    -d "$PAYLOAD" \
+    "${N8N_BASE_URL}/webhook/sms/opt-out" > /dev/null 2>&1 &
+
+  CONFIRMATION_SENT=true
+fi
+
+# Log opt-out for audit trail
+redis-cli LPUSH "sms:opt_out_log" "$PHONE:$TIMESTAMP:$SOURCE" > /dev/null 2>&1 || true
+redis-cli LTRIM "sms:opt_out_log" 0 9999 > /dev/null 2>&1 || true
+
+# Return success response
+jq -n \
+  --arg phone "$PHONE" \
+  --argjson opted_out "true" \
+  --arg opted_out_at "$TIMESTAMP" \
+  --arg source "$SOURCE" \
+  --argjson confirmation_sent "$CONFIRMATION_SENT" \
+  --arg message "You have been unsubscribed. No further messages will be sent." \
+  '{
+    phone: $phone,
+    opted_out: $opted_out,
+    opted_out_at: $opted_out_at,
+    source: $source,
+    confirmation_sent: $confirmation_sent,
+    message: $message
+  }'
+
+exit 0

package/.claude/cfn-extras/skills/marketing/cfn-marketing-sms-campaigns/operations/schedule-campaign.sh

@@ -0,0 +1,187 @@
+#!/bin/bash
+# CFN Marketing SMS Campaigns - Schedule Campaign Operation
+# Version: 1.0.0
+# Purpose: Schedule bulk SMS campaign
+
+set -euo pipefail
+
+# Parse arguments
+CAMPAIGN_ID=""
+SCHEDULE_TIME=""
+TIMEZONE=""
+BATCH_SIZE=100
+BATCH_DELAY=60
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --campaign-id)
+      CAMPAIGN_ID="$2"
+      shift 2
+      ;;
+    --schedule-time)
+      SCHEDULE_TIME="$2"
+      shift 2
+      ;;
+    --timezone)
+      TIMEZONE="$2"
+      shift 2
+      ;;
+    --batch-size)
+      BATCH_SIZE="$2"
+      shift 2
+      ;;
+    --batch-delay)
+      BATCH_DELAY="$2"
+      shift 2
+      ;;
+    *)
+      echo '{"error": "Unknown parameter: '$1'", "code": "INVALID_PARAMETER"}' >&2
+      exit 1
+      ;;
+  esac
+done
+
+# Validate required parameters
+if [[ -z "$CAMPAIGN_ID" ]]; then
+  echo '{"error": "Missing required parameter: --campaign-id", "code": "MISSING_PARAMETER"}' >&2
+  exit 1
+fi
+
+if [[ -z "$SCHEDULE_TIME" ]]; then
+  echo '{"error": "Missing required parameter: --schedule-time", "code": "MISSING_PARAMETER"}' >&2
+  exit 1
+fi
+
+if [[ -z "$TIMEZONE" ]]; then
+  echo '{"error": "Missing required parameter: --timezone", "code": "MISSING_PARAMETER"}' >&2
+  exit 1
+fi
+
+# Validate ISO 8601 date format
+if ! echo "$SCHEDULE_TIME" | grep -qE '^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}'; then
+  echo '{"error": "Invalid date format. Use ISO 8601 (YYYY-MM-DDTHH:MM:SS)", "code": "INVALID_DATE"}' >&2
+  exit 1
+fi
+
+# Validate batch size
+if ! [[ "$BATCH_SIZE" =~ ^[0-9]+$ ]] || [[ "$BATCH_SIZE" -lt 1 ]] || [[ "$BATCH_SIZE" -gt 1000 ]]; then
+  echo '{"error": "Invalid batch size. Must be between 1 and 1000", "code": "INVALID_BATCH_SIZE"}' >&2
+  exit 1
+fi
+
+# Validate batch delay
+if ! [[ "$BATCH_DELAY" =~ ^[0-9]+$ ]] || [[ "$BATCH_DELAY" -lt 1 ]]; then
+  echo '{"error": "Invalid batch delay. Must be >= 1 second", "code": "INVALID_BATCH_DELAY"}' >&2
+  exit 1
+fi
+
+# Validate environment variables
+if [[ -z "${N8N_BASE_URL:-}" ]]; then
+  echo '{"error": "Environment variable N8N_BASE_URL not set", "code": "MISSING_ENV_VAR"}' >&2
+  exit 2
+fi
+
+if [[ -z "${N8N_API_KEY:-}" ]]; then
+  echo '{"error": "Environment variable N8N_API_KEY not set", "code": "MISSING_ENV_VAR"}' >&2
+  exit 2
+fi
+
+# CRITICAL: TCPA Compliance - Validate time restrictions
+# Extract hour from schedule time and validate against 8 AM - 9 PM
+SCHEDULE_HOUR=$(echo "$SCHEDULE_TIME" | grep -oP '\d{2}(?=:)' | head -1)
+if [[ "$SCHEDULE_HOUR" -lt 8 ]] || [[ "$SCHEDULE_HOUR" -ge 21 ]]; then
+  echo '{"error": "Schedule time violates TCPA time restrictions (8 AM - 9 PM)", "code": "TIME_RESTRICTION", "scheduled_hour": '$SCHEDULE_HOUR', "severity": "critical"}' >&2
+  exit 3
+fi
+
+# Verify campaign exists
+if command -v redis-cli &> /dev/null; then
+  CAMPAIGN_EXISTS=$(redis-cli EXISTS "sms:campaign:${CAMPAIGN_ID}" 2>/dev/null || echo "0")
+  if [[ "$CAMPAIGN_EXISTS" -eq 0 ]]; then
+    echo '{"error": "Campaign not found", "code": "CAMPAIGN_NOT_FOUND", "campaign_id": "'"$CAMPAIGN_ID"'"}' >&2
+    exit 3
+  fi
+fi
+
+# Prepare request payload
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+PAYLOAD=$(jq -n \
+  --arg campaign_id "$CAMPAIGN_ID" \
+  --arg schedule_time "$SCHEDULE_TIME" \
+  --arg timezone "$TIMEZONE" \
+  --arg batch_size "$BATCH_SIZE" \
+  --arg batch_delay "$BATCH_DELAY" \
+  --arg timestamp "$TIMESTAMP" \
+  '{
+    campaign_id: $campaign_id,
+    schedule_time: $schedule_time,
+    timezone: $timezone,
+    batch_size: ($batch_size | tonumber),
+    batch_delay: ($batch_delay | tonumber),
+    scheduled_at: $timestamp,
+    compliance_verified: true
+  }')
+
+# Schedule campaign via n8n webhook
+RESPONSE=$(curl -s -w "\n%{http_code}" \
+  -X POST \
+  -H "Content-Type: application/json" \
+  -H "X-N8N-API-KEY: ${N8N_API_KEY}" \
+  -d "$PAYLOAD" \
+  "${N8N_BASE_URL}/webhook/sms/schedule-campaign" 2>&1) || {
+  echo '{"error": "Network error: Failed to connect to n8n", "code": "NETWORK_ERROR"}' >&2
+  exit 2
+}
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+# Handle HTTP errors
+if [[ "$HTTP_CODE" -ge 400 ]]; then
+  if [[ "$HTTP_CODE" -eq 404 ]]; then
+    echo '{"error": "Campaign not found", "code": "CAMPAIGN_NOT_FOUND", "campaign_id": "'"$CAMPAIGN_ID"'"}' >&2
+    exit 3
+  elif [[ "$HTTP_CODE" -eq 401 ]]; then
+    echo '{"error": "Authentication failed", "code": "AUTH_ERROR"}' >&2
+    exit 2
+  else
+    ERROR_MSG=$(echo "$BODY" | jq -r '.error // "Unknown API error"' 2>/dev/null || echo "Unknown API error")
+    echo '{"error": "'"$ERROR_MSG"'", "code": "API_ERROR", "http_code": '$HTTP_CODE'}' >&2
+    exit 2
+  fi
+fi
+
+# Parse response
+if ! echo "$BODY" | jq empty 2>/dev/null; then
+  echo '{"error": "Invalid JSON response from API", "code": "INVALID_RESPONSE"}' >&2
+  exit 2
+fi
+
+# Update campaign status in Redis
+if command -v redis-cli &> /dev/null; then
+  redis-cli HSET "sms:campaign:${CAMPAIGN_ID}" status "scheduled" > /dev/null 2>&1 || true
+  redis-cli HSET "sms:campaign:${CAMPAIGN_ID}" scheduled_at "$SCHEDULE_TIME" > /dev/null 2>&1 || true
+fi
+
+# Calculate estimated duration
+TOTAL_RECIPIENTS=$(echo "$BODY" | jq -r '.total_recipients // 0')
+BATCH_COUNT=$(( (TOTAL_RECIPIENTS + BATCH_SIZE - 1) / BATCH_SIZE ))
+ESTIMATED_DURATION=$(( BATCH_COUNT * BATCH_DELAY / 60 ))
+
+# Return success response
+echo "$BODY" | jq \
+  --arg campaign_id "$CAMPAIGN_ID" \
+  --arg scheduled_at "$SCHEDULE_TIME" \
+  --arg estimated_duration "$ESTIMATED_DURATION" \
+  --arg batch_count "$BATCH_COUNT" \
+  '{
+    campaign_id: ($campaign_id),
+    scheduled_at: $scheduled_at,
+    status: (.status // "scheduled"),
+    estimated_duration_minutes: ($estimated_duration | tonumber),
+    batch_count: ($batch_count | tonumber),
+    total_recipients: (.total_recipients // 0)
+  }'
+
+exit 0