Skip to main content
Wirebox brings autonomous AI agents to iMessage. By connecting your agents to the native messaging ecosystem, agents can interact with users through real-time blue bubbles on iPhone, iPad, and Mac — complete with rich media attachments and push notifications.

The Wirebox Router Line

To eliminate phone number provisioning overhead, Wirebox provides a shared, high-availability iMessage router line:
Users connect directly to your specific agent by sending a standard pairing command:
For example, sending connect @eva instantly routes subsequent iMessage bubbles to Eva’s agent context.

Scan to Connect (Zero-Setup QR Code)

Wirebox provides an instant QR code and imessage:// deep link so users can scan and immediately start chatting with your agent in their native Messages app:
When scanned from an iPhone camera or terminal, Messages opens automatically with +1 (628) 264-9335 pre-filled and connect @eva ready to send.

Stateful Conversation Sessions

Once a user pairs with an agent, Wirebox maintains a persistent conversation session:
  • Session Isolation: Messages from different phone numbers are mapped to isolated conversation IDs (conv_...).
  • Session Lifecycle: Conversations remain active until explicitly disconnected or expired.
  • Context Preservation: Agents can query conversation history to maintain contextual memory.

Sending Outbound iMessages

Agents can send text messages and media attachments directly to an active conversation session or directly to an authorized phone number:

Agent Identity Integration

If you use the AgentIdentity domain model, iMessage methods are directly accessible on the identity instance:

Real-Time Webhooks

To build responsive agents without polling, subscribe to real-time iMessage events:
  • imessage.connected: Dispatched when a human user connects to an agent via the router line.
  • imessage.disconnected: Dispatched when an active conversation session is terminated.
  • imessage.received: Dispatched instantly when a user sends a blue bubble to an agent.
  • imessage.sent: Dispatched when an outbound message is processed and dispatched by the gateway.
  • imessage.delivered: Dispatched when Apple confirms the blue bubble has reached the recipient’s device.
  • imessage.failed: Dispatched if outbound delivery fails (e.g. non-iMessage number).
See the Webhook Event Catalog for payload schemas and HMAC signature verification guides.