---
title: "Text Message Profiles with VA 2.0 Auto-Login Links"
slug: "text-message-profiles-with-va20-auto-login-links"
updated: 2025-05-16T20:54:50Z
published: 2025-05-16T20:54:50Z
canonical: "docs.interprose.com/text-message-profiles-with-va20-auto-login-links"
---

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

# Text Message Profiles with VA 2.0 Auto-Login Links

This article explains how to create a text message profile in ACE that includes a secure auto-login link to Virtual Agent 2.0 (VA 2.0). These links allow consumers to access their accounts without manual login and can be customized to:

- Route to specific pages
- Apply a specific VA 2.0 Preference Profile
- Track engagement using source parameters

## VA 2.0 Auto-Login Link

The auto-login link provides secure, direct access to a consumer’s account in VA 2.0 without requiring them to log in manually.

With ${debt.virtualAgentLoginUrl}, consumers can:

- Make payments
- Access payment history
- View account details
- Submit disputes and documents

> [!NOTE]
> Note: Consumers are required to register an account if they wish to create a payment plan.

#### Does the Auto-Login Link Expire?

Yes. The login link expiration is configured in the [VA 2.0 Profiles section](https://docs.interprose.com/docs/how-do-i-configure-va20-profiles#how-to-locate-va-20-profiles). If a consumer clicks an expired auto-login link, they are redirected to the standard login page..

#### Is the Auto-Login Link included in default text message profiles?

Yes, the ${debt.virtualAgentLoginUrl} is already included in default text message profiles.

#### How can I access the default Text Message Profiles?

1. Go to **Setup → Vendors → Text**.
2. Locate the Text Msg Profiles section.
3. Select the profile you wish to review.

## Create a New Text Message Profile

1. Go to **Setup → Vendors → Text.**
2. Locate the Text Msg Profiles section, click "New."
3. Choose the appropriate Category (see [Understanding Text Categories](/v1/docs/understanding-text-categories)).
4. Add a clear and descriptive Identifier (e.g., VA_PAYMENT_REMINDER_PROFILE1_PAYMENT_PAGE) and select the Send Role ID
5. In the Body section, enter your message and insert the auto-login link: ${debt.virtualAgentLoginUrl}
  1. Customize the link as needed (see next section).
6. Click "Apply", then Save

![](https://cdn.document360.io/6c7303ca-5ffc-4149-8868-8ea498eee635/Images/Documentation/Screenshot%202023-11-03%20110004.png?sv=2026-02-06&spr=https&st=2026-10-31T15%3A36%3A07Z&se=2026-10-31T16%3A36%3A07Z&sr=c&sp=r&sig=iEI12mF8Z9PLoXvoaZY44oqe9xk0IC6VFkrnitTPxz0%3D)

Image Displays Steps 6-7

> [!TIP]
> TIP:
> 
> Use clear identifiers that describe the intent and function of the message (e.g., page destination and profile ID) for easier template management.

## Customize the Auto-Login Link

Enhance ${debt.virtualAgentLoginUrl} with optional parameters to:

- Direct consumers to a specific page
- Apply a specific VA profile

#### A. Direct Consumers to a Specific VA Page (vaRef)

Use the **vaRef** parameter to route consumers to a specific section of the Virtual Agent:

| VA 2.0 Page | Core Auto-Login Link | Parameter | Full Auto-Login Link |
| --- | --- | --- | --- |
| Summary | ${debt.virtualAgentLoginUrl} | N/A | ${debt.virtualAgentLoginUrl} |
| Dispute | ${debt.virtualAgentLoginUrl} | ?vaRef=DISPUTE | ${debt.virtualAgentLoginUrl}?vaRef=DISPUTE |
| Payment | ${debt.virtualAgentLoginUrl} | ?vaRef=PAYMENT | ${debt.virtualAgentLoginUrl}?vaRef=PAYMENT |
| Details | ${debt.virtualAgentLoginUrl} | ?vaRef=INFO | ${debt.virtualAgentLoginUrl}?vaRef=INFO |
| Contact Us | ${debt.virtualAgentLoginUrl} | ?vaRef=MESSAGE | ${debt.virtualAgentLoginUrl}?vaRef=MESSAGE |
| Document | ${debt.virtualAgentLoginUrl} | ?vaRef=DOCUMENT | ${debt.virtualAgentLoginUrl}?vaRef=DOCUMENT |
| Settlement **(For Email)** | ${debt.virtualAgentLoginUrl} | ?vaRef=SETTLEMENT | ${debt.virtualAgentLoginUrl}?vaRef=SETTLEMENT |
| Settlement **(For Text)** | ${debt.virtualAgentLoginUrl} | ?vaRef=STM | ${debt.virtualAgentLoginUrl}?vaRef=STM |

> [!NOTE]
> TIP: Use ?vaRef=SETTLEMENT for emails and ?vaRef=STM for text messages to optimize delivery and compatibility.

#### B. Apply Virtual Agent Preferences (vaPrefID)

To apply a specific VA 2.0 preference profile, add the vaPrefID parameter.

For Example**:** ${debt.virtualAgentLoginUrl}?vaPrefID=[number]

**How to Find the vaPrefID**

- Go to the VA 2.0 profile page.
- The numeric ID is visible in the URL and in the data section at the bottom of the profile page.

![](https://cdn.document360.io/6c7303ca-5ffc-4149-8868-8ea498eee635/Images/Documentation/vaprefid.png?sv=2026-02-06&spr=https&st=2026-10-31T15%3A36%3A07Z&se=2026-10-31T16%3A36%3A07Z&sr=c&sp=r&sig=iEI12mF8Z9PLoXvoaZY44oqe9xk0IC6VFkrnitTPxz0%3D)

Image Displays VA PrefID in URL

#### C. Combine vaRef and vaPrefID

You can combine multiple parameters to control both the destination page and the preference profile applied.

To format the auto-login link use: ?vaRef=VALUE&vaPrefID=VALUE.

This format ensures parameters are appended correctly using **?** for the first parameter and **&** to chain additional parameters.

**For Example:**

To send consumers directly to the Payment page using a specific VA 2.0 Preference Profile, format the URL as follows:

```ruby
${debt.virtualAgentLoginUrl}?vaRef=PAYMENT&vaPrefID=1
```

![](https://cdn.document360.io/6c7303ca-5ffc-4149-8868-8ea498eee635/Images/Documentation/Screenshot 2025-05-16 153553.png?sv=2026-02-06&spr=https&st=2026-10-31T15%3A36%3A07Z&se=2026-10-31T16%3A36%3A07Z&sr=c&sp=r&sig=iEI12mF8Z9PLoXvoaZY44oqe9xk0IC6VFkrnitTPxz0%3D)

Image Displays Example Combined Parameters

> [!NOTE]
> Please Note:
> 
> When constructing the auto-login link, make sure to build the parameters carefully and test thoroughly to avoid misdirecting consumers or applying the wrong profile.

## Is it possible to customize the Auto-Login Link?

Yes. Customizing the auto-login domain can improve branding, user trust, and security. This feature requires a package add-on.

1. Go to **Setup → Company Profile.**
2. Locate the Company Section.
3. Enter your customized text in the following fields:
  1. URL
  2. Base Hostname

> [!NOTE]
> Please Note:
> 
> Ensure your subscription includes the necessary package add-on. Contact sales@interprose.com for assistance.

## Tracking the Source of Auto-Login Links in Text and Email

When a payment is made or a payment plan is created after logging in through the auto-login link (${debt.virtualAgentLoginUrl}), ACE automatically tracks the source of the login and associates it with the corresponding record.

- If the consumer accessed the link from a text message, the source will display as TEXT.
- If the consumer accessed the link from an email, the source will display as EMAIL.

The system also logs the associated source ID, which is:

- The Text Message Log ID for texts
- The Email Queue ID for emails

See [Payment Source Tracking in ACE](/v1/docs/payment-source-tracking-in-ace) for full details on how source tracking works across ACE.