Import Tasks with Todoist API on New Conversations from Intercom API

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

Trigger workflow on

New Conversations from the Intercom API

Next, do this

Import Tasks with the Todoist 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 Intercom trigger and Todoist 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 Import Tasks action
1. Connect your Todoist account
2. Configure File Path
3. Optional- Select a Project
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.7

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/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.7",
  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#

Import Tasks on Todoist

Description:Import tasks into a selected project. [See Docs](https://developer.todoist.com/sync/v9/#add-an-item)

Version:0.0.3

Key:todoist-import-tasks

View on GitHub

Todoist Overview#

The Todoist API unlocks the potential to automate task management with precision. With Pipedream, you can craft workflows that react to events in Todoist, like task completions or due date changes, or drive actions in Todoist, such as creating tasks or updating projects. By integrating Todoist with Pipedream, you can seamlessly connect your to-do list with other apps to streamline your productivity, manage tasks based on triggers from other services, or compile reports on your task management patterns.

Action Code#

import todoist from "../../todoist.app.mjs";
import fs from "fs";
import converter from "json-2-csv";

export default {
  key: "todoist-import-tasks",
  name: "Import Tasks",
  description: "Import tasks into a selected project. [See Docs](https://developer.todoist.com/sync/v9/#add-an-item)",
  version: "0.0.3",
  type: "action",
  props: {
    todoist,
    path: {
      propDefinition: [
        todoist,
        "path",
      ],
    },
    project: {
      propDefinition: [
        todoist,
        "project",
      ],
      description: "Project to import tasks into",
    },
  },
  methods: {
    exportSummary($, tasks) {
      $.export("$summary", `Successfully imported ${tasks.length} task${tasks.length === 1
        ? ""
        : "s"} from "${this.path}"`);
    },
  },
  async run ({ $ }) {
    const {
      path,
      project,
    } = this;

    const fileContents = (await fs.promises.readFile(path)).toString();
    const tasks = await converter.csv2jsonAsync(fileContents);
    // CREATE TASKS
    const data = tasks.map((task) => ({
      content: task.content,
      description: task.description,
      project_id: project,
      due: task.due,
      priority: task.priority,
      child_order: task.order,
      labels: task.label_ids,
    }));
    const {
      responses: createResponses,
      tempIds,
    } = await this.todoist.createTasks({
      $,
      data,
    });

    const childTasks = tasks.filter((task) => task.parent_id);

    if (childTasks.length === 0) {
      this.exportSummary($, tasks);
      return {
        createResponses,
      };
    }

    // MOVE CHILD TASKS (set parent_id)

    // `createTasks` returns an array object containing a `temp_id_mapping` property, which maps
    // command `temp_id`s to real task `id`s. Combine these mappings into a single object.
    const tempIdMapping = createResponses.reduce((mapping, response) => {
      mapping = {
        ...mapping,
        ...response.temp_id_mapping,
      };
      return mapping;
    }, {});

    // Create mapping from ID of imported task to ID of new task in `project`, using `tempIdMapping`
    const idMapping = tasks.reduce((mapping, task, index) => {
      mapping[task.id] = tempIdMapping[tempIds[index]];
      return mapping;
    }, {});

    const moveData = childTasks.map((task) => ({
      id: idMapping[task.id],
      parent_id: idMapping[task.parent_id],
    }));

    const { responses: moveResponses } = await this.todoist.moveTasks({
      $,
      data: moveData,
    });

    this.exportSummary($, tasks);

    return {
      createResponses,
      moveResponses,
    };
  },
};

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
Todoist	`todoist`	`app`	This component uses the Todoist app.
File Path	`path`	`string`	Path to .csv file containing task data. Enter a static value (e.g., `/tmp/myFile.csv`) or reference prior step exports via the `steps` object (e.g., `{{steps.export_tasks.$return_value}}`).
Project	`project`	`string`	Select a value from the drop down menu.

Action Authentication#

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

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

task:adddata:read_writedata:deleteproject:delete

Import Tasks with Todoist API on New Conversations from Intercom API

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

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

Developers ♥ Pipedream

1-24of2,500+apps by most popular

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