Skip to main content

iMessage Troubleshooting

Having trouble with your iMessage integration in GoGHL? This guide provides systematic troubleshooting steps to resolve common issues and get your iMessage account working properly with CRM.

iMessage Won't Activate?

If iMessage won't turn on or says "Waiting for activation" indefinitely, your account may be blocked by Apple. See the iMessage Account Blocked section below for recovery steps.

Quick Diagnostic Checklist​

Before diving into detailed troubleshooting, quickly verify these common issues:

  • ☑️ iMessage Sync app is running on your Mac
  • ☑️ Mac is powered on and connected to internet
  • ☑️ iPhone is online with cellular/WiFi connection
  • ☑️ Both devices logged in with same Apple ID
  • ☑️ "Messages in iCloud" is enabled on both devices
  • ☑️ Contact has the correct contact tag in CRM (e.g., {IM#1})
  • ☑️ Your GoGHL account is active (not expired trial)
Most Common Issue

90% of iMessage problems are caused by the iMessage Sync app not running on the Mac, or the Mac being asleep/offline. Always check this first!

Systematic Troubleshooting Steps​

Follow these steps in order to diagnose and resolve iMessage integration issues:

Step 1: Review Installation and Setup​

Go back and verify your initial setup was completed correctly. Walk through the iMessage Full Setup guide and confirm every step — iPhone iCloud sync, Mac iMessage settings, SMS forwarding, and the iMessage Sync app — was done properly.

If Apple ID issues persist:

  1. Sign out of iMessage on both devices
  2. Restart both devices
  3. Sign back in to iMessage on iPhone first, then Mac
  4. Wait 5–10 minutes for sync to complete

Step 2: Send Test Messages​

Verify basic iMessage functionality works before testing GoGHL integration:

Test 1: Mac to Mac/iPhone iMessage

  1. Open Messages app on your Mac
  2. Send a test iMessage to a friend's iPhone or another iMessage user
  3. Verify the message sends (should show as blue bubble)
  4. Confirm message appears on your iPhone as well (sync test)
  5. Have the recipient reply
  6. Verify reply appears on both your Mac and iPhone

Test 2: GoGHL Integration Test

  1. In CRM, open a contact record
  2. Add your iMessage contact tag (e.g., {IM#1})
  3. Go to Conversations tab
  4. Send a test message to this contact
  5. Check if message appears in:
    • CRM conversations
    • Mac Messages app
    • iPhone Messages app
important

If Test 1 fails: The issue is with Apple's iMessage sync, not GoGHL. Resolve Apple sync first.

If Test 1 works but Test 2 fails: Continue to next troubleshooting steps.

Step 3: Check Power and Sleep Settings​

A very common issue: Mac going to sleep stops the gateway from working. See the Mac sleep settings guide for the full configuration steps.

Common Issues and Solutions​

Messages Not Sending from CRM​

Symptoms:

  • Send message in CRM
  • Message shows as "sent" in GHL
  • Message never appears in Mac Messages app
  • Recipient never receives message

Causes & Solutions:

iMessage Sync Not Running​

  • Check Mac menu bar for iMessage Sync icon
  • If not visible, app is not running
  • Launch iMessage Sync from Applications folder
  • Verify it shows "Connected" status

Mac is Asleep or Offline​

  • Wake Mac and ensure it's online
  • Check WiFi/Ethernet connection
  • Verify internet connectivity
  • Adjust power settings to prevent sleep

Full Disk Access Not Granted​

See Granting Full Disk Access in the Full Setup guide. Restart the app after granting permission.

Messages in iCloud Not Synced​

  • iPhone and Mac must have Messages in iCloud enabled
  • Check both devices under iMessage settings
  • Allow 10–15 minutes for initial sync
  • Send a test message directly from Mac to verify sync works

Replies Not Appearing in CRM​

Symptoms:

  • Messages appear in Mac Messages app
  • Messages send to recipients successfully
  • Replies don't appear in CRM

Causes & Solutions:

Gateway Connection Lost​

  • Check iMessage Sync app status
  • Should show "Connected" with green indicator
  • If disconnected, reconnect with fresh token
  • Restart the app if status is unclear

Network Firewall Blocking​

  • Check Mac firewall settings
  • Ensure iMessage Sync is allowed through firewall
  • System Settings → Network → Firewall Options
  • Add iMessage Sync to allowed apps

SMS Fallback Not Working (to Android)​

Symptoms:

  • iMessages to iPhones work fine
  • Messages to Android phones fail to send
  • Green bubble messages don't deliver

Causes & Solutions:

iPhone Not Online​

  • iPhone must be online for SMS fallback to work
  • SMS messages route through your iPhone's cellular plan
  • Verify iPhone has cellular signal and data
  • Keep iPhone charged and connected

Text Message Forwarding Not Enabled​

  1. On iPhone: Settings → Messages → Text Message Forwarding
  2. Find your Mac in the list
  3. Toggle it ON
  4. Enter code displayed on Mac if prompted
  5. iPhone and Mac must be on same WiFi for initial setup

Cellular Plan Doesn't Support SMS​

  • Verify your iPhone carrier plan includes SMS
  • Some data-only plans don't support SMS
  • Contact your carrier if unsure
  • May incur SMS charges for Android messages

Phone Number Not Registered on Mac​

  1. On Mac: Messages → Settings → iMessage
  2. Verify your phone number appears under "You can be reached..."
  3. If missing, sign out and sign back into iMessage
  4. May take 24 hours for phone number to activate on Mac
SMS Charges

SMS to Android uses your iPhone's cellular plan and may incur carrier SMS charges.

Device Sync and Connection Issues​

Symptoms:

  • Messages sent from Mac don't appear on iPhone
  • Messages sent from iPhone don't appear on Mac
  • Conversations out of sync

Causes & Solutions:

Messages in iCloud Not Enabled​

  • iPhone: Settings → Apple ID → iCloud → Messages → Toggle ON
  • Mac: Messages → Settings → iMessage → Check "Enable Messages in iCloud"
  • Both devices must have this enabled
  • Wait 10–15 minutes after enabling for initial sync

Different Apple IDs​

  • Verify both devices use the same Apple ID
  • iPhone: Settings → [Your Name]
  • Mac: Messages → Settings → iMessage
  • Sign out and sign back in if needed

iCloud Storage Full​

  • Messages in iCloud requires iCloud storage
  • Check: iPhone Settings → Apple ID → iCloud → Manage Storage
  • If full, upgrade iCloud plan or free up space
  • Consider iCloud+ for more storage

Poor Internet Connection​

  • Both devices need stable internet for sync
  • Try switching between WiFi and cellular
  • Restart router if WiFi seems slow
  • Test internet speed on both devices

Force Sync​

  1. Sign out of iMessage on both devices
  2. Restart both devices
  3. Sign back into iMessage (iPhone first, then Mac)
  4. Wait 10–15 minutes for full sync
  5. Send test message to verify sync

iMessage Sync Disconnects​

Symptoms:

  • Gateway app shows "Disconnected" status
  • Red indicator in menu bar
  • Messages fail to send through GoGHL

Causes & Solutions:

Network Connectivity Issues​

  • Check Mac has internet connection
  • Try loading a website in browser
  • Restart WiFi/Ethernet if needed
  • Check router is working properly

Firewall Blocking Connection​

  1. System Settings → Network → Firewall
  2. If enabled, click "Firewall Options"
  3. Ensure iMessage Sync is allowed
  4. Consider temporarily disabling firewall to test

App Corruption​

  1. Quit iMessage Sync app completely
  2. Restart Mac
  3. Reinstall iMessage Sync app
  4. Reconnect with fresh code

Performance and Reliability Issues​

Message Delays​

Symptoms:

  • Messages eventually send but with delays
  • Several minutes between sending and delivery
  • Inconsistent delivery times

Causes & Solutions:

Mac Resource Constraints:

  • Check Activity Monitor for high CPU/memory usage
  • Close unnecessary applications
  • Restart Mac to clear memory
  • Consider upgrading RAM if running multiple iMessage accounts

Network Latency:

  • Test internet speed (should be 10+ Mbps)
  • Use wired Ethernet instead of WiFi for better stability
  • Restart router/modem
  • Contact ISP if speeds are consistently slow

iCloud Sync Delays:

  • Messages in iCloud can sometimes lag
  • Wait a few minutes and check again
  • Try sending test message to verify current sync status
  • Consider disabling and re-enabling Messages in iCloud

Multiple Accounts on One Mac:

  • Check RAM usage in Activity Monitor — running too many accounts on limited RAM causes delays
  • See How Much Power Do I Need? for RAM requirements per account count

Mac Keeps Sleeping​

Symptoms:

  • Mac sleeps even with "prevent sleep" enabled
  • Messages stop sending when Mac is idle
  • Have to wake Mac for messages to work

Fix: See the Mac sleep settings guide for the full set of energy and Power Nap configurations.

Advanced Troubleshooting​

Multiple iPhone Accounts Issues​

Symptoms:

  • Some accounts work, others don't
  • Mac runs slow with multiple accounts
  • Accounts disconnect randomly

First, verify your setup matches the requirements in Running Multiple iPhones on One Mac — RAM, Fast User Switching, and the 4-iPhone maximum.

Individual Account Troubleshooting​

  1. Switch to problem account's user profile
  2. Troubleshoot as if it were the only account
  3. Check Gateway connection status
  4. Verify iMessage is logged in for that profile

Permissions and Security Issues​

Symptoms:

  • macOS security warnings about iMessage Sync
  • Permission dialogs keep appearing
  • Features not working due to permissions

Full Disk Access & Gatekeeper Blocks​

For Full Disk Access setup and "unidentified developer" Gatekeeper warnings, see Step 4: Install the iMessage Sync App in the Full Setup guide.

Accessibility Permissions​

  • System Settings → Privacy & Security → Accessibility
  • Add iMessage Sync if requested
  • May be needed for some features

Reset All Permissions​

  1. Remove iMessage Sync from all permission lists
  2. Quit app completely
  3. Restart Mac
  4. Reopen app and grant permissions when prompted
  5. Ensures clean permission state

Help! My iMessage Got Blocked​

Did Apple suddenly turn off your iMessage? Don't panic. This section will show you exactly how to get your account unblocked and how to make sure it never happens again.

If your account gets blocked, GoGHL won't be able to send or receive messages for you until Apple turns it back on.

This is an Apple Decision

GoGHL does not block accounts. Apple controls iMessage, and they have automated spam filters that will turn off your account if they think you are acting like a robot or a spammer.

🚨 How to Tell if You're Blocked​

You are probably blocked by Apple if:

  • ✅ The iMessage Button is Gray: You can't even flip the switch to turn iMessage on in your iPhone settings.
  • ✅ Stuck on Activation: Your screen is stuck saying "Waiting for Activation..." forever.
  • ✅ Messages Send as Green Texts: Every message you send to another iPhone goes through as a green SMS text instead of a blue iMessage.
  • ✅ GoGHL Says Disconnected: Your dashboard shows your Mac is completely disconnected.
  • ✅ Login Fails: Apple won't let you sign into your Apple ID at all.
important

Before you panic, check your wifi! Sometimes bad internet or a turned-off Mac causes similar issues. Check the troubleshooting steps above first to rule out a simple internet drop.

🔍 Why Did Apple Block Me?​

Apple's number one goal is to keep spam off of iMessage. If you got blocked, you probably tripped one of their alarms.

Sending Too Much, Too Fast​

  • You texted way more people today than you usually do.
  • You went over the safe limit of 50 unique contacts per day.
  • You went from sending 5 messages yesterday to 200 messages today.

Acting Like a Spammer​

  • You copy-pasted the exact same message to 50 different people.
  • You didn't use anyone's first name.
  • You fired off 30 messages in under two minutes.

People Reported You​

  • The people you texted hit the "Report Junk" button.
  • A bunch of people blocked your phone number.
  • You sent cold texts to people who had no idea who you were.

Brand New Accounts​

  • You created a brand new Apple ID today and immediately started blasting texts. Apple hates this.

The GoGHL Rulebook​

If you are using GoGHL for your business, you have to play by the rules:

Stay Under the Radar

Always keep your sending to under 50 unique people per day. If you have a brand new account, start with just 10 a day and slowly work your way up. Only text people who actually opted in to hear from you.

✅ How to Get Your Account Unblocked​

If Apple definitely blocked you, here is exactly what you need to do to get it back.

Step 1: Make Sure You Can Still Log In​

  1. Go to appleid.apple.com on your computer.
  2. Try to log in with your Apple ID and password.
  3. Look for any big red warning signs or security alerts.
Can't Log In At All?

If Apple locked your entire account and you can't even sign in, go to Apple's Account Recovery right now to get your password back.

Step 2: Call Apple Support​

How to reach them:

  • Go to support.apple.com
  • Click on iMessage.
  • Choose iMessage Activation or Can't Send Messages.
  • Pick the option to have them call you or open a chat.

What to say when they answer:

"Hi! I can't seem to get iMessage to turn on on my phone. Can you check if my iMessage got blocked? My Apple ID is [your email]."

Have this ready:

  • Your Apple ID email
  • What kind of phone or Mac you use
  • What error message you see

Step 3: Fill Out the Re-Enable Form​

If Apple confirms they turned your iMessage off, they will ask you to fill out a form to turn it back on.

Where to go:

What to write: Keep it professional. Don't mention "mass texting" or "bulk SMS".

"Hi there. I use my iMessage to chat with my clients through my company's CRM (CRM). I just noticed my iMessage turned off. All my clients have opted in to text me, and I follow Apple's guidelines. Could you please help me turn my iMessage back on? Thank you."

Check Your Spam Folder

Apple will email you their answer. Keep an eye on your spam folder just in case!

Step 4: Wait for Apple's Email​

If they say YES:

  • They will email you saying iMessage is back on. Move to Step 5!

If they say NO:

  • They might decide to keep you blocked. If this happens, you will need to get a new phone number and create a new Apple ID.

Step 5: Turn iMessage Back On​

On your iPhone:

  1. Open your Settings app.
  2. Scroll down and tap Messages.
  3. Turn the iMessage switch OFF.
  4. Wait 30 seconds.
  5. Turn the iMessage switch back ON.
  6. Wait for it to activate (it might take a few minutes).

On your Mac:

  1. Open the Messages app.
  2. Click Messages in the top menu, then Settings.
  3. Go to the iMessage tab.
  4. Click Sign Out.
  5. Wait 30 seconds, then sign back in.

Test it: Send a text to a friend with an iPhone. If the bubble is blue, you are back in business!

Step 6: Reconnect to GoGHL​

  1. Open the iMessage Sync app on your Mac.
  2. You might need to log out and log back in.
  3. Grab a fresh Activation Code from your GoGHL dashboard and paste it in.
  4. Send a test message from CRM to make sure everything is working perfectly again.

🛑 Still Blocked? Try This​

If Apple sent you an email saying you are unblocked, but your phone is STILL stuck on "Waiting for Activation," try this:

  1. Call Apple Again: Don't use the chat this time. Ask for a phone call.
  2. Ask for a Senior Advisor: Ask to speak to someone higher up.
  3. Give them your Case Number: Tell them, "I got an email saying my account was unblocked, but my phone still won't activate. My case number is [insert number]."

Apple Support Numbers:

🛡️ How to Never Get Blocked Again​

Warm Up New Accounts Slowly​

TimeframeMaximum Texts Per DayWho to text
Week 110 to 15Real friends and family
Week 220 to 25A mix of friends and warm clients
Week 330 to 35Starting to send more client messages
Week 440 to 50Full speed! (But never go over 50)

Stop Sounding Like a Robot​

  • ✅ Use custom fields: Always say "Hi {{contact.first_name}}" instead of just "Hi".
  • ✅ Mix it up: Don't send the exact same sentence 40 times in a row.
  • ❌ No lists: Never buy a list of phone numbers and start cold-texting them.

Talk to People Who Actually Reply​

  • Only text people who know you and will text you back.

Don't Put All Your Eggs in One Basket​

  • If your agency needs to send 200 messages a day, set up 4 different iPhones and send 50 messages through each one.

🔄 Plan B: Starting Fresh​

If Apple completely permanently banned your account and refuses to unlock it:

  1. Create a brand new Apple ID.
  2. Get a new phone number.
  3. Start the warm-up process from Week 1 (see above).
  4. Do not make the same mistake twice!

📊 How Apple's Spam Filter Works​

Red Flags for Apple:

  • You text 100 people in an hour.
  • You text people who don't have you saved in their contacts.
  • You type faster than a human possibly could (which happens when you automate identical messages).
  • Your Apple ID is only 3 days old and you are sending 50 texts a day.
  • People hit the "Report Junk" button when they see your text.
Let's connect