Fetch Service Reviews with Trustpilot (Customer) API on New Data Source Created from Notion API

Pipedream makes it easy to connect APIs for Trustpilot (Customer), Notion and 2,800+ other apps remarkably fast.

Trigger workflow on

New Data Source Created from the Notion API

Next, do this

Fetch Service Reviews with the Trustpilot (Customer) API

No credit card required

▶

Watch us build a workflow

8 min

Watch now ➜

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

Getting Started#

This integration creates a workflow with a Notion trigger and Trustpilot (Customer) action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Data Source Created trigger
1. Connect your Notion account
2. Configure timer
3. Configure infoLabel
Configure the Fetch Service Reviews action
1. Connect your Trustpilot (Customer) account
2. Select a Business Unit ID
3. Optional- Configure Language
4. Optional- Configure Page
5. Optional- Configure Star Rating
6. Optional- Configure Internal Location ID
7. Optional- Configure Per Page
8. Optional- Select a Order By
9. Optional- Configure Tag Group
10. Optional- Configure Tag Value
11. Optional- Configure Ignore Tag Value Case
12. Optional- Configure Responded
13. Optional- Configure Reference ID
14. Optional- Configure Referral Email
15. Optional- Configure Reported
16. Optional- Configure Start Date Time
17. Optional- Configure End Date Time
18. Optional- Configure Source
19. Optional- Configure Username
20. Optional- Select a Find Reviewer
Deploy the workflow
Send a test event to validate your setup
Turn on the trigger

Details#

This integration uses pre-built, source-available components from Pipedream's GitHub repo. These components are developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

Trigger#

New Data Source Created on Notion

