Create Project with Pivotal Tracker API on New Direct Message from Slack Bot API

Pipedream makes it easy to connect APIs for Pivotal Tracker, Slack Bot and 2,500+ other apps remarkably fast.

Trigger workflow on

New Direct Message from the Slack Bot API

Next, do this

Create Project with the Pivotal Tracker 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 Slack Bot trigger and Pivotal Tracker action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Direct Message trigger
1. Connect your Slack Bot account
2. Configure Polling schedule
3. Select a User Channel
Configure the Create Project action
1. Connect your Pivotal Tracker account
2. Configure Name
3. Optional- Configure Description
4. Optional- Select a Project Type
5. Optional- Configure Enable Tasks
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 Direct Message on Slack Bot

Description:Emit new event when a message is posted in a direct message channel (Bot). To open a conversation, use the Pipedream Action "Send a Direct Message" to send a message from the Bot, or enable direct messages to the Bot in your App Settings (Settings->App Home->Show Tabs->Messages Tab), and send a direct message to the Bot.

Version:0.0.4

Key:slack_bot-new-direct-message

View on GitHub

Slack Bot Overview#

The Slack Bot API allows you to build rich, interactive bots for Slack workspaces. These bots can respond to messages, post updates, and interact with users in various ways. With the Slack Bot API on Pipedream, developers can create automated workflows that trigger on specific events in Slack, such as new messages or reactions, and then perform defined actions, like sending data to other apps or processing the information within Pipedream's serverless platform. This tight integration with Pipedream enables both simple and complex automations, leveraging Pipedream's ability to connect with numerous apps and its powerful built-in code steps.

Trigger Code#

import common from "../common/base.mjs";
import constants from "../../common/constants.mjs";
import utils from "../../common/utils.mjs";

export default {
  ...common,
  key: "slack_bot-new-direct-message",
  name: "New Direct Message",
  version: "0.0.4",
  description: "Emit new event when a message is posted in a direct message channel (Bot). To open a conversation, use the Pipedream Action \"Send a Direct Message\" to send a message from the Bot, or enable direct messages to the Bot in your App Settings (Settings->App Home->Show Tabs->Messages Tab), and send a direct message to the Bot.",
  type: "source",
  dedupe: "unique",
  props: {
    ...common.props,
    channelId: {
      propDefinition: [
        common.props.app,
        "channelId",
        () => ({
          types: [
            constants.CHANNEL_TYPE.IM,
          ],
        }),
      ],
      label: "User Channel",
      description: `Events will only be emitted for direct messages between this user and the Bot. ${utils.CONVERSATION_PERMISSION_MESSAGE}`,
    },
  },
  methods: {
    ...common.methods,
    getResourceName() {
      return constants.RESOURCE_NAME.MESSAGES;
    },
    getResourceFn() {
      return this.app.conversationsHistory;
    },
    getResourceFnArgs() {
      return {
        channel: this.channelId,
        limit: constants.LIMIT,
        oldest: this.getLastTimestamp(),
        inclusive: false,
      };
    },
    generateMeta(resource) {
      return {
        id: resource.ts,
        ts: resource.ts,
        summary: `New Message Timestamp ${resource.ts}`,
      };
    },
  },
};

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
Slack Bot	`app`	`app`	This component uses the Slack Bot app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
Polling schedule	`timer`	`$.interface.timer`	How often to poll the Slack API
User Channel	`channelId`	`string`	Select a value from the drop down menu.

Trigger Authentication#

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

In the settings for your Slack app, visit the OAuth & Permissions section on the left. You'll see a token labeled Bot User OAuth Access Token. Copy and paste that below.

See Slack's docs on Bot User Tokens for more info.

About Slack Bot#

Interact with Slack with your own bot user

Action#

Create Project on Pivotal Tracker

Description:Create a new project. [See the docs here](https://www.pivotaltracker.com/help/api/rest/v5#projects_post)

Version:0.0.1

Key:pivotal_tracker-create-project

View on GitHub

Pivotal Tracker Overview#

Pipedream's integration with the Pivotal Tracker API turns your project management into a powerhouse of automation and connectivity. It allows you to orchestrate workflows that can respond to changes in your projects, stories, and tasks in real-time. For instance, you can sync project updates with other tools, extract metrics for reporting, or even streamline notification systems to keep your entire team in the loop effortlessly.

Action Code#

import pivotalTracker from "../../pivotal_tracker.app.mjs";
import constants from "../../common/constants.mjs";

export default {
  name: "Create Project",
  key: "pivotal_tracker-create-project",
  description: "Create a new project. [See the docs here](https://www.pivotaltracker.com/help/api/rest/v5#projects_post)",
  version: "0.0.1",
  type: "action",
  props: {
    pivotalTracker,
    name: {
      propDefinition: [
        pivotalTracker,
        "name",
      ],
    },
    description: {
      propDefinition: [
        pivotalTracker,
        "description",
      ],
    },
    projectType: {
      type: "string",
      label: "Project Type",
      description: "The project's type which determines visibility and permissions",
      options: constants.PROJECT_TYPES,
      optional: true,
    },
    enableTasks: {
      type: "boolean",
      label: "Enable Tasks",
      description: "Allow tasks to be added to stories",
      optional: true,
    },
  },
  async run({ $ }) {
    const data = {
      name: this.name,
      description: this.description,
      project_type: this.projectType,
      enable_tasks: this.enableTasks,
    };

    const response = await this.pivotalTracker.createProject({
      data,
      $,
    });

    $.export("$summary", `Successfully created project 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
Pivotal Tracker	`pivotalTracker`	`app`	This component uses the Pivotal Tracker app.
Name	`name`	`string`	Name of the new project
Description	`description`	`string`	A description of the project's content
Project Type	`projectType`	`string`	Select a value from the drop down menu:`demoprivatepublicshared`
Enable Tasks	`enableTasks`	`boolean`	Allow tasks to be added to stories

Action Authentication#

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

The API token section of your Profile page displays your API token and also allows you to change or revoke it, if necessary.

About Pivotal Tracker#

Pivotal Tracker is the agile project management tool of choice for developers around the world for real-time collaboration around a shared, prioritized backlog.

More Ways to Connect Pivotal Tracker + Slack Bot#

Other Popular Integrations#

Create Project with Pivotal Tracker API on New Message In Channel from Slack Bot API

Slack Bot + Pivotal Tracker

Create Project with Pivotal Tracker API on New Direct Message from Slack Bot API

Pipedream makes it easy to connect APIs for Pivotal Tracker, Slack Bot 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