Your AI Connector Docs

iMessage (Beta)

Bring iMessage into your unified inbox. Install the Mac app on a Mac that is signed in to Messages, type a pairing code, and your iMessages flow into the platform alongside WhatsApp, SMS, Instagram, and Messenger, with the same AI Agent, Broadcasts, and contact history you already use everywhere else.

Beta channel. iMessage is in closed access. Ask support to enable it on your account, then follow the steps below. Functionality, limits, and behaviour may change as the channel matures.

Overview

Apple doesn’t offer an official iMessage API, a set of rules that would let other apps connect to iMessage directly. Instead, a small Mac app runs on a Mac that is signed in to your Apple ID and connects that Mac to your account. Once connected, the platform:

  • Receives incoming iMessages as new conversations in Chats.
  • Sends outbound replies through your Mac, so they appear to recipients as a normal blue bubble iMessage from your Apple ID.
  • Lets your AI Agent, tags, and contact records work exactly as they do on every other channel.

There is no server to set up, no web address to copy and no password to paste. The Mac connects by itself once you enter the pairing code.

What You Need

  • A Mac (laptop or desktop) signed in to Messages with the Apple ID you want to use.
  • The Mac must stay on and online. If it sleeps, shuts down or loses internet, iMessages wait until it is back.
  • The Mac app, installed on that Mac. The download button is in the iMessage connect window.

Connecting iMessage

  1. In the left sidebar, click Settings near the bottom.
  2. In the Settings left rail, under Channels, click Channels.
  3. Find the iMessage card and click Connect. (The Connect button only becomes clickable once iMessage has been enabled for your account. Until then it’s grayed out and the card says iMessage isn’t enabled on your account yet.)
  1. In the connect window, click the download button and install the Mac app on your Mac.
  2. Open the Mac app and give it the two permissions it asks for:
    • Full Disk Access, so it can read incoming messages.
    • Permission to control Messages, so it can send your replies.
  3. Back in the connect window, copy the pairing code and type it into the Mac app.

The Mac connects by itself and the status flips to Connected. Incoming iMessages now arrive in your inbox in real time.

The pairing code is 8 characters long, works for 15 minutes and can be used only once. If it expires, open the connect window again for a new one.

More than one line

You can connect several lines to one account: one per Mac and Apple ID. Repeat the steps above on each Mac with a new pairing code. Each line has its own status and its own sending limits.

How Messages Flow

Incoming

  1. Someone sends an iMessage to your Apple ID.
  2. The Messages app on your Mac receives it, just like normal.
  3. The Mac app passes the new message to the platform.
  4. The platform creates a contact (if new), drops the message into Chats, and if your AI Agent for this channel is active, it replies.

Outgoing

  1. You or the AI send a reply from the platform.
  2. The Mac app tells the Messages app on your Mac to send it.
  3. The recipient sees a normal blue bubble iMessage from your Apple ID.

Supported Message Types

  • Text, images, files and voice notes in both directions.
  • Delivered and read status on your messages, when the recipient shares it.
  • Reactions (tapbacks) show on the message they were added to.
  • Group chats are not supported.

When the Mac Is Off or Offline

Messages sent to you while the Mac is off wait and arrive in the inbox once it is back online. A message you send while the Mac is offline fails with a clear reason instead of showing as sent, so you always know it did not go out.

Optional Advanced Mode

A typing indicator and a few extras are available only in an optional advanced mode, which needs a macOS protection turned off. It is not required: everything above works without it.

Sending Limits, Warm-up & Follow-up Controls

iMessage has the same kind of protective send limits, automatic warm-up, and follow-up kill switch that WhatsApp Web and Telegram have, with one difference worth knowing: on iMessage, automated follow-ups are turned on by default on a newly connected account, so switch them off yourself if you want the account to stay quiet while it warms up. Apple aggressively flags accounts that behave like bulk senders, so these guardrails exist to keep your Apple ID safe. You’ll find a Send Limits & Warm-up card and an Automated Follow-ups toggle on the iMessage settings page once you’re connected.

Automatic warm-up (ramp)

A newly connected iMessage account is intentionally throttled and unlocks more capacity over time. It earns a “qualifying day” only on days it actually sends at least 75% of its current cap. Idle days don’t count.

  • Daily message cap = 50 + 8 × (day − 1), capped at 500/day (reached at day 58).
  • Daily new-contact cap = floor((day − 1) × 5 / 6), capped at 50/day (reached at day 61).

The settings page shows the current ramp day, today’s usage against the cap, and how far it has to go. If your Apple ID already has long genuine iMessage history, you can move the ramp-day slider forward, but only do that honestly, for an account that really has that history.

Beyond-ramp manual override

After the full 58-day ramp, an optional override lets you push the daily message cap above 500 (750 up to 1,500, in 250-message steps). Keep it conservative. Apple doesn’t publish a safe number, and over-sending risks your Apple ID. The override is only available once the account is fully ramped.

Send limits on/off & follow-up kill switch

A master toggle enables or disables the send limits, and a daily new-contact ceiling lets you cap first-touches lower than the ramp would allow. The Automated Follow-ups toggle stops all automated follow-ups for the account regardless of Broadcast or Agent settings. On iMessage this toggle starts switched on, so a freshly connected account will send automated follow-ups until you turn it off, and turning it off is recommended while the account is fresh (under ~30 ramp days). When the daily cap is hit, scheduled follow-ups are pushed to the next day instead of failing.

Limitations of the iMessage Beta

Because iMessage doesn’t have an official API, this channel comes with constraints you won’t see on WhatsApp, SMS, or Instagram. Please review these carefully before relying on iMessage for business critical messaging.

  • Your Mac must stay on and online. No Mac, no new sends. We recommend turning off sleep on that Mac, or using a dedicated Mac mini.
  • One to one conversations only. Group chats are not supported.
  • No template or pre-approved messages. All messages are free form.
  • No bulk or broadcast blast sending. During Beta, iMessage is best used for inbound conversations and one to one replies, not high volume outbound broadcasts. Apple aggressively rate limits and flags automated iMessage traffic.
  • Account risk. Apple does not officially sanction third party iMessage automation. Excessive or spammy use can result in your Apple ID being flagged or restricted by Apple. Use the channel responsibly.

Troubleshooting

The Pairing Code Doesn’t Work

  • Codes expire after 15 minutes and work only once. Open the connect window again for a fresh code.
  • Make sure you typed all 8 characters into the Mac app.

Incoming Messages Not Appearing in the Inbox

  • Confirm the Mac is on, awake and online, and that the Mac app is running.
  • Check that the Mac app still has Full Disk Access in your Mac’s privacy settings.
  • Group chats are not supported, so they won’t appear.

Outbound Messages Failing to Send

  • Read the reason shown on the failed message. If the Mac is offline, bring it back online and send again.
  • Check that the Mac app still has permission to control Messages.
  • Test the same recipient directly from the Messages app on your Mac. If Messages can’t send it either (for example, the recipient isn’t on iMessage), the platform can’t either.
  • Confirm you have sufficient credits on your account.

Need Help?

iMessage is currently in Beta. If you run into issues we haven’t covered above, reach out to hi@youraiconnector.com with:

  • A description of the issue and any error message you saw.
  • The time the issue happened.

We’ll take a look as soon as we can.