Description:Emit new event when a data source is created. [See the documentation](https://developers.notion.com/reference/data-source)

Version:0.1.0

Key:notion-new-database

View on GitHub

Notion Overview#

Notion's API allows for the creation, reading, updating, and deleting of pages, databases, and their contents within Notion. Using Pipedream's platform, you can build workflows that connect Notion with various other services to automate tasks such as content management, task tracking, and data synchronization. With Pipedream's serverless execution, you can trigger these workflows on a schedule, or by external events from other services, without managing any infrastructure.

Trigger Code#

import base from "../common/base.mjs";
import constants from "../common/constants.mjs";
import sampleEmit from "./test-event.mjs";

export default {
  ...base,
  key: "notion-new-database",
  name: "New Data Source Created",
  description: "Emit new event when a data source is created. [See the documentation](https://developers.notion.com/reference/data-source)",
  version: "0.1.0",
  type: "source",
  props: {
    ...base.props,
    infoLabel: {
      type: "alert",
      alertType: "info",
      content: "Ensure Data Sources are shared with your Pipedream integration to receive events.",
    },
  },
  async run() {
    const dataSources = [];
    const params = this.lastCreatedSortParam();
    const lastCreatedTimestamp = this.getLastCreatedTimestamp();

    do {
      const response = await this.notion.listDataSources(params);

      for (const dataSource of response.results) {
        if (!this.isResultNew(dataSource.created_time, lastCreatedTimestamp)) {
          params.start_cursor = null;
          break;
        }
        dataSources.push(dataSource);
      }

      params.start_cursor = response.next_cursor;
    } while (params.start_cursor);

    dataSources.reverse().forEach((dataSource) => {
      const meta = this.generateMeta(
        dataSource,
        constants.types.DATA_SOURCE,
        constants.timestamps.CREATED_TIME,
        constants.summaries.DATA_SOURCE_ADDED,
      );
      this.$emit(dataSource, meta);
    });

    const lastCreatedTime = dataSources[dataSources.length - 1]?.created_time;
    if (lastCreatedTime) {
      this.setLastCreatedTimestamp(Date.parse(lastCreatedTime));
    }
  },
  sampleEmit,
};

Trigger Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.

Label	Prop	Type	Description
Notion	`notion`	`app`	This component uses the Notion app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
	`timer`	`$.interface.timer`

Trigger Authentication#

Notion uses OAuth authentication. When you connect your Notion account, Pipedream will open a popup window where you can sign into Notion and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any Notion API.

Pipedream requests the following authorization scopes when you connect your account:

About Notion#

Notion is a new tool that blends your everyday work apps into one. It's the all-in-one workspace for you and your team.

Action#

Fetch Service Reviews on Trustpilot (Customer)

Description:Get private reviews for a business unit. Response includes customer email and order ID. [See the documentation](https://developers.trustpilot.com/business-units-api#get-private-reviews-for-business-unit)

Version:0.1.0

Key:trustpilot-fetch-service-reviews

View on GitHub

Trustpilot (Customer) Overview#

The Trustpilot (Customer) API lets you tap into the rich pool of customer review data on Trustpilot. You can use it to automate the process of collecting and managing reviews, responding to feedback, and analyzing customer sentiment. With Pipedream's integration, you can trigger workflows based on new reviews, aggregate review data for analysis, and sync Trustpilot data with other services like CRMs, support tickets, and marketing tools.

Action Code#

import trustpilot from "../../trustpilot.app.mjs";

export default {
  key: "trustpilot-fetch-service-reviews",
  name: "Fetch Service Reviews",
  description: "Get private reviews for a business unit. Response includes customer email and order ID. [See the documentation](https://developers.trustpilot.com/business-units-api#get-private-reviews-for-business-unit)",
  version: "0.1.0",
  type: "action",
  props: {
    trustpilot,
    businessUnitId: {
      propDefinition: [
        trustpilot,
        "businessUnitId",
      ],
    },
    language: {
      propDefinition: [
        trustpilot,
        "language",
      ],
    },
    page: {
      type: "integer",
      label: "Page",
      description: "The page to retrieve. If the page number requested is higher than the available number of pages, an empty array will be returned.",
      min: 1,
      default: 1,
      optional: true,
    },
    stars: {
      type: "string",
      label: "Star Rating",
      description: "Filter by reviews with a specific star rating. 1-5, separated by commas.",
      optional: true,
    },
    internalLocationId: {
      type: "string",
      label: "Internal Location ID",
      description: "Filter by reviews with a specific location",
      optional: true,
    },
    perPage: {
      type: "integer",
      label: "Per Page",
      description: "The number of reviews to retrieve per page",
      min: 1,
      max: 100,
      default: 20,
      optional: true,
    },
    orderBy: {
      type: "string",
      label: "Order By",
      description: "The order in which the results should be sorted",
      options: [
        {
          label: "Created At (Ascending)",
          value: "createdat.asc",
        },
        {
          label: "Created At (Descending)",
          value: "createdat.desc",
        },
        {
          label: "Stars (Ascending)",
          value: "stars.asc",
        },
        {
          label: "Stars (Descending)",
          value: "stars.desc",
        },
      ],
      default: "createdat.desc",
      optional: true,
    },
    tagGroup: {
      type: "string",
      label: "Tag Group",
      description: "Filtering reviews on Tag group",
      optional: true,
    },
    tagValue: {
      type: "string",
      label: "Tag Value",
      description: "Filtering reviews on Tag value",
      optional: true,
    },
    ignoreTagValueCase: {
      type: "boolean",
      label: "Ignore Tag Value Case",
      description: "Ignore tag value case",
      default: false,
      optional: true,
    },
    responded: {
      type: "boolean",
      label: "Responded",
      description: "Filter reviews by responded state",
      optional: true,
    },
    referenceId: {
      type: "string",
      label: "Reference ID",
      description: "Filter reviews by reference Id",
      optional: true,
    },
    referralEmail: {
      type: "string",
      label: "Referral Email",
      description: "Filter reviews by referral email",
      optional: true,
    },
    reported: {
      type: "boolean",
      label: "Reported",
      description: "Filter reviews by reported state",
      optional: true,
    },
    startDateTime: {
      type: "string",
      label: "Start Date Time",
      description: "Filter reviews by datetime range. If no time is specified, then time is implicitly `00:00:00`. Format: `2013-09-07T13:37:00`",
      optional: true,
    },
    endDateTime: {
      type: "string",
      label: "End Date Time",
      description: "Filter reviews by datetime range. If no time is specified, then time is implicitly `00:00:00`. Format: `2013-09-07T13:37:00`",
      optional: true,
    },
    source: {
      type: "string",
      label: "Source",
      description: "Filter reviews by source",
      optional: true,
    },
    username: {
      type: "string",
      label: "Username",
      description: "Filter reviews by user name",
      optional: true,
    },
    findReviewer: {
      type: "string",
      label: "Find Reviewer",
      description: "Filter reviews by Find Reviewer requests (contacted or not contacted)",
      options: [
        "contacted",
        "notContacted",
      ],
      optional: true,
    },
  },
  async run({ $ }) {
    const {
      businessUnitId,
      stars,
      language,
      page = 1,
      internalLocationId,
      perPage = 20,
      orderBy = "createdat.desc",
      tagGroup,
      tagValue,
      ignoreTagValueCase = false,
      responded,
      referenceId,
      referralEmail,
      reported,
      startDateTime,
      endDateTime,
      source,
      username,
      findReviewer,
    } = this;

    try {
      // Use the shared method from the app
      const result = await this.trustpilot.fetchServiceReviews($, {
        businessUnitId,
        stars,
        language,
        page,
        internalLocationId,
        perPage,
        orderBy,
        tagGroup,
        tagValue,
        ignoreTagValueCase,
        responded,
        referenceId,
        referralEmail,
        reported,
        startDateTime,
        endDateTime,
        source,
        username,
        findReviewer,
      });

      $.export("$summary", `Successfully fetched ${result.reviews.length} service review(s) for business unit ${businessUnitId}`);

      return result;
    } catch (error) {
      throw new Error(`Failed to fetch service reviews: ${error.message}`);
    }
  },
};

Action Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI.

Label	Prop	Type	Description
Trustpilot (Customer)	`trustpilot`	`app`	This component uses the Trustpilot (Customer) app.
Business Unit ID	`businessUnitId`	`string`	Select a value from the drop down menu.
Language	`language`	`string`	Filter reviews by language (ISO 639-1 code)
Page	`page`	`integer`	The page to retrieve. If the page number requested is higher than the available number of pages, an empty array will be returned.
Star Rating	`stars`	`string`	Filter by reviews with a specific star rating. 1-5, separated by commas.
Internal Location ID	`internalLocationId`	`string`	Filter by reviews with a specific location
Per Page	`perPage`	`integer`	The number of reviews to retrieve per page
Order By	`orderBy`	`string`	Select a value from the drop down menu:`{ "label": "Created At (Ascending)", "value": "createdat.asc" }{ "label": "Created At (Descending)", "value": "createdat.desc" }{ "label": "Stars (Ascending)", "value": "stars.asc" }{ "label": "Stars (Descending)", "value": "stars.desc" }`
Tag Group	`tagGroup`	`string`	Filtering reviews on Tag group
Tag Value	`tagValue`	`string`	Filtering reviews on Tag value
Ignore Tag Value Case	`ignoreTagValueCase`	`boolean`	Ignore tag value case
Responded	`responded`	`boolean`	Filter reviews by responded state
Reference ID	`referenceId`	`string`	Filter reviews by reference Id
Referral Email	`referralEmail`	`string`	Filter reviews by referral email
Reported	`reported`	`boolean`	Filter reviews by reported state
Start Date Time	`startDateTime`	`string`	Filter reviews by datetime range. If no time is specified, then time is implicitly `00:00:00`. Format: `2013-09-07T13:37:00`
End Date Time	`endDateTime`	`string`	Filter reviews by datetime range. If no time is specified, then time is implicitly `00:00:00`. Format: `2013-09-07T13:37:00`
Source	`source`	`string`	Filter reviews by source
Username	`username`	`string`	Filter reviews by user name
Find Reviewer	`findReviewer`	`string`	Select a value from the drop down menu:`contactednotContacted`

Action Authentication#

Trustpilot (Customer) uses OAuth authentication. When you connect your Trustpilot (Customer) account, Pipedream will open a popup window where you can sign into Trustpilot (Customer) and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any Trustpilot (Customer) API.

Pipedream requests the following authorization scopes when you connect your account:

Fetch Service Reviews with Trustpilot (Customer) API on New Data Source Created from Notion API

Pipedream makes it easy to connect APIs for Trustpilot (Customer), Notion and 2,800+ other apps remarkably fast.

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

1-24of2,800+apps by most popular

1
-
24
of
2,800+
apps by most popular