Last updated May 11th, 2022.
Zendesk Talk - Partner Edition
To use the Puzzel integration, you must have “Zendesk Talk - Partner Edition”.
Puzzel account and Puzzel Zendesk SDK add-on
You must have a Puzzel account as well as the Zendesk SDK add-on enabled in Puzzel in order to use the integration as.
Agents must have the rights to add, edit and delete users, otherwise, no user will be created when a user, that does not already exist in Zendesk, calls in. If no user is created, a ticket will not be created for the call. The rights are changed in the Admin Center: Go to People > Roles. Click edit on the role you want to update. In the People section, select “Add, edit and delete all" in the “What access does this agent have to end-user profiles?” dropdown.
As the application uses local storage, third-party cookies must be allowed, otherwise, the application will not work. In Chrome, this setting can be changed by typing chrome://settings/cookies in the address bar and then select either "Allow all cookies" or "Block third-party cookies in incognito".
When installed, the Puzzel integration can be found in the navigation bar (left) and the top bar.
Logging into the Puzzel App
To log into Puzzel in Zendesk Support, go to the navigation bar on the left. Type in your credentials and click the “Login” button. If the credentials are not valid, you will be shown an error message under the button. If the login was successful, you will be directed to the overviews.
- The customer number is your company’s Puzzel customer number.
- The username is your Puzzel username.
- The password is your Puzzel password.
In the navigation bar location there is access to three different overviews:
- Queue Overview
- Team Overview
- Agent Ticker
All the overviews automatically update the data every 15 seconds. However, you can manually update an overview by clicking the refresh icon in the top right corner of the overview. You can also log out of the application from the navigation bar.
In this overview, you can see data such as the size of the queue, the number of agents available, busy and away, and calls offered and answered. You can click the number of agents in each agent column to get a more detailed overview of who they are, their current status, and time spent in the specific status. In the overview of active agents, you can also see the agent’s phone number, group and profile. When hovering over the number of agents away, you are able to see the number of agents per pause type.
This is similar to the agents away overview. It just displays data for people away in your group.
This overview gives you access to your personal Puzzel data such as time logged in, time used per pause type, and call information for each of the queues you have been taking calls from.
The call handling part of the application can be found in the top bar of Zendesk Support.
Logging on a profile
To log on to a profile, open the application in the top bar.
To log on using a mobile or landline phone, type in the phone number of the phone you want to use. If you want to log on using Puzzel’s softphone, leave the field blank.
From the profile drop-down, select the profile you want to log on to. If you want log on in a pause status, select a status from the status drop-down. Leaving the field blank will log you on as available. Click log on.
When logged on to a profile you can set your pause status from within the application. This is done from the drop-down at the top of the view. You can also set yourself as available again and log off the profile from this dropdown.
Call comes in
When a call comes in, you are presented with a view displaying the name and phone number of the caller. To see how to accept a call using a phone or softphone, read the next section.
Using a mobile or a landline phone
If you are logged on using a mobile or landline phone, you will have to accept the call on the phone itself or via a headset connected to the phone. Afterwards, the view will display an ongoing call and call functionalities.
Using the Puzzel softphone
If you are logged on using Puzzel’s softphone, you will be able to accept the call from inside Zendesk using a Pick up button that will be available next to the Decline button in the above view. Afterwards, the view will display an ongoing call and call functionalities.
To transfer the ongoing call, click the transfer button. You will then be presented with a dropdown and an input field. In the dropdown, you select the source for the transfer. Based on the selection, you then do a search in the input field by typing in the name of either the queue, agent, or catalog contact you want to transfer the call to. If 'Phone' is selected, simply type in the phone number. When you have found who or what to transfer to, click the arrow. You are now disconnected from the call and presented with a wrap-up view (explained further below in this article).
Making consultation call
To consult someone when on a call, click the consult button. You will then be presented with a dropdown and an input field. In the dropdown, you select the source for the consultation. Based on the selection, you then do a search in the input field by typing in the name of either the agent or catalog contact you want to consult. If 'Phone' is selected, simply type in the phone number. When you have found who or what to consult, click the arrow. The caller is put on hold and the agent, catalog contact or phone number is being called. To transfer the call, click the transfer button that will appear at the bottom after the arrow has been clicked. To end the consultation and go back to the caller, click the consult button again.
The search will only list agents available at the time you clicked the consult button, while it will show all catalog contacts no matter their availability status.
Receiving consultation call
Receiving a consultation call is like receiving other calls. You, therefore, have to accept the call as described further up.
When the consultation call comes in, you will be shown the name of the agent calling you. When accepted, you are presented with a view displaying the agent name and call queue. You are not able to hang up the call, so for the consultation to end, the agent who called you must hang up or transfer the call. If they end the consultation, the wrap-up view will be shown, and if they transfer the call to you, the call will be shown.
To mute a call, click the microphone in the top right corner. When the microphone is red, the call is muted. Click the icon again to un-mute the call.
Hang up call
To end a call, click the “Hang up” button. The call will also end if the callee hangs up. Whether it is you or the callee who hangs up, you will be presented with a wrap-up view.
After a call is ended, you will see a wrap-up view with a counter that counts down. To get more wrap-up time, click the “Add time” button, and one minute will be added to the counter. When the counter reaches 0 you will be set as available and ready for new calls. If you are finished before the counter has finished, click the “Set available for new calls” button.
The call functionalities for an outgoing call are the same as for an incoming call. There are two ways of making an outgoing call: Type to call and Click-to-Call.
Type to call
When you are not on a call, you have the option to make an outgoing call by typing in a phone number you want to call. You can either type using the numbers on your keyboard or by using the dial pad in the view. When you have typed in the number, click the “Make a Call” button. If you are using a mobile or landline phone, you will have to accept the outgoing call from your phone (just like you would do it with an incoming call) before a callout to the number happens. The same goes for Puzzel’s softphone, where you also have to accept the call first.
Another way of doing an outgoing call is to click the phone numbers in user profiles or at the top of a ticket if a phone number is connected to the end-user. Click the number and you will see an option to call the number. Click this button and an outgoing call will be made to the number. Here you will also have to accept the call on either your phone or in Puzzel’s softphone before you actually call out.
From user profile
When an outbound call is made from the user profile a new ticket will be created.
If an outbound call is made from inside an existing ticket, the ticket will be updated with an internal comment saying that an outbound call has been made and what number has been called.