---
title: "Generating QR Code for Auto-Login Link to Virtual Agent"
slug: "generating-qr-code-for-auto-login-link-to-virtual-agent"
updated: 2024-10-21T19:22:20Z
published: 2024-10-21T19:22:20Z
canonical: "docs.interprose.com/generating-qr-code-for-auto-login-link-to-virtual-agent"
---

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

# Generating QR Code for Auto-Login Link to Virtual Agent

This guide outlines the process of inserting a QR code for auto-login link to VA or VA 2.0 within local print letters.

## Benefits of the Auto-Login Link

With the Auto-Login Link, consumers can:

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

Consumers are required to register an account if they wish to create a payment plan.

> [!NOTE]
> Note
> 
> The QR code is generated by integrating the **virtualAgentLoginQrCode** field into letter templates.

## Setup Overview

1. Download a fresh copy of the ACE Letter Data Source and re-register the database.
2. Create a new letter template or modify an existing one.
3. Insert the virtualAgentLoginQrCode (found in the debt table).
4. Upload the new/modified templates in the Letter Profiles.
5. Test the QR Code.

### Download a New Copy of the ACE Letter Data Source

For detailed instructions, refer to [Configuring the Letter Data Source](/v1/docs/configuring-the-letter-data-source) documentation.

1. Open any account in ACE to allow for testing and template validation.
2. Navigate to **Help → Layout → Letter Data Source**.
3. Click on "Download Letter Data Source"
4. Save the downloaded file (default name: ACE.ods) to your computer.

![](https://cdn.document360.io/6c7303ca-5ffc-4149-8868-8ea498eee635/Images/Documentation/Screenshot 2024-02-14 092629.png?sv=2026-02-06&spr=https&st=2026-10-31T14%3A34%3A12Z&se=2026-10-31T15%3A34%3A12Z&sr=c&sp=r&sig=F6bOOMC2pQpc7P0P9I47v9B7KEaOR%2BgH2h1gr5HkqaE%3D)

Image Displays Step 2

### Register the Database

1. Open LibreOffice: **File → New → Database**
2. In the Database Wizard:
  1. Choose “Select Database” on the left section.
  2. Select “Connect to an existing database” and choose “Spreadsheet.”
3. Follow the prompts:
  1. Next → Browse (select ACE.ods) → Next → Finish.
  2. Change the file name to "ACE.ods" and remember its location.
  3. Go to File → Exit to conclude your session.

### Create New Letter Template or Modify Existing Letter Template

To modify an existing letter template:

1. Go to **Setup → Letter → Profiles.**
2. Select the Letter Profile.
  1. Click on the cloud icon to download the template in the Template File Field.
3. Open the Template in LibreOffice.
4. Go to **View → Data Source**
5. Select the database and click on tables:
  1. Locate and click on ‘debt’
  2. Scroll through the table and locate **virtualAgentLoginQrCode** field
  3. Drag the field into your template
6. Go to **File → Save**.

For comprehensive documentation refer to:

- [New Letter Template and Associated Letter Profile](https://docs.interprose.com/docs/creating-a-new-letter-template-and-letter-profile-in-ace)
- [Locating Fields to Add in the Letter Template](https://docs.interprose.com/docs/creating-a-new-letter-template-and-letter-profile-in-ace#locating-fields-to-add-to-the-letter-template)

![](https://cdn.document360.io/6c7303ca-5ffc-4149-8868-8ea498eee635/Images/Documentation/virtualAgentLoginQrCode.jpg?sv=2026-02-06&spr=https&st=2026-10-31T14%3A34%3A12Z&se=2026-10-31T15%3A34%3A12Z&sr=c&sp=r&sig=F6bOOMC2pQpc7P0P9I47v9B7KEaOR%2BgH2h1gr5HkqaE%3D)

Image Displays Steps 6a-c

### Upload the modified letter template

1. Go to **Setup → Letters → Profiles.**
2. Select the Letter Profile:
  1. Click Choose File to upload the modified letter template.
3. Save

![](https://cdn.document360.io/6c7303ca-5ffc-4149-8868-8ea498eee635/Images/Documentation/Screenshot 2024-02-14 093321.png?sv=2026-02-06&spr=https&st=2026-10-31T14%3A34%3A12Z&se=2026-10-31T15%3A34%3A12Z&sr=c&sp=r&sig=F6bOOMC2pQpc7P0P9I47v9B7KEaOR%2BgH2h1gr5HkqaE%3D)

Image Displays Step 2a

### Testing the QR Code

1. Open a test account.
2. Go to Letter Actions on the Account Sidebar.
3. Select Send Letter.
4. Select the Letter Profile template to test (e.g., QR Code Letter for Auto-Login Link).
5. Locate the Options Section:
  1. Select PDF for the Output Vendor
  2. Click Print
6. Review the PDF and scan the QR code to test.

![](https://cdn.document360.io/6c7303ca-5ffc-4149-8868-8ea498eee635/Images/Documentation/Screenshot 2024-02-14 094115.png?sv=2026-02-06&spr=https&st=2026-10-31T14%3A34%3A12Z&se=2026-10-31T15%3A34%3A12Z&sr=c&sp=r&sig=F6bOOMC2pQpc7P0P9I47v9B7KEaOR%2BgH2h1gr5HkqaE%3D)

Image Displays Steps 4-5b

## Tracking The Source of Virtual Agent Linking from QR Codes

The Source and Source ID fields can be found in SQL Reports for tracking and analysis purposes.

When a QR code is used from an ACE local print letter:

- The Source field will store “LETTER” and the Source ID field will store the unique account Letter ID.
- These details will be stored in the virtual_agent_session and payment_plan tables/views if a payment or payment plan is set up during the session.

> [!NOTE]
> Note
> 
> When a consumer logs in with the QR Code and does not complete the log in authentication (in this example, with DOB), the VA session record will still be created.