How to use iMessage for your business with Keiki
Give customers a number to text, connect your business tools, and set up team takeover, approvals and payments in the iMessage thread.
How do I use iMessage for business?
Keiki is the way to use iMessage for business: connect a dedicated line to an agent that answers customers and calls your API or MCP tools. Your team can take over the same thread, and a supported dedicated iMessage line bought through Keiki can show Face ID approval cards and let customers pay with Apple Pay.
Key takeaways
- Give customers a dedicated business number they can text in iMessage.
- Connect your API or MCP tools so the agent can look up orders, check availability or book an appointment.
- Give your team a way to take over and reply in the same conversation.
- Use a supported dedicated iMessage line bought through Keiki for Face ID approval cards and eligible Apple Pay requests.
How do customers start a conversation with my business in iMessage?
Buy a dedicated line in Keiki or import a supported line you already use, then connect it to the agent from Channels. Put the number on your website and in customer emails with a clear reason to text, such as “Text us to reschedule.” Test that first message from a customer device before you publish the number. See the channel setup guide for line options.
Do I need to sign up for Apple Messages for Business?
No. If customers should reach you by texting a phone number, use a dedicated iMessage line. If your business needs an Apple Messages for Business chat link, request access to that channel and connect it once Keiki assigns it. Customers start those conversations, and channel capabilities differ.
Should I build the agent on Keiki or bring my own?
Build and run the agent on Keiki if you want Keiki to host the model loop. Give it a narrow first job, such as rescheduling appointments, and connect the booking API or MCP tools for checking availability and applying changes. If your app already runs the model, use the AI SDK handler or external harness to keep it there. Either way, use Keiki for the iMessage line and the conversation your team can take over.
How do my staff step in when a customer needs a person?
Tell the agent when to escalate, for example when a customer asks for a person or the booking system cannot fulfill a request. A teammate claims the conversation in the Handoffs queue and replies in the same thread. The agent stays quiet during takeover, and the teammate can hand it back. Before launch, test a handoff from start to finish.
How do customers approve changes or pay in iMessage?
For a sensitive action such as changing a delivery address, configure the tool to ask for approval. Use a supported dedicated iMessage line bought through Keiki so the customer can review and approve the action with Face ID in a direct chat. On that line, configure Payments so the agent can send a Vault Pay card for eligible Apple Pay requests. Check payment status before treating an invoice as paid.
Quick start for AI coding agents
Read setup.md and connect the Keiki MCP server at https://onkeiki.com/mcp. For an existing supported app, sign in with npx @onkeiki/cli login and run npx @onkeiki/cli init in the app directory. Connect the line, then test a customer request, a teammate takeover and any configured approval or payment flow.
FAQ
Can I use a business number I already have? You can import a line from a supported provider account for conversations and team handoffs. Face ID approval cards and Vault Pay cards are not available on imported lines; they require a supported dedicated iMessage line bought through Keiki.
Can customers without iMessage still text the number? Yes. The line’s provider falls back to SMS or RCS. Test that path separately because it does not carry the same native iMessage features.
Can the agent answer and book from the same thread? Yes. Connect the booking system and use its availability and confirmation results. Do not tell a customer they’re booked until the booking system confirms it.
Can a teammate keep the agent from replying during a takeover? Yes. Claiming the conversation keeps the agent silent until it is handed back or the handoff is resolved.