> ## Documentation Index
> Fetch the complete documentation index at: https://help.slashy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Setting Up the iMessage Agent

> Connect your phone number to the Slashy iMessage agent and troubleshoot common issues.

The iMessage agent lets you manage email, calendar, and automations entirely through text messages. Once connected, you can search emails, draft replies, get briefings, and more -- without opening any app.

<Tip>The iMessage agent is one of Slashy's biggest differentiators. No other email client lets you manage your entire inbox via text. Set it up now and you will wonder how you ever lived without it.</Tip>

## Connecting During Onboarding

iMessage connection is step 6 of the onboarding guide.

<Steps>
  <Step title="Complete earlier onboarding steps">
    Google sign-in, Gmail connection, labels, memories, bulk cleanup.
  </Step>

  <Step title="Click Connect iMessage">
    This generates a link that opens iMessage with a pre-filled message to the Slashy number.
  </Step>

  <Step title="Send the pre-filled message">
    Do not edit it -- the message contains invisible zero-width Unicode characters that link your phone number to your account.
  </Step>

  <Step title="Confirm the connection">
    The Slashy agent responds within seconds confirming the link.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/karvixinc/0mmjo0UiqlV6I8u-/images/screenshots/onboarding-imessage-step.png?fit=max&auto=format&n=0mmjo0UiqlV6I8u-&q=85&s=9c38c4bc6a3bb623b154470b52e6a4c4" alt="Onboarding iMessage step showing the Connect iMessage button" width="2228" height="1384" data-path="images/screenshots/onboarding-imessage-step.png" />
</Frame>

<Warning>If you retype the message manually, the linking will fail. Always use the generated link.</Warning>

## Re-Activating the Agent

If the iMessage agent stops responding or you skipped it during onboarding: **just send it a text.** A simple "hi" works. There is no toggle -- the agent is always listening once linked. Sending a new message restarts the connection.

<Frame>
  <img src="https://mintcdn.com/karvixinc/0mmjo0UiqlV6I8u-/images/screenshots/imessage-reactivate.png?fit=max&auto=format&n=0mmjo0UiqlV6I8u-&q=85&s=ddd682892408913327047ca141a0953c" alt="iMessage conversation showing user sending hi and agent responding" width="1558" height="1254" data-path="images/screenshots/imessage-reactivate.png" />
</Frame>

## Linking a New Phone Number

<Steps>
  <Step title="Update your number">
    Go to **Settings** (`Cmd+,`) > **Integrations** > **Messaging** > **iMessage** and update your phone number.
  </Step>

  <Step title="Generate a new link">
    Open the agent sidebar (`p a`) and type: *"Generate my iMessage link."*
  </Step>

  <Step title="Send the pre-filled message from your new number">
    Click the provided URL to open iMessage and send.
  </Step>
</Steps>

## Quick Test After Setup

Verify everything works by trying these three messages right after connecting:

<Steps>
  <Step title="Test search">
    Text: *"Show me my latest unread email"* -- the agent should respond with a visual preview within 10 seconds.
  </Step>

  <Step title="Test calendar">
    Text: *"What's on my calendar today?"* -- confirms calendar access is working.
  </Step>

  <Step title="Test a draft">
    Text: *"Draft a test reply to my most recent email saying thanks"* -- confirms the agent can compose on your behalf.
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Agent stopped responding">
    Send any message (even "hi") to restart the connection. If it still does not respond after 60 seconds, re-generate the iMessage link from the agent sidebar.
  </Accordion>

  <Accordion title="Never received a response after setup">
    The pre-filled message may have been edited. Go to the agent sidebar (`p a`) and type *"Generate my iMessage link"* to get a fresh link. Send the new pre-filled message without editing.
  </Accordion>

  <Accordion title="Agent doesn't recognize your number">
    Your phone number is not linked to your Slashy account. Update it in **Settings > Integrations > Messaging > iMessage**, then generate a new iMessage link from the agent sidebar.
  </Accordion>

  <Accordion title="Messages sending as green (SMS)">
    Slashy requires iMessage, not SMS. Enable iMessage on your iPhone: **Settings > Messages > iMessage** (toggle on). If you are on Android, iMessage is not available -- use the Slashy mobile app instead.
  </Accordion>

  <Accordion title="Agent responds slowly (>30 seconds)">
    Complex tasks (meeting prep, multi-email searches) take longer. If simple queries like "show my unread emails" are consistently slow, contact [founders@slashy.com](mailto:founders@slashy.com).
  </Accordion>
</AccordionGroup>

## Privacy

iMessage conversations are processed by the same AI as the web and desktop apps. Messages follow the same rolling summary approach -- they are not stored permanently. See [AI Privacy](/getting-started/ai-privacy) for full details on how your data is handled.

***

## Related Articles

<CardGroup cols={2}>
  <Card title="iMessage Capabilities" icon="list-check" href="/how-to-guides/imessage-capabilities">
    Everything you can do via text
  </Card>

  <Card title="Daily Briefings" icon="sun" href="/how-to-guides/imessage-briefings">
    Morning summaries delivered to your phone
  </Card>

  <Card title="10 Automations" icon="bolt" href="/how-to-guides/10-automations">
    Set up the most impactful automations
  </Card>

  <Card title="Customize Your Agent" icon="sliders" href="/how-to-guides/customize-agent">
    Control your agent's writing style
  </Card>
</CardGroup>