Get Knowledge Articles with Salesforce API on New Transactional Webhook (Instant) from SendinBlue API

Pipedream makes it easy to connect APIs for Salesforce, SendinBlue and 2,800+ other apps remarkably fast.

Trigger workflow on

New Transactional Webhook (Instant) from the SendinBlue API

Next, do this

Get Knowledge Articles with the Salesforce 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 SendinBlue trigger and Salesforce action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Transactional Webhook (Instant) trigger
1. Connect your SendinBlue account
2. Configure Description
3. Select one or more Events
Configure the Get Knowledge Articles action
1. Connect your Salesforce account
2. Configure info
3. Optional- Configure Language
4. Optional- Configure Search Term
5. Optional- Select a Channel
6. Optional- Configure Categories
7. Optional- Select a Query Method
8. Optional- Select a Sort By
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 Transactional Webhook (Instant) on SendinBlue

Description:Emit new event when triggered by a transactional event

Version:0.0.1

Key:sendinblue-transactional-webhook

View on GitHub

SendinBlue Overview#

The SendinBlue API offers a suite of email marketing tools, including campaign creation, contact list management, and transactional email sending. It's designed for crafting personalized messages, automating marketing workflows, and tracking the performance of email campaigns. With Pipedream, you can harness the power of SendinBlue by automating interactions with other services, reacting to events with custom code, and stitching together complex workflows with minimal effort.

Trigger Code#

import common from "../common-webhook.mjs";
import options from "../../common/options.mjs";

export default {
  ...common,
  key: "sendinblue-transactional-webhook",
  name: "New Transactional Webhook (Instant)",
  description: "Emit new event when triggered by a transactional event",
  version: "0.0.1",
  type: "source",
  dedupe: "unique",
  props: {
    ...common.props,
    description: {
      type: "string",
      label: "Description",
      description: "Description of the webhook.",
    },
    events: {
      type: "string[]",
      label: "Events",
      description: "Events triggering the webhook.",
      options: options.transactionalEventOptions,
    },
  },
  methods: {
    ...common.methods,
    getEventNames() {
      return this.events;
    },
    getHookDescription() {
      return this.description;
    },
    getEventType() {
      return "transactional";
    },
    generateMeta(body) {
      const meta = {
        ...body,
      };
      return meta;
    },
  },
};

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
SendinBlue	`sendinBlueApp`	`app`	This component uses the SendinBlue app.
N/A	`http`	`$.interface.http`	This component uses `$.interface.http` to generate a unique URL when the component is first instantiated. Each request to the URL will trigger the `run()` method of the component.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
Description	`description`	`string`	Description of the webhook.
Events	`events`	`string[]`	Select a value from the drop down menu:`sentdeliveredhardBouncesoftBounceblockedspaminvaliddeferredclickopeneduniqueOpenedunsubscribed`

Trigger Authentication#

SendinBlue uses API keys for authentication. When you connect your SendinBlue account, Pipedream securely stores the keys so you can easily authenticate to SendinBlue APIs in both code and no-code steps.

Get your API key under SMTP & API

About SendinBlue#

Sendinblue powers advanced email marketing and automation

Action#

Get Knowledge Articles on Salesforce

