Create Post with Discourse API on New Conversations from Intercom API

Pipedream makes it easy to connect APIs for Discourse, Intercom and 2,000+ other apps remarkably fast.

Trigger workflow on

New Conversations from the Intercom API

Next, do this

Create Post with the Discourse API

No credit card required

▶

Watch us build a workflow

8 min

Watch now ➜

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

Developers ♥ Pipedream

Getting Started#

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

Select this integration
Configure the New Conversations trigger
1. Connect your Intercom account
2. Configure Polling Interval
Configure the Create Post action
1. Connect your Discourse account
2. Configure Content
3. Select a Topic ID
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 Conversations on Intercom

Description:Emit new event each time a new conversation is added.

Version:0.0.3

Key:intercom-new-conversation

View on GitHub

Intercom Overview#

The Intercom API offers rich capabilities for enhancing customer communication and support workflows. By leveraging this API on Pipedream, you can automate tasks, sync customer data across platforms, and create personalized interactions. Whether you are managing user segments, sending targeted messages, or updating customer profiles, the Intercom API's robust set of endpoints allows for intricate and useful automations within your business processes.

Trigger Code#

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

export default {
  ...common,
  key: "intercom-new-conversation",
  name: "New Conversations",
  description: "Emit new event each time a new conversation is added.",
  version: "0.0.3",
  type: "source",
  dedupe: "unique",
  methods: {
    ...common.methods,
    generateMeta({
      id, source, created_at: createdAt,
    }) {
      return {
        id,
        summary: source.body,
        ts: createdAt,
      };
    },
  },
  async run() {
    let lastConversationCreatedAt = this._getLastUpdate();
    const data = {
      query: {
        field: "created_at",
        operator: ">",
        value: lastConversationCreatedAt,
      },
    };

    const results = await this.intercom.searchConversations(data);
    for (const conversation of results) {
      if (conversation.created_at > lastConversationCreatedAt)
        lastConversationCreatedAt = conversation.created_at;
      const meta = this.generateMeta(conversation);
      this.$emit(conversation, meta);
    }

    this._setLastUpdate(lastConversationCreatedAt);
  },
};

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
Intercom	`intercom`	`app`	This component uses the Intercom app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
Polling Interval	`timer`	`$.interface.timer`	Pipedream will poll the API on this schedule

Trigger Authentication#

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

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

About Intercom#

Intercom is the only solution that combines an AI chatbot, help desk, and proactive support—so you can keep costs low, support teams happy, and customers satisfied.

Action#

Create Post on Discourse

Description:Creates a post. [See docs here](https://docs.discourse.org/#tag/Posts/operation/createTopicPostPM)

Version:0.1.1

Key:discourse-create-post

View on GitHub

Discourse Overview#

The Discourse API empowers developers to interact programmatically with Discourse forums, allowing for a myriad of automations and integrations. Using Pipedream, you can harness this API for tasks such as syncing forum data with other platforms, automating user management, or triggering workflows based on forum activity. The key is in creatively coupling Discourse events with Pipedream's capabilities to streamline community interactions and administration.

Action Code#

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

export default {
  name: "Create Post",
  version: "0.1.1",
  key: "discourse-create-post",
  description: "Creates a post. [See docs here](https://docs.discourse.org/#tag/Posts/operation/createTopicPostPM)",
  type: "action",
  props: {
    discourse,
    raw: {
      label: "Content",
      description: "Content of the post",
      type: "string",
    },
    topicId: {
      propDefinition: [
        discourse,
        "topicId",
      ],
    },
  },
  async run({ $ }) {
    // we use the same method to create post and topics
    const response = await this.discourse.createPostOrTopic({
      $,
      data: {
        raw: this.raw,
        topic_id: this.topicId,
      },
    });

    if (response) {
      $.export("$summary", `Successfully created post with id ${response.id}`);
    }

    return response;
  },
};

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
Discourse	`discourse`	`app`	This component uses the Discourse app.
Content	`raw`	`string`	Content of the post
Topic ID	`topicId`	`string`	Select a value from the drop down menu.

Action Authentication#

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

For domain, enter the hostname, without the protocol, that you'd use in this API call: https://[domain]/admin/users/list/active.json. For example: example.com.

If you host Discourse on a subfolder (for example: https://pipedream.com/community), enter the subfolder as a part of the domain (pipedream.com/community).

Create an API key in your Admin panel, and enter the associated api_username and api_key.