Share via


nps.today (Preview)

The nps.today connector allows you to send out customer satisfaction and NPS surveys based on events in your own system and to get your own system notified whenever a new response or survey campaign member is added.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name nps.today Support
URL https://nps.today/en/support/
Email support@npstoday.com
Connector Metadata
Publisher nps.today
Website https://nps.today/en
Privacy Policy https://nps.today/en/about-us/general-terms/cookies-and-privacy/
Categories Sales and CRM

Prerequisites

In order to use this connector you need a paid service plan at nps.today

How to get credentials

To get an API-Key you need to go to https://app.nps.today

  • Use your login
  • Go to the "Relations" tab
  • Click "My Information"
  • Click on the small cogwheel and choose API-Keys
  • Add API key

Getting started with your connector

When you have your API-Key you can use it with the connector to send out surveys and get events whenever a new member is added to a campaign or when a member turns in a response. For example you could choose to send out a survey whenever a deal is won or get notified by mail when a customer has responded to a survey.

To Send out a survey:

  • Choose a suitable trigger from your system
  • Choose the "Send Survey" action
  • Populate the field with the relevant information, name, email, etc. from your trigger.

To Add an employee to the nps.today platform:

  • Choose a suitable trigger from your system
  • Choose the "Add Employee" action
  • Populate the field with the relevant information, name, email, etc. from your trigger.

To set up a "New Response" trigger:

  • Choose "Subscribe to New Response being added" as your trigger
  • Choose the campaign you want to subscribe to from the dynamic dropdown
  • Choose an action to happen when the triggered for example send an email and fill out with the information you wish from the trigger response

To set up "New Campaign Member" trigger:

  • Choose "Subscribe to New Campaign member being added" as your trigger
  • Choose the campaign you want to subscribe to from the dynamic dropdown
  • Choose an action to happen when the triggered for example send an email and fill out with the information you wish from the trigger response

Known issues and limitations

  1. Limited to one campaign per flow, that is you cannot subscribe to multiple campaigns in one flow

  2. Only one subscription to a campaign per triggertype, that is you cannot have multiple subscription to a new response to the same campaign

Common errors and remedies

If values does not seem to be returned from the trigger, make sure that the values are populated in the relevant survey for example, additional answers will not be populated if they are not asked, however the field will still be accessible in the flow setup.

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
APIKey securestring API key to connect to nps.today True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Add Employee

Adds an employee to your organization on the nps.today platform

Send Survey

Add a respondent and send a survey to that person

Add Employee

Adds an employee to your organization on the nps.today platform

Parameters

Name Key Required Type Description
email
email string

The employee's email address

firstName
firstName string

The employee's first name

lastName
lastName string

The employee's last name

title
title string

The employee's title

department
department string

The employee's department

team
team string

The employee's team

division
division string

The employee's division

phoneNumber
phoneNumber string

The employees phone number

active
active boolean

A true or false value describing whether the employee can be contacted

Returns

Send Survey

Add a respondent and send a survey to that person

Parameters

Name Key Required Type Description
Campaign ID
campaign True string

The campaign ID related to the survey

emailAddress
emailAddress string

The email address of the respondent

firstName
firstName string

The first name respondent

lastName
lastName string

The last name of the respondent

phoneNumber
phoneNumber string

The phone number of the respondent

Triggers

Subscribe to new Campaign Members being added

This triggers when a new campaign member is added and returns associated information about that new campaign member

Subscribe to New Responses being added

Triggers when a new response is recieved

Subscribe to new Campaign Members being added

This triggers when a new campaign member is added and returns associated information about that new campaign member

Parameters

Name Key Required Type Description
Campaign ID
campaignId integer

The campaign you wish to subscribe the trigger to

Returns

Name Path Type Description
CampaignId
CampaignId integer

The ID number of the campaign

Address1
Respondent.Address1 string

The first address of the campaign member

Address2
Respondent.Address2 string

