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

# SMS & iMessage

> Text your personal agent over iMessage or SMS

TextQL's SMS and iMessage integration lets you text a custom agent directly from your phone. Choose any agent, configure its context, connectors, model, and instructions, then text it on the go without opening the TextQL app.

## Availability

SMS is currently available for **US and Canada phone numbers only**. Both iMessage and standard SMS are supported.

## Enable SMS for your organization

<Note>
  TextQL hosted only. For on-prem or VPC deployments, contact [support@textql.com](mailto:support@textql.com).
</Note>

## Set up your phone number

1. **Navigate to [Settings → Personal](https://app.textql.com/settings/personal)**. The SMS section appears under Thread Default Tools when your organization has the feature enabled.

<Frame caption="SMS section in Settings → Personal">
  <img src="https://mintcdn.com/textql/HWwpCEidc8GN31Aw/images/sms/sms1.png?fit=max&auto=format&n=HWwpCEidc8GN31Aw&q=85&s=955966f143c049a9ba06549c48d3cc72" alt="SMS section in Personal settings" width="3456" height="1926" data-path="images/sms/sms1.png" />
</Frame>

2. In the **SMS** section, click **Add phone number**.

<Frame caption="Click Add phone number to start verification">
  <img src="https://mintcdn.com/textql/HWwpCEidc8GN31Aw/images/sms/sms2.png?fit=max&auto=format&n=HWwpCEidc8GN31Aw&q=85&s=1e0a4e78f20c8b25b0f3b5d926582635" alt="Add phone number button" width="3456" height="1924" data-path="images/sms/sms2.png" />
</Frame>

3. Enter your phone number in the modal and click **Verify**.

<Frame caption="Enter your US or Canada phone number">
  <img src="https://mintcdn.com/textql/HWwpCEidc8GN31Aw/images/sms/sms3.png?fit=max&auto=format&n=HWwpCEidc8GN31Aw&q=85&s=e96f64f19625055d8995d9c360a36a81" alt="Enter phone number modal" width="1728" height="964" data-path="images/sms/sms3.png" />
</Frame>

4. Enter the six-digit code sent to your phone and click **Confirm**.

<Frame caption="Enter the verification code from the text message">
  <img src="https://mintcdn.com/textql/HWwpCEidc8GN31Aw/images/sms/sms4.png?fit=max&auto=format&n=HWwpCEidc8GN31Aw&q=85&s=c154f85f2c6f2fe6cd337154bf350dd8" alt="Enter verification code modal" width="1725" height="959" data-path="images/sms/sms4.png" />
</Frame>

5. Once verified, your phone number appears in the SMS section. Select which agent your texts should route to. By default, this is your personal agent.

<Frame caption="Select the agent that receives your text messages">
  <img src="https://mintcdn.com/textql/HWwpCEidc8GN31Aw/images/sms/sms5.png?fit=max&auto=format&n=HWwpCEidc8GN31Aw&q=85&s=87487695e7440fc446efb41aeb7acc48" alt="Select texting agent" width="1728" height="964" data-path="images/sms/sms5.png" />
</Frame>

<Note>
  Removing your phone number from Personal settings stops all texting and clears your existing text thread. You will need to verify again to turn it back on.
</Note>

## Manage your texting agent

Open the **⋮** menu next to your selected agent to:

* **Configure** — Open the agent's settings page to set its context, connectors, model, and instructions.
* **Remove** — Remove your phone number and stop all texting.

<Frame caption="Configure or remove the texting agent from the settings menu">
  <img src="https://mintcdn.com/textql/HWwpCEidc8GN31Aw/images/sms/sms6.png?fit=max&auto=format&n=HWwpCEidc8GN31Aw&q=85&s=1c370c3d3b5baf84b6d79ef4f0b63e07" alt="SMS settings menu" width="3456" height="1936" data-path="images/sms/sms6.png" />
</Frame>

<Warning>
  Changing your texting agent starts a fresh text thread with the newly selected agent. The change does not carry over to your existing in-app chat history.
</Warning>

You can also open the agent's settings page directly to customize its system prompt and capabilities.

<Frame caption="Agent settings for your texting agent">
  <img src="https://mintcdn.com/textql/HWwpCEidc8GN31Aw/images/sms/sms7.png?fit=max&auto=format&n=HWwpCEidc8GN31Aw&q=85&s=6110dd79a4c91f08ef49a20994409726" alt="Agent settings page" width="3456" height="1934" data-path="images/sms/sms7.png" />
</Frame>

## Texting Ana

After setup, send a text or iMessage to the number shown in your Personal settings. Ana responds in the same thread, and replies maintain context so you can continue the conversation naturally.

* **Ask questions** about your organization's data and metrics.
* **Request figures and summaries** to receive answers directly in your messaging thread.
* **Reply in the same thread** to continue an ongoing conversation.

## In action

Below is an example of texting Ana once everything is set up.

<Frame caption="An example text conversation with Ana">
  <img src="https://mintcdn.com/textql/HWwpCEidc8GN31Aw/images/sms/sms8.png?fit=max&auto=format&n=HWwpCEidc8GN31Aw&q=85&s=e9673231063f874a7aa5276f247a40b7" alt="Texting Ana in action" width="746" height="764" data-path="images/sms/sms8.png" />
</Frame>

## Capabilities and limits

* SMS uses your selected texting agent and the connector/tool limits configured for that agent.
* By default, your texting agent can query every connector you have access to. Limit its connectors and tools in the agent's settings.
* Long responses may be truncated or split depending on carrier limits.
* File uploads and rich visualizations are not available over SMS.
* In group chats, Ana only responds to the author whose phone number is associated with her. Other participants in the group will not receive replies from Ana.

## Need Help?

For further assistance or to request SMS access for your organization, contact [support@textql.com](mailto:support@textql.com).

## Privacy Policy

For information about how we handle your data and protect your privacy when using TextQL's SMS integration, please review our [Privacy Policy](https://textql.com/privacy).