Agent alerts and integrations can display variable information originating either from the LivePerson system, or from custom variables.


To use variable data in alerts and integrations, you embed control sequences called 'macros'

The macro is inserted between curly brackets { }, for example:
  • {LPINFO!current-title} - displays the title of the current web page
  • {LPVAR!Company} - displays the value of a "Company" custom variable defined in your web page

emptyStringNOTE: If a visitor ends a chat and starts a new chat during the same visit, the macro values are carried over from the first session.

To force the macros to be re-evaluated on each subsequent chat, add “~” to the macro name. Example: {~LPINFO!rt-session-id}

In addition, you can use the "!" symbol as a silencer. Normally, the name of the macro is shown if the variable has no value.  Using the ! silencer,  nothing is displayed if the value of the custom variable has not been set. Example: !{LPVAR!Section}.

Custom variable information
Custom variable data - varname should be defined on the web page and passed to LivePerson. Variables can also be set using rules.
Visitor session information
URL of the visitor's current page
Title of the current page
Number of days since the last chat session of this visitor
Number of days since last visit of the visitor to the site
The referring URL (link that referred the visitor)
Number of seconds visitor has been in the site
Number of minutes visitor has been in the site
Number of seconds the visitor has spent on the current page
Visitor's browser type  (user agent)
Session ID of the current chat session
LivePerson Account/User Details
Your LivePerson account number
Agent's nickname as it appears to visitors in chat
Agent's login Name used to log into the Admin Console
Agent's display name as it appears in the Admin Console and transfer window
Visitor Geolocation Details
(all details based on IP address)
IP address
Host name
Connection type
Postal/zip code
Time zone