Skip to content

Dalux Integration with nps.today

This integration lets you trigger automated customer satisfaction and loyalty surveys in Dalux, without manual processes, without switching between systems, and without a large IT project.

🔄 Trigger

A survey is triggered when a Work Order is set to “Complete, close”.

Completed work order

This integration uses timer trigger.

  • Every day at 00:00, the trigger uses the Dalux API to pull data from your Dalux instance.
  • The trigger filters Work Orders closed more than 1 day and 1 hour ago.
  • These Work Orders will be sent at the send-out time decided in the in the "Set-up in nps.today" section.
Surveys scheduled in the past?

If surveys are scheduled for a past it will be sent right away. But since processing is starting midnight we expect to only generate it for the upcoming day

🧠 Filter and Save Logic

For each Work Order:

  • It is processed based on company, work order, and date it was closed.
  • Checks for a unique pair (workorderId, closed date).

⚙️ Set-up in nps.today

To connect your Dalux instance with nps.today:

Go to your Dalux integration in nps.today. - If this is not available, please contact [email protected].

Under “Configuration”, add the following information:

  • API Key: Your Dalux API key

    • If you can't find the API key, please contact your Dalux Administrator.

  • Campaign: Select the campaign in nps.today you want to trigger surveys from.

  • Sendout Time: Choose when the survey should be sent (in UTC time).

Click “Save”.

Dalux set-up

☁️ Data

When pulling data from Dalux, we save data from the Work Order.

Respondent Data

  • Email address
  • Phone number
  • Name

Employee Data

  • Email address
  • Name

Custom data

See Dalux custom data saved to nps.today below.

  • TicketID
  • TicketNumber
  • UserPhoneNo
  • Description
  • CreatedDate
  • Subject
  • BuildingId
  • ClosedDate
  • ResponsibleEmail
  • Status
  • PropertyName
  • EstateName
  • Address
  • City
  • ZipCode
  • UserRegion

Custom data

For a full overview of the data saved to a response in nps.today, see the JSON body below.

Response JSON 
    {
        "additionStatus": 2600,
        "doNotContact": false,
        "agentRating": null,
        "isPublic": false,
        "sender": null,
        "surveyOpenedTime": null,
        "reminderOpenedTime": null,
        "surveySendTime": "2025-03-27T09:30:00.5670000Z",
        "surveyScheduledTime": "2025-03-27T09:30:00.2530000Z",
        "reminderScheduledTime": "2025-04-03T09:30:00.2530000Z",
        "reminderSendTime": null,
        "surveyBouncedTime": null,
        "reminderBouncedTime": null,
        "history": null,
        "orgId": "e799b2fe-4bde-441e-a36d-1hj2j1234534",
        "answer1": "",
        "answer2": "",
        "answer3": "",
        "answer4": "",
        "answer5": "",
        "msCrmId": null,
        "custom": {
            "TicketID": 12125,
            "TicketNumber": "121212",
            "UserPhoneNo": "+4512345678",
            "Description": "Some text",
            "CreatedDate": "2025-03-24T07:58:20.667Z",
            "Subject": "Some text",
            "BuildingId": 1,
            "ClosedDate": "2025-03-26T06:24:22.33Z",
            "ResponsibleEmail": "[email protected]",
            "Status": "Complete, close",
            "PropertyName": "Some text",
            "EstateName": "Some text",
            "Address": "Some text",
            "City": "Some text",
            "ZipCode": "1111",
            "UserRegion": "Some text"
        },
        "allowedForPublicUse": false,
        "surveyAnswers": null,
        "surveyAnswersSimple": null,
        "editedAt": "2025-03-27T10:31:30.3062978Z",
        "createdAt": null,
        "device": "Mozilla/5.0",
        "adminComment": "",
        "adminCommentBy": "",
        "campaignName": "Work Orders in Dalux",
        "campaignMemberId": 302342342,
        "campaignMembershipGuid": "28cb754a-0a73-4528-bf0f-544822299877",
        "responsibleEmployee": 866758,
        "responsibleEmployeeForCampaignMember": {
            "id": 86177,
            "email": "[email protected]",
            "firstName": "John",
            "lastName": "Doe",
            "title": "",
            "department": "",
            "team": "",
            "division": "",
            "phoneNumber": "",
            "active": true,
            "externalId": ""
        },
        "category": {
            "id": 12345,
            "name": "Response time"
        },
        "respondent": {
            "id": 80623424,
            "address1": "",
            "address2": "",
            "city": "",
            "country": "",
            "zipCode": "",
            "emailAddress": "[email protected]",
            "firstName": "Jane",
            "lastName": "",
            "active": true,
            "title": "",
            "companyId": null,
            "company": null,
            "employeeId": null,
            "employee": null,
            "department": "",
            "phoneNumber": "+4512345678",
            "externalId": ""
        },
        "id": 39313,
        "rating": 9,
        "ratingTime": "2025-03-27T10:31:15.2570000Z",
        "anon": false,
        "ratingBy": "",
        "userComment": "Fast solution",
        "userCommentBy": "",
        "commentTime": null,
        "campaignId": 171233,
        "closed": true
    }