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/ |
| 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
Limited to one campaign per flow, that is you cannot subscribe to multiple campaigns in one flow
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
|
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 |