# iMessage Device Specifications

To successfully connect and use iMessage with WhatSnap, your Apple devices must meet specific minimum requirements. This guide outlines the supported devices, operating system versions, and configuration recommendations for optimal performance.

{% hint style="info" %}
**Both Devices Required**: You need both an iPhone and a Mac to use WhatSnap's iMessage integration. The Mac acts as the gateway that bridges iMessage to GoHighLevel.
{% endhint %}

## 📱 iPhone Requirements

### Minimum Operating System

**iOS Version**: **iOS 12.0 or higher** is required for WhatSnap compatibility.

{% hint style="success" %}
**Recommended**: iOS 14.0 or later for best performance, security updates, and feature compatibility.
{% endhint %}

### Supported iPhone Models

WhatSnap iMessage integration works with the following iPhone models:

#### ✅ Fully Supported & Recommended

| iPhone Model                     | Minimum iOS | Recommended |
| -------------------------------- | ----------- | ----------- |
| **iPhone 15** (All models)       | iOS 17      | ✅ Excellent |
| **iPhone 14** (All models)       | iOS 16      | ✅ Excellent |
| **iPhone 13** (All models)       | iOS 15      | ✅ Excellent |
| **iPhone 12** (All models)       | iOS 14      | ✅ Excellent |
| **iPhone 11** (All models)       | iOS 13      | ✅ Very Good |
| **iPhone XS / XS Max / XR**      | iOS 12      | ✅ Very Good |
| **iPhone X**                     | iOS 11      | ✅ Good      |
| **iPhone 8 / 8 Plus**            | iOS 11      | ✅ Good      |
| **iPhone 7 / 7 Plus**            | iOS 10      | ✅ Good      |
| **iPhone SE (2nd Gen or later)** | iOS 13      | ✅ Very Good |
| **iPhone SE (3rd Gen)**          | iOS 15      | ✅ Excellent |

#### ⚠️ Limited Support

| iPhone Model            | Maximum iOS | Status                                |
| ----------------------- | ----------- | ------------------------------------- |
| **iPhone 6s / 6s Plus** | iOS 15      | ⚠️ Minimum - Works but aging hardware |
| **iPhone SE (1st Gen)** | iOS 15      | ⚠️ Minimum - Works but aging hardware |

#### ❌ Not Recommended

| iPhone Model           | Maximum iOS  | Status                                      |
| ---------------------- | ------------ | ------------------------------------------- |
| **iPhone 6 / 6 Plus**  | iOS 12.5.7   | ❌ Not recommended - Performance limitations |
| **iPhone 5s or older** | Below iOS 12 | ❌ Not supported                             |

{% hint style="warning" %}
**iPhone 6 Limitation**: While iPhone 6 can technically run iOS 12.5.7 (meeting the minimum requirement), it's **not recommended** due to:

* Significant performance limitations
* No security updates
* Potential instability with the WhatSnap Gateway app
* Limited memory affecting message sync
  {% endhint %}

### iPhone Feature Requirements

**SMS Text Message Forwarding**:

* Ensure your iPhone model supports **SMS Text Message Forwarding** to Mac
* Some older iPhone models may have limited or no SMS forwarding capabilities
* This feature is required for sending SMS to Android users (green bubble fallback)

**Cellular Connection**:

* Active cellular plan with SMS capability
* Data connection recommended for optimal iMessage performance
* iPhone must remain online for SMS fallback to work

## 💻 Mac Requirements

### Minimum Operating System

**macOS Version**: **macOS Monterey (12.4) or later** is required.

{% hint style="success" %}
**Recommended**: macOS Ventura (13.0) or later for best performance and latest security updates.
{% endhint %}

### Supported Mac Models

WhatSnap Gateway app works with **Late 2014 or newer** Mac models:

#### ✅ Fully Supported Models

