- Print
- PDF
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
The QR code is generated by integrating the virtualAgentLoginQrCode field into letter templates.
Setup Overview
Download a fresh copy of the ACE Letter Data Source and re-register the database.
Create a new letter template or modify an existing one.
Insert the virtualAgentLoginQrCode (found in the debt table).
Upload the new/modified templates in the Letter Profiles.
Test the QR Code.
Download a New Copy of the ACE Letter Data Source
For detailed instructions, refer to Configuring the Letter Data Source documentation.
Open any account in ACE to allow for testing and template validation.
Navigate to Help → Layout → Letter Data Source.
Click on "Download Letter Data Source"
Save the downloaded file (default name: ACE.ods) to your computer.
Register the Database
Open LibreOffice: File → New → Database
In the Database Wizard:
Choose “Select Database” on the left section.
Select “Connect to an existing database” and choose “Spreadsheet.”
Follow the prompts:
Next → Browse (select ACE.ods) → Next → Finish.
Change the file name to "ACE.ods" and remember its location.
Go to File → Exit to conclude your session.
Create New Letter Template or Modify Existing Letter Template
To modify an existing letter template:
Go to Setup → Letter → Profiles.
Select the Letter Profile.
Click on the cloud icon to download the template in the Template File Field.
Open the Template in LibreOffice.
Go to View → Data Source
Select the database and click on tables:
Locate and click on ‘debt’
Scroll through the table and locate virtualAgentLoginQrCode field
Drag the field into your template
Go to File → Save.
For comprehensive documentation refer to:
Upload the modified letter template
Go to Setup → Letters → Profiles.
Select the Letter Profile:
Click Choose File to upload the modified letter template.
Save
Testing the QR Code
Open a test account.
Go to Letter Actions on the Account Sidebar.
Select Send Letter.
Select the Letter Profile template to test (e.g., QR Code Letter for Auto-Login Link).
Locate the Options Section:
Select PDF for the Output Vendor
Click Print
Review the PDF and scan the QR code to test.
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
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.