Skip to content

Puzzel

Our integration for Puzzel enables you to manage your customer satisfaction and work with P-GAP, without ever leaving your Puzzel platform. Below is a complete guide on how to implement the solution:

Showcase of Puzzel
Puzzel showcase

Prerequisites

Admin set up

  1. Go to Puzzel admin portal
  2. Navigate to Widget Administration and add widget
    1. Name and Title should be "nps.today"
    2. Url should be "https://puzzel.nps.today"
    3. Make sure Handshake and Allow to get Puzzel access token are set to ☑️
    4. Type should be "Widget"
    5. Click Add widget
  3. Unfold the settings for the newly created widget and click Add widget property
    1. Key should be "APIkey"
    2. Default Value is your api keys from app.nps.today
    3. Type should be "Password"
  4. Navigate to Tab Configuration and add tab
    1. Call it "nps.today", and click Save changes
    2. Click the newly created tab, and click Insert a widget
    3. Find "nps.today" and click Add widget and then Save changes
    4. Click JSON Editor
      1. Replace "options" with the json-snippet further down (optional: keeps the widget open all the time on the agents puzzel view)
      2. Replace "header" with the json-snippet further down
    5. Click Apply then yes then Save
  5. Navigate back to Tab Configuration
    1. If the entire company should use the widget
      1. Click ☑️ at "nps.today" under Company/Inherit
      2. Set the value to on
    2. If only a user group should use the widget
      1. Click ☑️ at "nps.today" under Selected User Group/Inherit
      2. Set the value to on
    3. If only a user should use the widget (e.g. for testing)
      1. Select the User Group the user is in
      2. Click ☑️ at "nps.today" under Selected User/Inherit
      3. Set the value to on
  6. The widget should now pop up next time an agent logs in at agent.puzzel.com. 🎉

If you want to send out surveys when the call has ended, you need to make a link between your campaign(s) and queue(s) in Puzzel.

  1. Go to the Puzzel admin portal and find the queue keys needed, or go to developer.puzzel.com and call this endpoint to get a list of all your queues.
  2. Now go to the IVR section on app.nps.today, and click Add IVR, follow the guide to add the link.
  3. Confirm everything is working as planned by going to agent.puzzel.com and making a test call.

Adding P-GAP period

In order to test P-GAP period, the agent should be registered in app.nps.today. The first time the widget is used for sending out a survey, the agent will be created automatically.

  1. Navigate to the P-GAP section on app.nps.today
  2. Click Add training session and go through the guide, making sure the start and end date are set, so that today's date are included, and the correct campaign(s) are selected.
  3. Go to agent.puzzel.com and make a test call, to ensure that you get prompted with a P-GAP pop-up, when the call has ended.

By default, the call should be above 60 seconds in order to trigger a survey/P-GAP, this can be changed by contacting our support.

Configurations

"options": [
    {
        "key": "alwaysOpen",
        "value": true,
        "text": "Tab is always open",
        "typeId": 3,
        "enabled": true
    },
    {
        "key": "leftTabset",
        "value": false,
        "text": "Default opened in left tab-set",
        "typeId": 3,
        "enabled": true
    }
],
"name": "nps.today",
"singleton": true,
"header": {
    "title": "nps.today",
    "info": null,
    "icon": null,
    "iconClass": "fa-solid fa-square-poll-vertical",
    "class": null,
    "color": "#000000"
},

FAQ

Settings have not applied

Be sure to reload the Puzzel pages when making a change on app.nps.today. This is due to the settings getting synced when reloading the page.

Video showcase