797 views | Last updated on Mar 27, 2020 collaboration
Custom Service Rollover allows you to preferentially display a chat box for one queue over another in order to route your guests to the most appropriate staff. With a Home Team First collaborative service, a typical service model looks like this:
Each library will create users and at least one queue to handle its own chats. We'll call this queue the home-library queue for the sake of example.
The users participating in your collaboratively-staffed service will be assigned to an additional queue. We'll call this queue our-collaboration.
In order to best answer incoming questions, the librarians participating in the collaboration might need contextual information about the incoming chats. This kind of context is provided by profile pages and avatars.
Profile pages assist staff while they are answering chats. Librarians access profile pages from within the webclient, by clicking on the guest's avatar within the chat. The avatar is a small, square image that provides a visual identity for each incoming chat.
For the those assisting patrons from libraries other than their own, profiles will be used for basic information, such as your library's website and catalog URLs, telephone numbers, links to policies, tricks for typical kinds of access problems encountered by students, how to handle in-building complaints, etc...
To edit profile pages, first login to the admin dashboard as an admin user. Then, go to the Queues management page, selected the desired queue, and edit your profile pages using the built-in basic HTML editor.
To define a custom avatar, email the image file and queue name to email@example.com. The image will display at 40 x 40 pixels, but if you provide an image with different dimensions, it will get scaled to 40 x 40 automatically.
If no queue custom avatar is set, the following default avatar is provided:
By default, a queue is associated with its own profile. That is, if the operator clicks on an avatar for a chat from the home-library queue, they will receive the home-library profile.
But in the case of a collaboratively-staffed service, we might want to show a profile for a queue other than the one the patron is chatting with. That is, the patron will be chatting with the our-collaboration queue, but we need the answering librarian to see the profile for the home-library queue. This is done with a simple code modification.
Example avatar for the home library queue for an incoming chat on the our-collaboration queue.
Clicking the HOME LIB avatar image will take the operator to the profile for the home-library queue.
The following direct URL will trigger the webclient to display the avatar and profile page for the home-library queue even though the chat is coming in over the our-collaboration queue:
You can create your service rollover and from within the Chat Snippets (Services) management page in the admin dashboard.
Use the Add service rollover button to add service layers.
If any queues in your service layers are outside your own account, you can add them in by editing the service level code. You can access that area through the Advanced code edit icon. To use a queue outside your own account, change the Jabber ID and direct URL to reflect the desired queue name.
Advanced code edit button
Also while editing the service level code, you can add your profile variable as needed.
Adding the home-library profile for the our-collaboration queue
Note: If you opt not to use the Chat Snippets management page, you can modify the following code and use it instead of the chat snippets that are generated using the Chat Snippets management page.
The direct URLs in the service levels for the our-collaboration queues also need the profile argument described above.
The following code is heavily commented and can easily be modified by staff with a basic understanding of HTML.
Example code for different chat box behaviors:
Please feel free to contact LibraryH3lp support (firstname.lastname@example.org or 877-844-5371) for more assistance with this code.