| Mac Model       | Minimum Year | macOS Support     |
| --------------- | ------------ | ----------------- |
| **Mac Studio**  | 2022+        | ✅ macOS Monterey+ |
| **Mac Mini**    | Late 2014+   | ✅ macOS Monterey+ |
| **MacBook**     | 2015+        | ✅ macOS Monterey+ |
| **MacBook Air** | Late 2014+   | ✅ macOS Monterey+ |
| **MacBook Pro** | Late 2014+   | ✅ macOS Monterey+ |
| **iMac**        | Late 2014+   | ✅ macOS Monterey+ |
| **iMac Pro**    | 2017+        | ✅ macOS Monterey+ |
| **Mac Pro**     | Late 2013+   | ✅ macOS Monterey+ |

#### Mac Model Compatibility Check

To verify your Mac's compatibility:

1. Click the **Apple menu** () → **About This Mac**
2. Check the **Year** and **Model** of your Mac
3. Verify your **macOS version** (should be Monterey 12.4 or later)
4. If needed, update to the latest compatible macOS version

{% hint style="info" %}
**Legacy Macs**: Macs older than Late 2014 cannot run macOS Monterey and are therefore not compatible with WhatSnap's iMessage integration.
{% endhint %}

## 🏆 Recommended Hardware Setup

### Best Choice: Mac Mini

{% hint style="success" %}
**Mac Mini - The Ideal Choice**: We strongly recommend using a **Mac mini** for WhatSnap iMessage integration:
{% endhint %}

**Why Mac Mini?**

✅ **Cost-Effective**

* Very affordable to purchase second-hand
* Lower power consumption than larger Macs
* Excellent value for dedicated gateway use

✅ **Compact & Space-Efficient**

* Small footprint - fits anywhere
* Minimal desk space required
* Easy to hide or place out of sight

✅ **Built for 24/7 Operation**

* Designed for always-on use
* Reliable for continuous operation
* Less prone to overheating than laptops

✅ **Headless Operation**

* Can run without monitor, keyboard, or mouse
* Access remotely via Screen Sharing
* Perfect for server room or closet placement

✅ **Power Efficiency**

* Lower electricity costs for 24/7 operation
* Fanless or quiet operation (M1/M2 models)
* Environmentally friendly

**Mac Mini Recommendations:**

| Mac Mini Model     | Year      | Best For                   | Notes                                          |
| ------------------ | --------- | -------------------------- | ---------------------------------------------- |
| **M2 Mac mini**    | 2023      | Multiple iMessage accounts | Excellent performance, silent, power-efficient |
| **M1 Mac mini**    | 2020      | Multiple iMessage accounts | Great performance, affordable used market      |
| **Intel Mac mini** | 2018-2020 | Single account             | Good budget option, runs warmer                |
| **Intel Mac mini** | 2014-2018 | Budget single account      | Minimum viable, ensure adequate cooling        |

### Alternative Mac Options

**MacBook Series:**

* ✅ Good for: Testing, development, temporary setups
* ⚠️ Considerations:
  * Battery degradation from always being plugged in
  * Higher cost than Mac mini
  * Wasted screen/keyboard/trackpad for server use
  * Less ideal for 24/7 operation

**iMac:**

* ✅ Good for: Dual-purpose (desktop use + WhatSnap gateway)
* ⚠️ Considerations:
  * Higher power consumption
  * Requires dedicated space
  * Screen runs when not needed
  * More expensive than dedicated Mac mini

**Mac Studio / Mac Pro:**

* ✅ Good for: High-volume, multiple accounts (4+ iPhones)
* ⚠️ Considerations:
  * Overkill for most use cases
  * Significantly more expensive
  * Higher power consumption

## 🔋 Hardware Specifications Recommendations

### Memory (RAM) Requirements

| Number of iPhones | Minimum RAM | Recommended RAM | Notes                         |
| ----------------- | ----------- | --------------- | ----------------------------- |
| **1 iPhone**      | 8 GB        | 8 GB            | Sufficient for single account |
| **2 iPhones**     | 8 GB        | 16 GB           | Good performance              |
| **3-4 iPhones**   | 16 GB       | 16-32 GB        | Multiple user profiles        |
| **5+ iPhones**    | 32 GB       | 32 GB+          | Advanced multi-account setup  |