The second address of the campaign member

City
Respondent.City string

The campaign member's city of residence

Country
Respondent.Country string

The campaign member's country of residence

ZipCode
Respondent.ZipCode string

The zip code of the campaign member's city of residence

EmailAddress
Respondent.EmailAddress string

The email address of the campaign member

FirstName
Respondent.FirstName string

The first name of the campaign member

LastName
Respondent.LastName string

The last name of the campaign member

Active
Respondent.Active boolean

A true or false value describing whether the campaign member may be contacted, e.g. true means the campaign member may be contacted

Title
Respondent.Title string

The title of the campaign member

CompanyName
Respondent.CompanyName string

The company which the campaign member is associated with

EmployeeId
Respondent.EmployeeId integer

The ID number of the responsible employee

EmployeeEmail
Respondent.EmployeeEmail string

The email address of the responsible employee

Department
Respondent.Department string

The department of the campaign member

PhoneNumber
Respondent.PhoneNumber string

The phone number of the campaign member

ExternalId
Respondent.ExternalId string

The external id number of the campaign member

EmployeeExternalId
Respondent.EmployeeExternalId string

The external id of the responsible employee

SenderId
SenderId integer

The ID number of the sender

Custom
Custom string

This value contains custom values and is returned as a raw JSON

Subscribe to New Responses being added

Triggers when a new response is recieved

Parameters

Name Key Required Type Description
Campaign ID
campaignId integer

campaignId

Returns

Name Path Type Description
Id
Id integer

The ID of the response that is returned

Rating
Rating integer

The rating given by the respondent

Sender
Sender integer

The ID number of the sender

RatingTime
RatingTime string

The timestamp for when the rating was given

UserComment
UserComment string

The comment added by the respondent

CommentTime
CommentTime string

The timestamp for when the comment was made

SurveyOpenedTime
SurveyOpenedTime string

The timestamp for when the survey was opened

SurveySendTime
SurveySendTime string

The timestamp for when the survey was sent

SurveyScheduleTime
SurveyScheduleTime string

The point in time that the survey was scheduled for

Id
Respondent.Id integer

The respondent's ID number

Address1
Respondent.Address1 string

The first address of the respondent

Address2
Respondent.Address2 string

The second address of the respondent

City
Respondent.City string

The respondent's city of residence

Country
Respondent.Country string

The respondent's country of residence

ZipCode
Respondent.ZipCode string

The zip code of the respondent's city of residence

EmailAddress
Respondent.EmailAddress string

The respondent's email address

FirstName
Respondent.FirstName string

The first name of the respondent

LastName
Respondent.LastName string

The last name of the respondent

Active
Respondent.Active boolean

A true or false value describing whether the respondent may be contacted or not, e.g. true means the respondent may be contacted

Title
Respondent.Title string

The title of the respondent

CompanyName
Respondent.CompanyName string

The company associated with the respondent if any

Department
Respondent.Department string

The department at the company which the respondent belongs to

PhoneNumber
Respondent.PhoneNumber string

The phone number of the respondent

EmployeeId
Respondent.EmployeeId integer

The ID number of the responsible employee

EmployeeEmail
Respondent.EmployeeEmail string

The email address of the responsible employee

ExternalId
Respondent.ExternalId string

The external ID number of the respondent

EmployeeExternalId
Respondent.EmployeeExternalId string

The responsible employees external ID number

CampaignId
CampaignId integer

The ID number of the campaign

CampaignName
CampaignName string

The name of the campaign

Device
Device string

The device used to reply

Answer1
Answer1 string

The answer to the first of the voluntary follow up questions

Answer2
Answer2 string

The answer to the second of the voluntary follow up questions

Answer3
Answer3 string

The answer to the third of the voluntary follow up questions

Answer4
Answer4 string

The answer to the fourth of the voluntary follow up questions

Answer5
Answer5 string

The answer to the fifth of the voluntary follow up questions