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

# Reset Password

> Let your AI agent send a phone-system portal password-reset link after verifying the caller by voicemail PIN.

**Reset Password** lets a caller request a link to reset their phone-system portal password. The AI agent verifies them with their voicemail PIN first, then sends the reset link.

In the Add Functions picker, **Reset Password** is described as: "Send the caller a link to reset their phone-system portal password, after verifying them by voicemail PIN."

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

## Prerequisites

1. Voip UCAAS connected on the AI agent (steps below).
2. Callers who know their extension and voicemail PIN.
3. **NS Password Reset** 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 **Reset Password**.
5. On the function card, fill in the instruction textbox: *"Describe when and how your agent should use this function to send a portal password-reset link."*
6. Click **Save Changes**. You should see **Agent updated successfully!**

## Example instructions

```plaintext theme={null}
When a caller says they cannot sign in to the phone portal, ask for their extension and voicemail PIN, verify them, then send a password-reset link.
```

```plaintext theme={null}
If PIN verification fails twice, do not send a reset link. Offer to transfer to a person instead.
```

## Tips

* Always require successful PIN verification before sending a reset link.
* Do not invent portal URLs in instructions—let the function provide the reset link.
* Use a test portal user when you try this yourself; avoid real customer accounts in demos.


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