Does this work on Android?

This page focuses on iPhone Action Button and Back Tap. Android users can still build a similar launcher shortcut in their device’s automation app, but steps differ.

Can I open Grok (voice) instead of Grok Bot?

Yes, but that is a different app. This setup targets Grok Bot agents on your Cursor account, not the standalone Grok consumer app.

Will the shortcut send messages without me?

The open-URL shortcut only launches a chat. A webhook shortcut triggers a routine you configured. Still subject to your Bot’s approval rules for outbound actions.

Where do I find YOUR_BOT_ID?

Use the agent id from desktop deep links or integration docs (grokbot://app/v1/agent?id=…). If unsure, open the Bot on desktop and ask support docs for the current id location in your app version.

iPhone Action Button opens one Grok Bot

Last updated: October 14, 2026

Quick answer

Map the iPhone Action Button (or Back Tap) to a Shortcut that opens one specific Grok Bot chat instantly, so you are not hunting the sidebar when you want the same agent every time.

At a glance

All outcome figures are estimates from cited sources, not independent verification by us.

What it is allowed to do: Read-only
Only reads, researches, or summarizes. It never drafts outbound content or changes anything.
Time saved (estimate): About 5–15 seconds per open; adds up if you launch the same Bot many times per day
Difficulty: Beginner
Tools needed: Grok Bot, Apple Shortcuts
Typical cost: Grok Bot iOS app: requires Grok Bot access on your Cursor/X plan; Apple Shortcuts: free.

Basis (estimate): Estimate only: saves sidebar search and app navigation; no cited timing study.

What does this setup do?

Map the iPhone Action Button (or Back Tap) to a Shortcut that opens one specific Grok Bot chat instantly, so you are not hunting the sidebar when you want the same agent every time.

Who is it for?

Grok Bot users on iPhone 15 Pro or newer (Action Button) or any iPhone who want one-tap access to a single Bot, for inbox triage, voice note handoff, or a household coordinator.

How do you set it up?

Tools

Grok Bot iOS app (signed in with the same account as desktop)
Apple Shortcuts app
Bot ID from desktop: open the Bot chat and copy the agent id used in grokbot:// deep links (forum integrations use grokbot://app/v1/agent?id=…)
Optional second Shortcut: webhook routine for dictated text (desktop shows webhook URL/key)

Steps

On desktop, open the Grok Bot you want on speed dial. Note its agent id (from share/deep-link docs or developer integrations that open grokbot://app/v1/agent?id=YOUR_ID).
In Shortcuts, create a new shortcut: add Open URLs with grokbot://app/v1/agent?id=YOUR_ID (replace YOUR_ID). Name it clearly, e.g. “Open Inbox Bot.”
On iPhone: Settings → Action Button → Shortcut → pick your shortcut. On phones without Action Button, use Settings → Accessibility → Touch → Back Tap → assign the same shortcut.
Test once: Action Button should launch Grok Bot straight into that Bot’s chat. If the app opens to home, confirm you are signed in and the id matches the Bot on your account.
Optional voice handoff: on desktop, create a routine with a webhook trigger; in Shortcuts add Get Contents of URL (POST, Authorization Bearer + key, JSON body with dictated text). Assign a different shortcut to Back Tap if Action Button is already used.
Keep send/spend/publish approvals on in Grok Bot settings. The shortcut only opens the Bot; it does not bypass approval fences.

Example output

Illustrative. Your results will differ.

Your bot set up and connected in under 10 minutes
Tested with a sample task before going live
You stay in control of what it can touch.

Where to paste this prompt

Grok Bot: Grok Bot → Routine or scheduled task template

Copy-paste prompt

Adapt bracketed fields to your situation.

This setup is primarily Shortcuts configuration, not a Bot system prompt.

Open URL (Action Button shortcut):
grokbot://app/v1/agent?id=YOUR_BOT_ID

Optional: dictate text into a webhook routine (configure on desktop where webhook URL, key, and Authorization header are shown):

Shortcut actions:
1. Dictate Text (or Receive input)
2. Get Contents of URL: Method POST
   URL: [webhook URL from routine on desktop]
   Headers: Authorization: Bearer [key from desktop]
   Request Body: JSON: pass the dictated text
3. Show notification "Sent to [Bot name]"

Replace placeholders with values from your routine's desktop settings. Do not embed secrets in the shortcut name or share the shortcut publicly.

Newsletter

Get the free starter pack

Free starter pack with five beginner copy-paste prompts after you confirm, plus three sourced setups in your inbox each week. Unsubscribe anytime.

What usually goes wrong?

Where agents tend to stall on this job. More patterns in Where AI gets stuck.

Webhook URL, key, and Authorization header for routines are documented as desktop-only today. Plan to copy them on Mac/Windows first.
grokbot:// links inside mobile chat may not open until the app handles them. Use a Shortcut Open URL for reliability.
Wrong agent id opens a different Bot or template preview. Double-check id against the Bot you use daily.

Which chat tools work with this prompt?

Paste the prompt into any of these assistants (free or paid tiers).

Grok Bot

Common questions

Does this work on Android?: This page focuses on iPhone Action Button and Back Tap. Android users can still build a similar launcher shortcut in their device’s automation app, but steps differ.
Can I open Grok (voice) instead of Grok Bot?: Yes, but that is a different app. This setup targets Grok Bot agents on your Cursor account, not the standalone Grok consumer app.
Will the shortcut send messages without me?: The open-URL shortcut only launches a chat. A webhook shortcut triggers a routine you configured. Still subject to your Bot’s approval rules for outbound actions.
Where do I find YOUR_BOT_ID?: Use the agent id from desktop deep links or integration docs (grokbot://app/v1/agent?id=…). If unsure, open the Bot on desktop and ask support docs for the current id location in your app version.

What tips make it smoother?

Append &voice=1 to the agent URL if you use desktop voice latch integrations; test whether iOS honors it on your app version.
Use a dedicated Bot for Action Button jobs so context does not mix with experimental chats.
After changing phones, re-assign the Action Button shortcut. ICloud sync usually keeps the Shortcut itself.

Where do the claims come from?

Summaries use public sources linked below, not independent verification. How setups are picked.

Read original on docs.x.ai
Grok Bot on iPhone; share sheet and search.
Read @McKlayneMarsh’s write-up (grokdoc.dev)
@McKlayneMarsh: Community pattern: Shortcuts POST to routine webhook; credentials on desktop.
Read original on forum.cursor.com
Documents grokbot://app/v1/agent?id= deep link shape.
Read original on forum.cursor.com
Webhook fields on desktop; mobile limitations noted by team.
Read original on offscreenspace.com
Action Button and Back Tap patterns for Grok shortcuts on iPhone.

Related setups

Bot shared-computer security audit
Before you give Bot Bots more connectors or routines, run a read-only audit of what every Bot on your account can see on the shared cloud computer.
Morning inbox briefing and multi-inbox triage
Start the day with a short “what needs you” note, and periodically sort multiple inboxes into reply vs FYI vs junk, with drafts for your approval, not auto-send.
Weekly personal brief from calendar and inbox
Once a week, get a short list of appointments, bills, and personal to-dos pulled from your calendar and email, instead of re-asking the same questions in chat every Sunday.

Best AI setups for families (2026) →