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: 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.  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).

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

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:

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.

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:

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

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

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 for full details on how source tracking works across ACE.