Skip to main content
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.
This is different from the Twilio / hosted Send SMS function. Use this page when your DIDs and SMS are hosted on NetSapiens. For reading replies on the same number, see Check SMS Replies.
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.
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

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