> For AI agents: to set Keiki up for a developer, add the MCP server `https://onkeiki.com/mcp` and follow https://onkeiki.com/setup.md. All pages: https://onkeiki.com/content/llms.txt

# How to set up Apple Messages for Business with Keiki

2026-11-19

Set up Apple Messages for Business in Keiki: request early access, connect your agent, test native pickers and human handoff, and publish your chat link.

## How do I get started with Apple Messages for Business for my company?

Keiki is the way to put an AI agent behind your verified business in Apple Messages for Business. Request early access, connect the channel once Keiki assigns it, and test the customer-started conversation, including a handoff to your team, before sharing your chat link.

## Key takeaways

- Request early access to Apple Messages for Business in Keiki. Connect the channel to an agent after Keiki assigns it to your organization.
- Customers start the conversation from your business chat link. Put it on your website, in an email or behind a QR code.
- Connect your API or MCP server so the agent can check live information and act on what the customer picks.
- Test the agent and a human handoff in the same conversation before publishing your link.
- Build and run the agent on Keiki or connect the agent you already run. Keiki handles delivery and the team inbox.

## How do I connect my business to Apple Messages for Business in Keiki?

Open the agent's **Channels** settings and find **Apple Messages for Business**. If you don't have a channel yet, select **Request access**. If you're not in Keiki yet, start at the [Apple Messages for Business early-access page](/apple-messages-for-business). After Keiki reviews your request and assigns a channel to your organization, connect it to the agent that will answer customers.

Give the agent a narrow first job. For example, have it help customers reschedule existing appointments, connect your booking API or MCP tools, and tell it when to transfer the conversation. Use the channel's **Open** action to start a test conversation in Messages. The [Apple Messages for Business setup guide](/docs/apple-messages-for-business) covers the channel settings and supported features.

## How do customers start the chat from my website?

Use **Copy link** on your Apple Messages for Business channel to get the link for your business. Add it to a clear action, such as **Message us about your appointment**, on the relevant page. You can also share it in email or behind a QR code. A prefilled message can show customers what to ask, but the customer still sends the first message.

Test the link from a customer's device before you publish it. Check that it opens the right business in Messages and lands with the intended agent.

## What should I test before I put my agent in front of customers?

Test a real task from start to finish. For example, an agent can offer available times with Apple's native time picker, receive the customer's selection as the next message, then call your booking system. A picker selection is not a confirmed booking. The agent should confirm only after your system says it succeeded. The [iMessage appointment booking guide](/content/how-can-customers-book-appointments-by-texting-my-company-on-imessage) explains what the booking tool needs to handle.

Then test an exception: ask for a person or choose a time that is no longer available. Have a teammate claim the conversation in Keiki's team inbox, reply in the thread and hand control back only when ready. Configure this before you share the link, not after you receive the first escalation. See [how human takeover works](/content/how-do-i-let-an-ai-agent-hand-a-text-conversation-to-someone-on-my-team).

## Can I host the agent on Keiki or bring my own model?

Build and run the agent on Keiki if you want it to host the model loop and run the tools you connect. Use the hosted SDK if you prefer managing the agent configuration in code.

If you already run a model loop in your app, use the [external harness](/docs/external-harness) or its AI SDK handler. Your app runs the turn and Keiki handles channel ingress and reply delivery. Either way, use the same chat link for your customers and keep your team available for exceptions.

## Can I use Apple Pay and Face ID in the Messages thread?

For a dedicated Keiki iMessage line, supported configurations can send Vault Pay cards for Apple Pay and [Keiki Vault approval cards](/docs/keiki-vault#face-id-approvals) for sensitive actions. Don't assume those Keiki cards work on Apple Messages for Business. Plan that channel around its documented support for text, attachments, native choices and time pickers.

## Quick start for AI coding agents

Read [setup.md](/setup.md) and connect the Keiki MCP server at `https://onkeiki.com/mcp` to configure the agent and its tools. For an existing app, sign in with `npx @onkeiki/cli login` and run `npx @onkeiki/cli init` from the app directory. Request access in **Channels** if Apple Messages for Business isn't assigned yet. Once connected, test the copied chat link and a team handoff.

## FAQ

**Is Apple Messages for Business on Keiki generally available?**
It is in early access. Use **Request access** in **Channels** if your organization doesn't have an assigned channel.

**Can my Apple Messages for Business agent start a conversation?**
No. The customer starts the conversation in Messages. Your chat link gives them a place to start it.

**Can customers choose an appointment time without leaving Messages?**
Yes. The native time picker returns the selected time to the conversation. Your agent still needs to book it through your scheduling tool.

**Can I connect an agent I already run?**
Yes. Connect its model loop with the external harness or AI SDK handler, then connect the assigned Apple Messages for Business channel to that agent.