Description:Get a page of online articles for the given language and category through either search or query. [See the documentation](https://developer.salesforce.com/docs/atlas.en-us.knowledge_dev.meta/knowledge_dev/sforce_api_rest_retrieve_article_list.htm)

Version:0.0.2

Key:salesforce_rest_api-get-knowledge-articles

View on GitHub

Salesforce Overview#

The Salesforce (REST API) provides a powerful platform for creating and managing customer relationships with a wide array of features like data manipulation, querying, and complex automation. With Pipedream's serverless execution, you can create workflows that automate your sales processes, sync data with other platforms, enhance customer engagement, and trigger actions based on specific events. Dive into Salesforce data, streamline lead management, track customer interactions, and push or pull data to or from Salesforce seamlessly.

Action Code#

import common from "../common/knowledge.mjs";

export default {
  ...common,
  key: "salesforce_rest_api-get-knowledge-articles",
  name: "Get Knowledge Articles",
  description: "Get a page of online articles for the given language and category through either search or query. [See the documentation](https://developer.salesforce.com/docs/atlas.en-us.knowledge_dev.meta/knowledge_dev/sforce_api_rest_retrieve_article_list.htm)",
  version: "0.0.2",
  annotations: {
    destructiveHint: false,
    openWorldHint: true,
    readOnlyHint: true,
  },
  type: "action",
  props: {
    ...common.props,
    q: {
      type: "string",
      label: "Search Term",
      description: "Performs an SOSL search. If this property is not set, an SOQL query runs. The characters `?` and `*` are used for wildcard searches. The characters `(`, `)`, and `\"` are used for complex search terms. [See the documentation](https://developer.salesforce.com/docs/atlas.en-us.soql_sosl.meta/soql_sosl/sforce_api_calls_sosl_find.htm).",
      optional: true,
    },
    channel: {
      type: "string",
      label: "Channel",
      description: "Where articles are visible (App, Pkb, Csp, Prm).",
      optional: true,
      options: [
        {
          label: "Internal Knowledge App",
          value: "App",
        },
        {
          label: "Public Knowledge Base",
          value: "Pkb",
        },
        {
          label: "Customer Portal",
          value: "Csp",
        },
        {
          label: "Partner Portal",
          value: "Prm",
        },
      ],
    },
    categories: {
      type: "string",
      label: "Categories",
      description: "This should be a map in json format `{\"group1\": \"category1\", \"group2\": \"category2\", ...}`. It must be unique in each group:category pair, otherwise you get `ARGUMENT_OBJECT_PARSE_ERROR`. There is a limit of three data category conditions, otherwise you get `INVALID_FILTER_VALUE`.",
      optional: true,
    },
    queryMethod: {
      type: "string",
      label: "Query Method",
      description: "Only valid when categories are specified, defaults to `ABOVE_OR_BELOW`.",
      optional: true,
      options: [
        "AT",
        "BELOW",
        "ABOVE",
        "ABOVE_OR_BELOW",
      ],
    },
    sort: {
      type: "string",
      label: "Sort By",
      description: "Field to sort results by. Defaults to `LastPublishedDate` for query and relevance for search",
      optional: true,
      options: [
        "LastPublishedDate",
        "CreatedDate",
        "Title",
        "ViewScore",
      ],
    },
  },
  async run({ $ }) {
    const {
      app,
      q,
      channel,
      language,
      categories,
      queryMethod,
      sort,
    } = this;

    const items = await app.paginate({
      resultsKey: "articles",
      requester: app.getKnowledgeArticles,
      requesterArgs: {
        $,
        headers: {
          ...app._makeRequestHeaders(),
          "Accept": "application/json",
          "Accept-Language": language || "en-US",
        },
        params: {
          q,
          channel,
          categories,
          queryMethod,
          sort,
        },
      },
    });

    $.export("$summary", `Successfully fetched \`${items.length}\` articles`);

    return items;
  },
};

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
Salesforce	`app`	`app`	This component uses the Salesforce app.
Language	`language`	`string`	The language code. Defaults to `en-US`.
Search Term	`q`	`string`	Performs an SOSL search. If this property is not set, an SOQL query runs. The characters `?` and `*` are used for wildcard searches. The characters `(`, `)`, and `"` are used for complex search terms. See the documentation
Channel	`channel`	`string`	Select a value from the drop down menu:`{ "label": "Internal Knowledge App", "value": "App" }{ "label": "Public Knowledge Base", "value": "Pkb" }{ "label": "Customer Portal", "value": "Csp" }{ "label": "Partner Portal", "value": "Prm" }`
Categories	`categories`	`string`	This should be a map in json format `{"group1": "category1", "group2": "category2", ...}`. It must be unique in each group:category pair, otherwise you get `ARGUMENT_OBJECT_PARSE_ERROR`. There is a limit of three data category conditions, otherwise you get `INVALID_FILTER_VALUE`.
Query Method	`queryMethod`	`string`	Select a value from the drop down menu:`ATBELOWABOVEABOVE_OR_BELOW`
Sort By	`sort`	`string`	Select a value from the drop down menu:`LastPublishedDateCreatedDateTitleViewScore`

Action Authentication#

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

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

Get Knowledge Articles with Salesforce API on New Transactional Webhook (Instant) from SendinBlue API

Pipedream makes it easy to connect APIs for Salesforce, SendinBlue 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