iMessage paid

Give your agent a personal blue-bubble iMessage line for 1:1 conversations. Like email, iMessage needs no per-connection setup: one connect_imessage() call and your handler is answering texts from iPhones.

How it works

The gateway owns the iMessage number, so there is nothing for you to provision: no tokens, no Apple developer account, no device to pair. You connect, get back a phone number, and hand it out. Inbound texts arrive at the same on_message handler as every other channel, and message.reply() texts back in the same conversation.

• Plain text only: iMessage has no markdown. Send unformatted text; skip bold, headings, and code fences in your replies.
• Personal 1:1 messaging: this is a direct blue-bubble line to one person at a time, not a group or broadcast channel.
• Cold-initiate supported: unlike WhatsApp, your agent can text a number that never messaged it first, via initiate().

Connect

No arguments needed. The call returns a connection whose address is the iMessage number people text.

from caspian_sdk import CommClient

client = CommClient()                       # reads COMM_API_KEY / COMM_BASE_URL

imessage = client.connect_imessage()        # provider: agentphone-imessage
print("iMessage number:", imessage["address"])

@client.on_message
def handle(message):
    # plain text only, no markdown on iMessage
    message.reply(f"You said: {message.text}")

client.listen()                             # one loop, every channel

import { CommClient } from "caspian-sdk";

const client = new CommClient();                  // reads COMM_API_KEY / COMM_BASE_URL

const imessage = await client.connectImessage();  // provider: agentphone-imessage
console.log("iMessage number:", imessage.address);

client.onMessage(async (message) => {
  // plain text only, no markdown on iMessage
  await message.reply(`You said: ${message.text}`);
});

await client.listen();                            // one loop, every channel

Verify it

Run your program, then text the printed number from an iPhone. Your handler fires and the reply lands back in the same thread within a few seconds.

Cold-initiate

iMessage supports starting a conversation with someone who never messaged first. Pass the connection id and the recipient's number:

client.initiate(imessage["id"], recipient="+15551234567", text="Hi, it's your agent. Anything you need?")

await client.initiate(imessage.id, "+15551234567", "Hi, it's your agent. Anything you need?");

Next steps