SMS

// ============================================
// REQUEST
// ============================================

interface SendSingleSmsInput {
  contactId: string;      // UUID - must exist in the organization
  senderId: string;       // UUID - from GET /sender-ids/available
  messageTemplate: string; // Supports {{ $contact.* }} placeholders
}

// ============================================
// RESPONSE
// ============================================

interface SendSingleSmsResponse {
  success: boolean;
  messageId?: string;     // Provider message ID (for delivery tracking)
  smsLogId: string;       // UUID of the sms_logs record
  smsParts: number;       // Number of SMS parts (multi-part for long messages)
  encoding: 'GSM-7' | 'GSM-7 Extended' | 'UCS-2';
  error?: string;         // Error message if success=false
  creditCharged: number;  // Credits deducted (0 if send failed)
}

// ============================================
// TEMPLATE SYNTAX
// ============================================

/**
 * Message templates support {{ $contact.* }} placeholders:
 *
 * Contact fields:
 * - {{ $contact.phone }}
 * - {{ $contact.firstName }}
 * - {{ $contact.lastName }}
 * - {{ $contact.fullName }}
 * - {{ $contact.email }}
 * - {{ $contact.address }}
 * - {{ $contact.city }}
 * - {{ $contact.state }}
 * - {{ $contact.zip }}
 * - {{ $contact.occupation }}
 * - {{ $contact.gender }}
 * - {{ $contact.preferredChannel }}
 *
 * Custom attributes:
 * - {{ $contact.customAttributes.fieldName }}
 *
 * Example:
 * "Hello {{ $contact.firstName }}, your tier is {{ $contact.customAttributes.loyalty_tier }}"
 *
 * NOTE: Unlike SMS programs (which fall back to empty strings),
 * single SMS will return a 400 error if a template variable is missing.
 */