{% hint style="warning" %}
**Memory Matters**: The number of iPhones you can connect to one Mac depends heavily on available memory (RAM). Each iMessage account running in a separate user profile consumes system resources.
{% endhint %}

### Storage Requirements

* **Minimum**: 128 GB SSD
* **Recommended**: 256 GB SSD or larger
* **Notes**: iMessage can accumulate media over time; adequate storage prevents issues

### Network Requirements

* **Wired Ethernet**: Strongly recommended for stability
* **WiFi**: Acceptable but less reliable for 24/7 operation
* **Internet Speed**:
  * Minimum: 10 Mbps down / 5 Mbps up
  * Recommended: 25+ Mbps down / 10+ Mbps up
* **Stable Connection**: Critical for message delivery and sync

## 🔢 Multiple iPhone Setup (Advanced)

### Running Multiple iMessage Accounts on One Mac

WhatSnap supports connecting **multiple iPhones to a single Mac** by using separate macOS user profiles.

{% stepper %}
{% step %}

#### Create Separate User Profiles

For each iPhone/iMessage account:

1. Go to **System Settings** → **Users & Groups**
2. Click the **"+"** button to add a new user
3. Create a **Standard** user account (one per iPhone)
4. Give each account a descriptive name (e.g., "iPhone-Sales", "iPhone-Support")
   {% endstep %}

{% step %}

#### Install WhatSnap Gateway Per Profile

