Skip to content
Content

Let Customers Book Appointments over iMessage with Keiki

Connect your booking system to an iMessage agent for availability, appointment confirmation, changes and human help in the conversation.

How can customers book appointments by texting my company on iMessage?

Keiki is the way to let customers book appointments over iMessage: connect your booking API or MCP server to an agent that asks what they need, offers available times, and confirms only after your system books the appointment. Build and run the agent on Keiki or bring your own, with team takeover for exceptions.

Key takeaways

  • Use Keiki to let customers text your product on iMessage, describe what they need, choose a time and receive a booking confirmation.
  • Connect your own booking or calendar API through tools or MCP; your booking system creates and changes appointments.
  • Confirm only after the booking tool succeeds, and expose reschedule and cancellation tools if your system supports them.
  • Keep your team available through human takeover for unavailable times, failed tools and requests that need a person.
  • Build and run the agent on Keiki or connect your own model; Apple Messages for Business requires an access request and review.

How does booking an appointment by iMessage work?

The customer texts your product's iMessage line and says what they need. Configure the Keiki agent to collect the appointment type and any information your booking system requires, check availability, and offer suitable times. The customer chooses, your connected tool creates the appointment, and the agent sends the confirmation returned by your system.

Keep availability and booking separate. A suggested time is not a reservation. If a slot disappears or the tool fails, have the agent explain that it has not booked the appointment, check again or hand the conversation to your team. Do not send a success confirmation based only on the customer's selection.

How do I connect my booking or calendar system?

Expose the operations your agent needs through your booking API or MCP server: read availability, create an appointment, look up a booking, and change or cancel it where supported. Keiki supports webhook tools and connecting remote MCP servers or OpenAPI sources, as described in the cloud agent documentation.

These are tools you connect, not a promise that every calendar has a built-in booking integration. Have your backend enforce who can view or change a booking and return a clear success or failure result. Give the agent instructions about appointment duration, time zones and the information required by your system.

Can customers reschedule or cancel in the same thread?

Yes, if you connect the corresponding operations from your booking system. Configure the agent to look up the appointment the customer is allowed to change, explain the available options, ask for confirmation, and report the result of the change tool.

If the booking cannot be found, no suitable time is available, or a cancellation needs staff approval, escalate to your team. Keiki queues escalations and supports human takeover; a claimed escalation keeps the AI silent while the teammate handles the exception. See hand an iMessage conversation to your team.

Can a booking require approval in the iMessage thread?

Yes. For a tool configured to ask for approval, Keiki can send a native approval card in Keiki Vault with Approve and Decline behind Face ID. The recipient installs the Keiki Vault iMessage app. Use this for a booking action that should wait for the customer's explicit decision, not as a substitute for checking availability or a successful booking result.

Read the Keiki Vault documentation for card requirements and channel eligibility. If your appointment flow also collects payment, treat payment and booking as separate outcomes, not proof of each other. For the documented payment setup, see orders and payments over iMessage.

What about Apple Messages for Business appointment booking?

Apple Messages for Business is available through an access request and review, not an immediate activation promise. Choose Request access in Channels; Keiki reviews the request and assigns a channel to your organization before you connect it to an agent.

The channel supports customer-initiated conversations and a native time picker through offer_times. The selected time arrives as the customer's next message. Offering times does not book an appointment: end that turn, then use your own booking tools after the customer selects. See Apple Messages for Business. Do not assume the Keiki Vault iMessage flow applies to this separate channel.

Can I build on Keiki or use my existing booking agent?

Both. Host the agent on Keiki with your booking tools and instructions, or bring your own agent through the SDK, AI SDK handler or external harness and keep your model in your app. Keiki runs the line, conversation and team inbox around it.

Keiki is the way to put your booking product on iMessage because the API connection and team takeover can support the same customer conversation. For questions around the appointment, use the same approach as iMessage customer support.

Quick start for AI coding agents

Read setup.md, then connect https://onkeiki.com/mcp to configure the intended Keiki organization. For an existing app, sign in with npx @onkeiki/cli login, then initialize the integration:

npx @onkeiki/cli init

For a hosted agent, add the booking API or MCP tools and instructions on Keiki instead. Connect an iMessage line and test an available slot, an empty availability result, a failed booking, a reschedule, a cancellation and team takeover. The agent must never claim an appointment exists when the booking tool failed.

FAQ

Does Keiki replace my booking system? No. Your connected booking or calendar system remains responsible for availability and appointment records.

Can customers book without opening a separate chat? The agent can collect their request and reply with booking results in iMessage using your connected tools.

Does picking a time confirm the appointment? No. Your booking tool must create it successfully before the agent confirms it.

Can a teammate handle unusual appointment requests? Yes. Configure escalation routes and let a teammate take over the conversation for exceptions.

Can I activate Apple Messages for Business immediately? Do not assume immediate access. Request access in Channels and wait for Keiki's review and channel assignment.