How To Deploy

Connecting To The Web Client

The web client is accessed by opening a browser window to the url for the webClient.html file, with parameters for the queue to hit, and optionally the user connecting to the chat.

The URL for the web client might look something like:
http://<SERVERFQDN>/ITFramework/ChimeClient/webClient.html?userName=Dispatcher%20UserName

The userName parameter should be the Sametime ID for the dispatcher account for the queue to contact. If there are spaces in the Sametime ID, those spaces should be encoded with the characters:%20.

Connecting with a user Sametime ID

If a user is authenticated into an internal page and you have access to their Sametime ID, it is possible to connect with a queue using their Sametime ID by passing an additional parameter stid to the web client URL.

The full URL might look something like:
http://<SERVERFQDN>/ITFramework/ChimeClient/webClient.html?userName=Dispatcher%20UserName&stid=SeekerID

If hashedUsernames is set to true, you will need to Base64 encode the name before passing it to the URL.
http://<SERVERFQDN>/ITFramework/ChimeClient/webClient.html?userName=Dispatcher%20UserName&stid=U2Vla2VySUQ=

Encoding the Seeker username

The web client uses native JavaScript to Base64 encode and decode the username.

        
            var seekerUsername = "James T. Kirk";
            seekerUsername = window.btoa(seekerUsername);
        
        

Opening the web client using JavaScript

To open the web client, first we need to know a few values.

clientAddress	The URL where the web client is hosted
queue	The Sametime ID of the dispatcher for the queue
seekerUsername (optional)	The plain text or Base64 encoded Sametime ID for the user accessing the web client

Here is an example on how you might open a chat session with a queue. This example assumes you have jQuery on your page.

        
            <a href="#" class="start-chat">Chat now!</a>

            <script type="text/javascript">
            var clientAddress = "//chime.company.domain/ITFramework/ChimeClient/webClient.html";
            var queue = "Helpdesk%20Support";
            var seekerUsername = "James T. Kirk";
            seekerUsername = btoa(seekerUsername);

            $(".start-chat").on("click", function(){
            window.open(clientAddress + "?userName=" + queue + "&stid=" + seekerUsername, "_blank");
            });
            </script>