Guides

How to add Grok Bot to your iMessage group chat

Give Grok Bot its own ZeroSettle iMessage number, connect the number to your Bot, then add it to your group from Messages on your iPhone. Once you set up the reply routine, anyone in that group can type “Grok” and get an answer in the same thread.

1. Connect a dedicated number to Grok Bot

Set up a ZeroSettle number and give it a recognizable name, such as “Grok Bot.” Send the onboarding test to your own iPhone and activate the line. ZeroSettle Pro includes one dedicated iMessage number, with a REST API for sends and signed webhooks for replies. ZeroSettle iMessage API and plans.

In the Grok Bot desktop app, open Connect apps, choose Add a custom connector, select Remote HTTPS, and enter https://portal.zerosettle.io/mcp. Name the connector ZeroSettle iMessage and authorize the account that owns the line. In a Bot chat, use @ to attach the connector. Ask it to call get_line and confirm the number you’ll add. Grok Bot’s connector instructions.

2. Add the number in Messages

You can add the Bot to an existing iMessage group with at least three people already in it. Everyone needs to be on iMessage. Let the group know which messages will trigger Grok Bot before adding its number.

  1. On your iPhone, open the group in Messages.
  2. Tap the group icons at the top of the thread.
  3. Tap Add in the participant list.
  4. Enter the Bot’s ZeroSettle number and tap Done.

Starting with a one-to-one thread? Compose a new message and address it to the Bot’s number and at least one other person. Apple’s guide to adding people in Messages.

3. Turn on group replies and test them

The connector lets Grok Bot send a message when you ask it in the app. To make an incoming iMessage start a run automatically, set the line to API management, create a webhook-triggered routine in Grok Bot, and register your relay URL as the line’s webhook. The relay verifies ZeroSettle’s signature and forwards eligible messages to the routine using its bearer key. Store the routine’s key and ZeroSettle’s signing secret in the relay’s secret settings. The full setup also shows how to give the routine a texting skill and an API key for replies. Complete Grok Bot setup · Grok Bot webhook docs.

Have someone post a short message in the group so you can find its chat_id with list_group_chats or GET /api/imessage/groups. Put that ID in the relay’s ALLOWED_CHATS setting. Set BOT_NAMES to grok so the relay forwards only group messages that name the Bot. The routine should reply using the incoming chat_id so everyone sees the answer. ZeroSettle’s group chat API reference.

  1. Send “Grok, please reply with ‘I’m in the group.’” Check that you get one reply from the Bot’s number in the group.
  2. Send an ordinary message without “Grok” and check that the routine stays idle.
  3. Ask a second person to name the Bot and confirm they get a reply in the same thread.

4. Give the group a first task

Start with something everyone in the thread can check. Try “Grok, summarize what we decided about Friday’s launch and list what’s still open.” Post the relevant details after the Bot joins so it has the context it needs. Once that works, try “Grok, compare these two vendor options and share your recommendation here.”

For a work group, let members request summaries and drafts, and have the owner approve external messages, purchases, or changes to accounts. Ask the Bot to report what it finished and what’s still waiting on a person. Set up approvals for Grok Bot.

If something doesn’t work

  • The Add button is missing. Check that at least three people are already in the thread and that everyone uses iMessage. If you’re starting from a one-to-one thread, compose a new group message.
  • The Bot is in the group but stays silent. Check the inbound message in ZeroSettle first, then the relay’s group and name filters, then the routine’s run history. If a run started, check for an approval request.
  • The reply lands in a private thread. Check that the routine sends with chat_id. The incoming handle identifies the person who wrote the message.

For connector and webhook diagnostics, see Troubleshoot ZeroSettle iMessage in Grok Bot.

Written by the ZeroSettle team. ZeroSettle gives businesses and AI agents a dedicated iMessage number with an API and signed webhooks.

Give Grok Bot its own iMessage number

Start with one dedicated iMessage number on Pro.

Growth signup uses a priced invite. Enterprise pricing is custom through sales. Compare the plans.