Channels: iMessage
iMessage is a Tier 2 channel. It runs on a Mac signed in to iMessage, where Wayland reads and sends messages locally. You set how often it polls for new messages and which handles it will talk to.
Before you start (prerequisites and accounts)
Section titled “Before you start (prerequisites and accounts)”- A Mac signed in to iMessage with the Messages app.
- The Wayland desktop app running on that Mac with a model provider connected.
- The permissions macOS requires for an app to read Messages.
Create the credentials (on the provider side)
Section titled “Create the credentials (on the provider side)”iMessage runs locally, so there is no API token. Decide which contacts the assistant should respond to and have their handles ready (phone numbers or Apple IDs).
Connect it in Wayland (Settings -> Channels -> iMessage)
Section titled “Connect it in Wayland (Settings -> Channels -> iMessage)”- Open Settings -> Channels and choose iMessage.
- Set the Poll interval, how often Wayland checks for new messages.
- Enter the Allowed handles the assistant should respond to.
- Save.
- Grant any macOS permission prompts so Wayland can access Messages.
Verify (status goes from idle to connected, send a test message)
Section titled “Verify (status goes from idle to connected, send a test message)”After saving, the status moves from idle to connected. Send an iMessage from an allowed handle and confirm a reply.
Route to an assistant or team
Section titled “Route to an assistant or team”Set the assistant and default model on the iMessage page. Inbound messages from allowed handles route to that assistant.
Troubleshooting
Section titled “Troubleshooting”If no messages are read, confirm the Mac is signed in to iMessage and that Wayland has the required permissions. For a remote Mac relay, see BlueBubbles. For more, see Channel Connection Issues.