> ## 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.

# Check SMS Replies

> Let your AI agent read recent inbound SMS/MMS replies sent to the agent's Voip UCAAS number during a call.

**Check SMS Replies** lets your AI agent read recent inbound SMS or MMS replies sent to the agent's own Voip UCAAS SMS number—typically after [Send SMS](https://docs.telzino.com/netsapiens-functions/send-sms.md) during the same call.

> [!NOTE]
>
> This is different from two-way [SMS conversations](https://docs.telzino.com/admin-guide/dashboard/customer-management.md#conversations) in the dashboard. Use this page for in-call reply checks on a NetSapiens SMS DID.

In the Add Functions picker, **Check SMS Replies** is described as: "Check for recent inbound SMS/MMS replies sent to the agent's Voip UCAAS number."

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.
2. Voip UCAAS connected on the AI agent (steps below).
3. **NS Check SMS Replies** unlocked for the organization in Feature Administration.
4. Usually paired with [Send SMS](https://docs.telzino.com/netsapiens-functions/send-sms.md) on the same agent.

## 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 **Check SMS Replies**.
5. On the function card, fill in the instruction textbox: *"Describe when and how your agent should use this function to check for inbound SMS replies."*
6. Click **Save Changes**. You should see **Agent updated successfully!**

## Example instructions

```plaintext theme={null}
After you text the caller a form link, if they say they've replied or sent the information, check for their SMS reply and confirm what they sent.
```

```plaintext theme={null}
If the caller says they already texted a photo or details, check SMS replies before asking them to repeat the information.
```

## Tips

* Only messages received **during the current call** are returned, so older history is not mistaken for a new reply.
* Each message's text may be shortened (for example to its first 200 characters).
* On API **v2**, replies can arrive in real time through a platform message subscription, with polling as a backup. On **v1**, replies are checked through polling only.
* You still need [Send SMS](https://docs.telzino.com/netsapiens-functions/send-sms.md) (or another way for the caller to know the number) for most reply workflows.

## Troubleshooting

| What you see | What it means | What to do |
| - | - | - |
| **Check SMS Replies** doesn't appear under Voip UCAAS | Voip UCAAS isn't connected yet, or **NS Check SMS Replies** is locked | Finish Connect Voip UCAAS, or ask your partner or reseller to unlock **NS Check SMS Replies** |
| Agent finds no replies | Nothing was received on the agent's SMS number during this call | Confirm the caller texted the agent's number, then try again |
| Agent says SMS is temporarily unavailable | Telzino couldn't reach the Voip UCAAS API, or credentials stopped working | Re-save Voip UCAAS with valid Domain Manager (or higher) credentials |


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