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

# Send SMS

> Let your AI agent text a caller from the agent's own Voip UCAAS SMS number during a call.

**Send SMS** (Voip UCAAS) lets your AI agent text a caller—or another number the caller gives—during a call. Messages go out through your NetSapiens-based platform from the SMS number assigned to the agent's extension, not from a Telzino number.

> [!NOTE]
>
> This is different from the Twilio / hosted [Send SMS](https://docs.telzino.com/functions/send-sms.md) function. Use this page when your DIDs and SMS are hosted on NetSapiens. For reading replies on the same number, see [Check SMS Replies](https://docs.telzino.com/netsapiens-functions/check-sms-replies.md).

In the Add Functions picker, **Send SMS** is described as: "Send an SMS text message to an external phone number via Voip UCAAS. The agent's own SMS number is used as the sender."

This function is available in the **Connect App** only.

## Prerequisites

1. An SMS-enabled DID on NetSapiens routed to the agent's extension, with a carrier assigned. Carrier registration (for example 10DLC in the US) is between you and your SMS carrier.
2. Voip UCAAS connected on the AI agent (steps below).
3. **NS Send SMS** unlocked for the organization in Feature Administration.

## Connect Voip UCAAS

NetSapiens functions only appear after Voip UCAAS is connected on the AI agent.

1. In the Connect App (**AI Agents** tile in the NetSapiens portal), open the agent list.
2. In the agent's row, click the **Integrations** icon (gear).
3. Click **Voip UCAAS** ("Connect to your UCaaS platform for subscriber management.").
4. In **Configure Voip UCAAS Integration**, fill in:
   * **API Version** — **v1** or **v2**. Start with **v1** unless you know your platform supports v2. Chat Notification needs **v2**.
   * **Voip UCAAS URL** — your platform API host (for example `https://core1.example.com`). `/ns-api/` is added automatically if it's missing.
   * **Username** — a user with **Domain Manager** or higher access in the agent's domain.
   * **Password** — leave blank to inherit saved reseller credentials when the form offers that.
   * **Domain** — the domain the AI agent lives in (usually pre-filled).
   * **Advanced** (optional) — **Client ID** / **Client Secret**. Leave blank unless your platform needs manually issued OAuth credentials; they're normally auto-detected.
5. Click **Connect**. The Voip UCAAS tile then shows **Connected**.

> [!TIP]
>
> If your reseller already saved credentials, you can leave **Password** (and Advanced secrets) blank to inherit them.

## Add the function

1. In the agent list, click the agent's pencil (**Edit**).
2. Under **Functions**, click **Add**.
3. Expand the **Voip UCAAS** group ("Functions powered by your UCaaS platform."). The group shows how many of the 8 functions are already added (for example `1 / 8 added`).
4. Click **Add** next to **Send SMS**.
5. On the function card, fill in the instruction textbox: *"Describe when and how your agent should use this function to send an SMS text message."*
6. Click **Save Changes**. You should see **Agent updated successfully!**

## How it behaves

* Destination defaults to the caller's number unless the caller gives another.
* Sender is the agent's Voip UCAAS SMS number.
* Cap: **3 texts per call**.
* MMS is not supported.

## Example instructions

```plaintext theme={null}
When the caller asks for our address or booking link, offer to text it to them. Once they agree, send: "Book online at https://example.com/book. Reply here if you have questions."
```

```plaintext theme={null}
After you confirm the caller's mobile number, text a short confirmation of the appointment time.
```

## Tips

* The sender is always the SMS number assigned to the agent's extension.
* There is a limit of **3 texts per call**, so the agent cannot be talked into sending bulk messages.
* Sending MMS (pictures or files) is not supported.
* If no destination is given, the text goes to the caller's own number. Tell the agent to use a different number only when the caller provides one.
* In **Add Functions**, do not confuse this with the separate **Send SMS** outside the Voip UCAAS group (Twilio / hosted).

## Troubleshooting

| What you see | What it means | What to do |
| - | - | - |
| No Voip UCAAS tile, or it won't connect | The Netsapiens integration isn't unlocked for the organization | Ask your partner or reseller to unlock it in Feature Administration |
| **Send SMS** doesn't appear under Voip UCAAS | Voip UCAAS isn't connected yet, or **NS Send SMS** is locked | Finish Connect Voip UCAAS, or ask your partner or reseller to unlock **NS Send SMS** |
| Agent says SMS isn't provisioned for its extension | No SMS number has its destination set to the agent's extension with a carrier assigned | Assign an SMS-enabled DID to the agent's extension and set its carrier |
| Agent says the SMS limit was reached | The agent already sent 3 texts on this call | Expected. The limit resets on the next call |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.