MessageBlue
Send and receive real iMessages programmatically — and let an AI agent answer them.
MessageBlue puts a real iMessage number behind an API. Your server sends a request, a blue-bubble message arrives on someone’s iPhone, and their reply comes back to you as a webhook. Optionally, an AI agent you configure answers on your behalf.
Start here
Apps, numbers, the Mac agent, conversations and webhooks — the ideas the rest of the docs assume.
A screen-by-screen guide to app.messageblue.ai, where you configure everything.
Every endpoint on the messaging gateway, generated from the live spec.
What makes it different
Blue bubbles, delivery and read receipts, reactions, attachments and group threads — not an SMS gateway pretending.
When a recipient cannot receive iMessage, delivery falls back to SMS and the status event tells you it happened.
Point it at your menu, price list or FAQ and it answers from them. Multi-step tasks and connected business apps are opt-in.
The shape of an integration
Create an app and get credentials
Sign in at app.messageblue.ai and create your app. You receive an Account ID, an App ID and an App Secret — the secret is shown only once.
See creating your app.
Attach a number
Either pair an iMessage-capable Mac you already own, or request a number and the team provisions one. Nothing sends or receives until an app has a number.
Send a message
Sign your request with the App Secret and send it to the gateway at api.messageblue.ai. The API reference documents every endpoint, and the API Console will sign and run a real request for you.
Receive replies
Set an inbound webhook URL in Settings. Incoming messages and delivery statuses are POSTed to your server, signed with X-MB-Signature so you can verify they came from MessageBlue.
Everything above except sending is also doable without writing code — you can run an entire MessageBlue deployment from the Messages inbox and an AI agent. To wire iMessage into tools you already use, the Zapier integration connects MessageBlue to 7,000+ apps with no code at all.
