# Text Agents

Spara automates sales interactions over SMS, handling incoming text messages from leads and sending outgoing texts through Workflows.

<figure><img src="/files/g1bBh2ECxi9bWQrr44Br" alt=""><figcaption><p>The Text Agents page showing the active text agent configuration.</p></figcaption></figure>

* **Incoming replies** — Spara AI responds to incoming text messages from leads, answering questions and moving them through your sales funnel without rep involvement.
* **Automated outgoing texts** — Spara AI sends texts to leads as part of a Workflow. For example, after a lead submits a form, a Workflow can send an immediate text to prompt them to schedule a meeting.

Spara does not send cold or unsolicited outgoing texts outside of your Workflows.

## Configuration

### Agent setup

Text agents are configured through the [Agent Editor](/agents/agent-overview.md) — the same interface used for Chat, Email, and Voice agents. Use the instructions field to define your agent's persona, tone, and how it should handle common scenarios like questions, objections, and handoffs to a rep.

### Phone number setup

Each text agent can be assigned an inbound phone number on the **Configuration** tab. This is the number the agent answers texts on and sends outgoing texts from. Phone numbers are provisioned through Twilio — contact your Spara account manager to enable texting and provision numbers for your organization.

{% hint style="warning" %}
**Twilio registration required.** Before your text agent can send or receive messages, your brand and messaging campaign must be registered and approved through Twilio's A2P 10DLC process. This industry-wide requirement verifies your business and ensures your messaging complies with carrier standards. Your Spara CSM handles the registration, but you'll need to provide a campaign description, links to your Terms of Service and Privacy Policy (with SMS opt-in language), and sample messages. See the [https://docs.spara.com/guides/onboarding-guides/text-agent-onboarding](https://docs.spara.com/guides/onboarding-guides/text-agent-onboarding "mention") for full details.
{% endhint %}

{% hint style="info" %}
Each phone number can only be assigned to one published text agent at a time. If you try to publish an agent with a number already in use, you'll see a conflict error.
{% endhint %}

## Outgoing texts with Workflows

The [Send Text Step](/agents/workflows/send-text.md) step in Workflows lets you send personalized outgoing texts to leads as part of a broader automated sequence. Pair it with **Wait** and **Condition** steps to build multi-touch SMS follow-up flows.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.spara.com/agents/text-agents.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.