1. **Log in to the first user profile**
2. Install and authenticate **WhatSnap Gateway app**
3. Connect the first iPhone's iMessage
4. **Keep the app running**
5. **Switch user** (don't log out) to the next profile
6. Repeat for each iPhone

{% hint style="warning" %}
**Critical**: Use **"Switch User"** (not "Log Out"). All user profiles must remain logged in simultaneously for their respective gateway apps to continue running in the background.
{% endhint %}
{% endstep %}

{% step %}

#### Configure Fast User Switching

Enable fast user switching for easy profile management:

1. Go to **System Settings** → **Control Center**
2. Find **"Fast User Switching"**
3. Set to **"Show in Control Center"** or **"Show in Menu Bar"**
4. Click the user icon in menu bar to switch between profiles quickly
   {% endstep %}
   {% endstepper %}

### Multiple iPhone Limitations & Recommendations

{% hint style="danger" %}
**Important Limits**:

* **Maximum 4 iPhones per Mac** recommended to reduce risk of being flagged by Apple
* More accounts = higher resource usage = potential instability
* Each account must maintain Apple's 50 contacts/day guideline
  {% endhint %}

**Multi-Account Best Practices:**

✅ **Do:**

* Use adequate RAM (16-32 GB for multiple accounts)
* Monitor system resources regularly
* Keep all profiles logged in simultaneously
* Assign each account to different GHL sub-accounts or purposes
* Use Mac mini with proper cooling

❌ **Don't:**

* Exceed 4 iPhones on a single Mac
* Log out of user profiles (use Fast User Switching instead)
* Use underpowered Macs for multiple accounts
* Mix personal and business accounts on same Mac
* Neglect system maintenance and updates

### Resource Monitoring

**Check System Resources:**

* Open **Activity Monitor**
* Monitor **Memory Pressure** (should stay green)
* Check **CPU usage** (should be reasonable)
* Watch for thermal throttling on Intel Macs

## ⚙️ Power & Reliability Configuration

### Preventing Sleep Mode

The **WhatSnap Gateway app** automatically prevents your Mac from sleeping. However, proper configuration ensures reliability:

{% stepper %}
{% step %}

#### Configure Energy Settings

**For Mac mini / Desktop Macs:**

1. Open **System Settings** → **Energy** (or **Battery**)
2. **For "Power Adapter"** (or main settings):
   * Set **"Prevent automatic sleeping on power adapter when display is off"** to **ON**
   * Or set **"Turn display off after"** to a longer duration
   * Disable **"Put hard disks to sleep when possible"**
3. **Disable Power Nap** (can interfere with gateway operation)

**For MacBooks:**

1. Open **System Settings** → **Battery**
2. Under **"Power Adapter"** tab:
   * Check **"Prevent automatic sleeping when display is off"**
   * Uncheck **"Enable Power Nap"**
3. Keep MacBook **always plugged in**
   {% endstep %}

{% step %}

#### Enable Auto-Restart After Power Failure

Ensure your Mac reboots automatically after power outages:

1. Open **System Settings** → **Energy Saver** (or **Battery**)
2. Check **"Start up automatically after a power failure"**
3. This ensures 24/7 operation resumes after power loss

**Additional Protection:**

* Consider using a **UPS (Uninterruptible Power Supply)** for critical setups
* Protects against power surges and brief outages
* Allows graceful shutdown during extended power loss
  {% endstep %}

{% step %}

#### Configure WhatSnap Gateway to Start Automatically

Ensure the gateway starts when you log in:

1. Open **System Settings** → **General** → **Login Items**
2. Click the **"+"** button
3. Navigate to **Applications** and select **WhatSnap Gateway**
4. Click **"Add"**
5. Verify it appears in the "Open at Login" list

**For Multiple User Profiles:**

* Repeat this process in **each user profile**
* Ensures all iMessage accounts reconnect after Mac restart
  {% endstep %}
  {% endstepper %}

### Alternative: Amphetamine App

If you want additional control over sleep prevention:

1. Download **Amphetamine** (free) from the Mac App Store
2. Configure to keep Mac awake indefinitely
3. Useful for Mac mini with disconnected display
4. Provides menu bar control and scheduling options

{% hint style="info" %}
**Amphetamine vs WhatSnap Built-in**: WhatSnap Gateway already prevents sleep, but Amphetamine provides backup protection and more granular control if needed.
{% endhint %}

## 📊 System Requirements Summary

### Quick Reference Table

| Component       | Minimum Requirement    | Recommended               | Notes                      |
| --------------- | ---------------------- | ------------------------- | -------------------------- |
| **iPhone**      | iPhone 6s, iOS 12.0    | iPhone 11+, iOS 15+       | Newer = better performance |
| **Mac**         | Late 2014+, macOS 12.4 | Mac mini M1/M2, macOS 13+ | Mac mini ideal for 24/7    |
| **RAM**         | 8 GB                   | 16-32 GB                  | More for multiple accounts |
| **Storage**     | 128 GB                 | 256 GB+                   | SSD required               |
| **Network**     | WiFi                   | Wired Ethernet            | Stability critical         |
| **Speed**       | 10/5 Mbps              | 25/10 Mbps                | Down/Up                    |
| **iPhones/Mac** | 1                      | 1-4 max                   | Risk scales with quantity  |

## ✅ Pre-Setup Checklist

Before connecting your iMessage account to WhatSnap, verify:

### iPhone Checklist

* [ ] iPhone model is **6s or newer**
* [ ] Running **iOS 12.0 or higher** (iOS 14+ recommended)
* [ ] **iMessage is enabled** in Settings
* [ ] **Active cellular plan** with SMS capability
* [ ] **Signed in with Apple ID**
* [ ] **SMS Text Message Forwarding** is supported/enabled
* [ ] iPhone is **charged and connected to power**
* [ ] **Stable internet connection** (WiFi or cellular)

### Mac Checklist

* [ ] Mac is **Late 2014 or newer**
* [ ] Running **macOS Monterey 12.4 or later**
* [ ] **Signed in with same Apple ID** as iPhone
* [ ] **Messages app** is installed and working
* [ ] **Adequate RAM** for planned number of accounts (8+ GB)
* [ ] **Sufficient storage** available (128+ GB free)
* [ ] **Stable internet connection** (Ethernet preferred)
* [ ] **Power settings** configured for 24/7 operation
* [ ] **Auto-restart after power failure** is enabled

### WhatSnap Setup Checklist

* [ ] **WhatSnap account** is active
* [ ] Connected to **GoHighLevel sub-account**
* [ ] **WhatSnap Gateway app** downloaded
* [ ] **Authentication token** copied from dashboard
* [ ] **Security settings** allow app installation
* [ ] Plan to keep Mac **powered on 24/7**

## 🔧 Troubleshooting Hardware Issues

### Mac Performance Issues

<details>

<summary>Mac Running Slow with Multiple Accounts</summary>

**Symptoms:**

* Laggy interface
* High CPU usage
* Messages delayed
* Mac overheating

**Solutions:**

1. Check **Activity Monitor** for memory pressure (should be green)
2. **Reduce number of active iMessage accounts** if memory pressure is yellow/red
3. **Upgrade RAM** if consistently running out of memory
4. Ensure Mac has adequate **cooling/ventilation**
5. **Clean up storage** - ensure 20%+ free disk space
6. Consider **upgrading to M1/M2 Mac mini** for better performance per watt

</details>

<details>

<summary>Mac Won't Stay Awake</summary>

**Symptoms:**

* Mac goes to sleep despite settings
* Messages stop sending when display off
* Gateway app disconnects periodically

**Solutions:**

1. Verify **Energy settings** are properly configured
2. Ensure **WhatSnap Gateway app is running** (keeps Mac awake)
3. Check for **"Prevent sleep" permission** in Privacy settings
4. Install **Amphetamine** as backup
5. For Mac mini: Disconnect monitor but leave Mac plugged in
6. Disable **Power Nap** feature

</details>

<details>

<summary>iPhone Not Syncing with Mac</summary>

**Symptoms:**

* Messages don't appear on both devices
* Replies only on one device
* SMS forwarding not working

**Solutions:**

1. Verify **same Apple ID** on both devices
2. Check **Messages in iCloud** is enabled on both
3. On Mac: Messages → Settings → iMessage → verify phone number listed
4. On iPhone: Settings → Messages → **Text Message Forwarding** → enable Mac
5. **Sign out and sign back** into iMessage on both devices
6. Restart both iPhone and Mac
7. Wait 15-30 minutes for sync to complete

</details>

## 📚 Related Documentation

After verifying your hardware meets requirements:

1. [**Adding iMessage Accounts**](https://whatsnap.gitbook.io/whatsnap-docs/account-management/imessage) - Complete setup guide
2. [**Multiple iMessage Accounts**](https://whatsnap.gitbook.io/whatsnap-docs/account-management/imessage/multiple-imessage-accounts) - Connect multiple iMessage numbers for teams and volume
3. [**iMessage Troubleshooting**](https://whatsnap.gitbook.io/whatsnap-docs/account-management/imessage/troubleshooting-imessage) - Comprehensive troubleshooting guide
4. [**iMessage Account Blocked**](https://whatsnap.gitbook.io/whatsnap-docs/account-management/imessage/imessage-account-blocked) - Recover from Apple iMessage deactivation
5. [**Account Settings**](https://whatsnap.gitbook.io/whatsnap-docs/account-management/settings/account-settings) - Configure your connected devices
6. [**Tag Management**](https://whatsnap.gitbook.io/whatsnap-docs/account-management/settings/tag-management) - Route messages across platforms

{% hint style="info" %}
**Questions About Hardware?** If you're unsure whether your devices meet requirements, contact <support@whatsnap.ai> with your device models and we'll help verify compatibility.
{% endhint %}

***

**Last Updated**: Check the [Adding iMessage Accounts](https://whatsnap.gitbook.io/whatsnap-docs/account-management/imessage) guide for the latest setup instructions.
