iMessage is a Pro feature. Every other GAIA bot is available on the free plan.
Getting started
There is no public number. Each account gets its own GAIA line when you register.1
Register your phone number
Open Settings → Linked Accounts, choose iMessage, and enter your phone number in E.164 format (for example
+14155550123).GAIA shows you the number to text. It is specific to your account, so copy it from that screen.2
Text /auth to your GAIA number
Open Messages, start a new conversation with the number GAIA gave you, and send:You’ll get a link back. Tap it, sign in, and your account is connected.
3
Just type
Every message after that goes straight to GAIA. No command prefix, no mention.
Send from your phone number, not your Apple ID
GAIA only accepts messages sent from a phone number. An Apple ID email gets an automated bounce. To fix it, go to Settings → Messages → Send & Receive and set Start new conversations from to your phone number. Then start a new conversation. Old threads keep their old address.What you can do
Talk in plain language, or use the same commands as the other bots. See Bot Commands. You can also send photos and documents.What’s different on iMessage
Troubleshooting
I texted the number and got an automated bounce
I texted the number and got an automated bounce
Your message was sent from your Apple ID email rather than your phone number. Change it under Settings → Messages → Send & Receive and start a new conversation, as described above.
I get an upgrade prompt instead of a reply
I get an upgrade prompt instead of a reply
iMessage is Pro-only, and the plan is re-checked on every message. If your subscription lapsed, the bot stops replying until it’s active again.
GAIA asks me to link my account again
GAIA asks me to link my account again
Your link was removed, or you’re texting from a different number than the one you registered. Re-register the number you’re actually texting from in Settings → Linked Accounts.
Nothing happens in a group chat
Nothing happens in a group chat
Expected. GAIA only responds in direct messages, group conversations are ignored by design.
Want to run your own iMessage bot instead? See iMessage Bot Development.

