Hookme Link

How to Use the 'hookme' Link to Extract User Attributes and Redirect with Parameters

The "hookme" link provides an efficient way to extract user-specific attributes and redirect users to a specified URL with these attributes appended as parameters. This guide explains how the "hookme" link works, its structure, and how to utilize it effectively using the example link below:

Understanding the Structure of the Hookme Link

Base URL:
The core of the link is https://vt.lightspeedvt.com/hookme.cfm, which serves as the endpoint to initiate the process.

Params Parameter:
The "params" parameter specifies the user attributes to be fetched and included in the redirection.

Allow Attributes:

• username: The user’s username.
• password: The user’s password is encrypted using AES 128 (use with caution for security reasons).
• email: The user’s email address.
• firstname: The user’s first name.
• lastname: The user’s last name.
• GlobalUserID: A unique identifier for the user.
• LocationName: The name of the location the user account belongs to.
• LocationID: The user’s location identifier.

hook_url Parameter:
The hook_url specifies where the user is redirected after their attributes are retrieved.
In this example, the URL is https://google.com.

How It Works

Request and Attribute Extraction:
When the link is accessed, the system processes the params parameter and fetches the specified attributes for the user.

Appending Attributes to the Redirect URL:
The system appends the extracted attributes as query string parameters to the hook_url.

Redirection:
The user is seamlessly redirected to the hook_url with the attributes included in the query string.

Practical Applications

Personalization:
Tailor the user experience by passing attributes to the destination page. For example, you can greet users by their first name or display their location-specific information.

Data Integration:
Easily integrate user data into external systems or third-party tools by including relevant attributes in the redirected URL.
Analytics and Campaigns:

Track user data for analytics purposes, such as campaign performance or user demographics, by including unique identifiers like GlobalUserID.

How to Customize the Link

Choose Relevant Attributes:
Adjust the params parameter to include only the attributes you need.

Specify the Redirect Destination:
Set the hook_url to the desired destination.