Create New Service Provider Accounts (Current Version)
Note: These instructions are to create accounts using the current version of the Users management page. Steps to create accounts with the new version (currently in beta testing) will be made available in future.
Click the "My Service Providers" shortcut in the top left
Find the service provider in the list and click "edit" to edit their account
Under "Mailing Lists," select the "Unsubscribe" button to unsubscribe them from the appropriate lists
Click "Save" to save your changes
When the service provider returns to AskAway, simply resubscribe them to the mailing lists.
Delete an account
Please keep your list of service providers up to date.
To delete a service provider account, follow these steps (Note: Do NOT delete local coordinator accounts or accounts that may have belonged to a local coordinator. Instead, contact the Admin Centre and we will remove this account):
In the left-hand navigation, click Chat Snippets (the < > icon)
You should only see your library's chat snippets listed
Click on the snippet you would like to view (embedded chat box, button, or tab)
Copy the code in the grey box and paste it wherever you need to embed the widget
Note: The snippet embed code is identical for all libraries except for the unique snippet ID number. In the example below, the unique snippet ID number for this library's embedded chat box is 806 (in bold).
<!-- Place this div in your web page where you want your chat widget to appear. -->
<div class="needs-js">Chat loading...</div>
<!-- Place this script as near to the end of your BODY as possible. -->
x.src = (document.location.protocol === "https:" ? "https://" : "http://") + "ca.libraryh3lp.com/js/libraryh3lp.js?806";
var y = document.getElementsByTagName("script"); y.parentNode.insertBefore(x, y);
If you would like assistance customizing your library's AskAway entry point, please contact the Admin Centre and we'll be happy to help!
This FAQ covers how you can make changes to the appearance of your library's chat box when the service is online.
In the LibraryH3lp dashboard, this is done using what's called the chat skins tool.
Your library's chat service in LibraryH3lp has two major elements - a queue and a chat box skin. The queue is tied to your institution and determines how chats are routed. The chat box skin determines what the chat box looks like.
The chat skins tool is where you can change the appearance of the chat box that displays to students when the service is online.
Before making any changes to your library's chat skin, it's highly recommended that you first create a copy of your library's current skin so that you're not making changes to the chat box that is live and up on your websites. Creating a copy will also give you all of the customizations for the default AskAway widget, which is a highly customized version of the default LibraryH3lp chat box.
Navigate to the "Chat Skins"area in the left-hand menu (look for the paintbrush icon)
Select your library's widget from the "Widget:" drop-down (e.g. KPU AskAway watermark/feedback)
Note the 5-digit unique ID number (write it down)
Click "Copy Widget"
The widget is now copied and you should see a new unique ID beside the widget name
Change the name of the widget so that you can easily recognize it. For example, add Copy to the title or give it a descriptive name with your institutional acronym (e.g. KPU brand color)
Take note of the new widget ID number (write it down)
Click "Save Widget"
You now have a copy of your library's default chat skin and you can play around with it without affecting the appearance of the chat boxes that are live on your library's website.
There are several quick and easy changes that you can make to customize your library's chat box:
You may want to change this to something shorter and descriptive (e.g. Ask a Librarian, Research Help, Chat Now) as the longer title looks squished in some sidebars, especially in databases
Typing Notification Identity
You could change this to something more inclusive than Librarian (e.g. Library Staff)
Here you can change the color of the chat box. This color must be a hex color code. You may wish to change it to your institutional brand colors.
Wicked CSS Hack
Since AskAway chat boxes are highly customized, there are some things you'll have to change here instead of in the fields above.
Here are a few simple changes you could make to the wicked CSS hack code:
Search for the header "h1"
Beside color: you can enter a new color for the title (must be hex color code)
Sprites (these are the icons for volume, email for transcript, and to pop-out chat)
Search for "span.sprite"
In the png URL that follows, change to either light_sprite (this will be white) or dark_sprite (this will be black)
Search for "a#feedback"
Beside color: you can enter a new color for the feedback link (must be hex color code and change to either black #000000 or white #FFFFFF to match the sprites)
***Click "Save Widget" to save any changes***
You can preview most of the changes you make live in the chat skins tool. However, the preview chat box won't show all of the features (e.g. the feedback link is missing). To preview your changes and to see a fully rendered version of the chat box, follow these steps:
Click on the "Queues" area in the left-hand menu
Open the "AskAway Queues" folder
Click on your "institution's queue"
Open the "Queue URL" in a new tab
At the end of the URL, add the following: ?skin=##### (the #s will be the 5-digit skin ID of the chat skin you're working on)
When you reload the page, you'll see a rendered version of the chat box, with any changes you've made now visible
The offline message is the message that displays on chat boxes when the service is closed for the day or between terms.
Currently, the AskAway Admin Centre hosts a single offline message that displays for most libraries. The Admin Centre will change this message at the beginning and end of each term to reflect that the service is open or closed.
Customize your library's offline message
If your library would like the ability to customize and control the offline message, you will need to be able to host an HTML file on a secure (HTTPS) page. The URL for the offline message will then need to be updated in your library's chat snippet.
If you'd like to look into hosting your library's offline message, please contact the Admin Centre and we can work together to set this up.
Navigate to the "Chat Snippets" area in the left-hand menu (look for the < > icon)
By default, each library has three snippets:
Embedded chat box
In this FAQ, we'll cover how to make changes to the embedded chat box only, as this is the most commonly used snippet. If you'd like to make any changes to your library's chat button or tab, please contact the Admin Centre and we'll be happy to help.
Click your library's embedded chat box to select it
Click the "EDIT" button
Using widget #XXXXX:
If you'd like to change the chat skin that this snippet is using, click the chat box preview under "Routing for incoming chats"
Here you can select which chat skin you'd like to display for this snippet
Most local coordinators will login using their library's admin account (e.g. cotr-admin) unless your personal account has been set-up with local coordinator privileges. If you'd like to set-up your personal account with local coordinator privileges, please contact the Admin Centre.
When you're staffing AskAway, login to the LibraryH3lp Webclient: https://ca.libraryh3lp.com/webclient/client. Please login with your personal account (rather than the admin account) as this will help your colleagues recognize who's on shift with them and will make it easier to search and identify individual service providers in saved transcripts.
Some libraries may have more than one local coordinator account set-up in LibraryH3lp or may share a single local coordinator account. If this is the case at your library, it's okay for more than one person to be signed into the dashboard at the same time as long as you're not trying to edit the same chat skin or chat snippet simultaneously as edits could be overwritten.
Below are steps to customize your library's out of the box chat tab to make it more visible and inviting.
Default online appearance (note: your library's may be a different color):
Default offline appearance:
If your library would like to customize the main default color and/or wording that displays on your library's chat tab, please contact the Admin Centre and we will ask LibraryH3lp to implement this change. Additional enhancements are shared below.
Below, you'll find steps for making a number of changes to your library's chat tab to customize both its offline and online appearance. Local coordinators can make these changes themselves in the LibraryH3lp Dashboard or if you'd like assistance, the AskAway Admin Centre is always happy to help!
Offline message background color
When the service is offline and a user hovers over the chat tab, it will display the AskAway offline message. Currently, the default chat tab displays a message against a transparent background, so this will need to be changed to white so that it does not overlap with text on the library website.
Follow the steps below to make this change OR contact the AskAway Admin Centre and we can make this change for you: