[SalesForce] Capture URL of webpage containing Live Agent chat button

We are implementing Live Agent with a pre-chat form to capture and display information from the customer. The pre-chat form works great but we also want capture the URL the customer was on when they clicked the chat button.

I added some JavaScript to pass in this detail from the webpage.

liveagent.addCustomDetail('URL', window.location.href);

This works fine from a test HTML page on my desktop, but when we put the code on our testing website the URL doesn't get passed through.

On the webpage the code is in the <body> tag and looks like this.

<script type="text/javascript">
    if (!window._laq) { window._laq = []; }
    window._laq.push(function(){
        liveagent.showWhenOnline('573XXXXXXXXXXXX', document.getElementById('liveagent_button_online_573XXXXXXXXXXXX'));
        liveagent.showWhenOffline('573XXXXXXXXXXXX', document.getElementById('liveagent_button_offline_573XXXXXXXXXXXX'));
    });
</script>
<script type='text/javascript' src='https://c.la3-c2cs-chi.salesforceliveagent.com/content/g/js/37.0/deployment.js'></script>

<script>
    // liveagent.addCustomDetail('URL', window.location.href); Doesn't work either
    window.onload=liveagent.addCustomDetail('URL', window.location.href);
</script>

<script type='text/javascript'>
    liveagent.init('https://d.la3-c2cs-chi.salesforceliveagent.com/chat', '572XXXXXXXXXXXX', '00DXXXXXXXXXXXX');
</script>

I'm not JavaScript wiz so I'm not sure if/how much placement matters.

Also using FireFox firebug I see this error when I refresh the page

ReferenceError: liveagent is not defined

I suspect this is caused by the addCustomDetail function but I'm not sure exactly how to find exactly where it is happening.

Best Answer

So I managed to solve my problem with the following bit of JavaScript code.

<script>
    document.addEventListener
    (
        'DOMContentLoaded',
        function(event)
        {
            liveagent.addCustomDetail('URL', window.location.href);
        }
    );
</script>

That captured the URL and passed it

Related Solutions

[SalesForce] Live Agent- Pre-Chat

The syntax you have to find an existing record looks correct. I assume that you have a button somewhere or something to actually submit the form.

You haven't specified what to create if it isn't found. You do that with the map.doCreate method. The doFind alone does not create a new record. If it doesn't find anything the console just stays on the Visitor Details page. I think you'll need to specify a LastName as well since that's required on Contact. You don't have to search by that though, if you don't want to. The way that the Pre-Chat API works is that it will try to find with the doFind and then if not found will actually create the record with the doCreate. It doesn't just take you to a new record screen with values filled in. It actually creates, so you need required fields. Here's a snippet that should do it:

<form method="post" id="prechatForm" action="{!endpoint}"> > 
    <input type="text" name="liveagent.prechat:Email" value="{!formEmail.value}"/>
    <input type="text" name="liveagent.prechat:LastName" />

    <input type="hidden" name="liveagent.prechat.findorcreate.map:Contact" value="Email,Email;LastName,LastName;" />
    <input type="hidden" name="liveagent.prechat.findorcreate.map.doFind:Contact" value="Email,true;" />
    <input type="hidden" name="liveagent.prechat.findorcreate.map.isExactMatch:Contact" value="Email,true;" />
    <input type="hidden" name="liveagent.prechat.findorcreate.showOnCreate:Contact" value="true" /> 

    <!-- specify that the created record should have email and last name on it -->   
    <input type="hidden" name="liveagent.prechat.findorcreate.map.doCreate:Contact" value="Email,true;LastName,true;" />

    <!-- Save the Contact to the Lookup field on the Live Chat Transcript -->
    <input type="hidden" name="liveagent.prechat.findorcreate.saveToTranscript:Contact" value="Contact" />

    <input type="submit" value="Request Chat" />
</form>

Also, it could be the endpoint variable is wrong or the value of formEmail.value not what you expect it. You can double check the Email custom detail that was submitted on the Visitor Details in the console when you accept the chat or the mouseover pop out of the chat before you accpet it on the request panel.

You can read more about the Live Agent Pre-Chat API in a detailed article I just posted. It steps through code for a contrived Pre-Chat form that collects input, searches for a Contact, creates one if not found, creates a Case, links the Contact to the Case, and the Case and Contact to the Live Chat Transcript record.

[SalesForce] Live Agent Post Chat Page

Information about the chat is sent via a POST to the post-chat page. The simplest solution would probably be to inspect the transcript field. If it is empty, there were no messages sent.

In Apex, that check would be String.isEmpty($CurrentPage.parameters.transcript)

Check out the post-chat page section of the Live Agent Developer Guide for a list of all the other fields that are passed (in the format of an example VF page that outputs the values): http://www.salesforce.com/us/developer/docs/live_agent_dev/index.htm

Related Topic