Update User Story with Taiga API on Email Sent from Plain API

Pipedream makes it easy to connect APIs for Taiga, Plain and 2,900+ other apps remarkably fast.

Trigger workflow on

Email Sent from the Plain API

Next, do this

Update User Story with the Taiga 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 Plain trigger and Taiga action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the Email Sent trigger
1. Connect your Plain account
Configure the Update User Story action
1. Connect your Taiga account
2. Select a Project ID
3. Select a User Story ID
4. Optional- Configure Subject
5. Optional- Configure Description
6. Optional- Select a User Story Status
7. Optional- Select a Assigned To
8. Optional- Configure Tags
9. Optional- Configure Backlog Order
10. Optional- Configure Kanban Order
11. Optional- Configure Sprint Order
12. Optional- Configure Client Requirement
13. Optional- Configure Is Blocked
14. Optional- Select a Milestone
15. Optional- Configure Points
16. Optional- Configure Team Requirement
17. Optional- Select one or more Watchers
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#

Email Sent on Plain

Description:Emit new event when an email is sent.

Version:0.0.1

Key:plain-email-sent

View on GitHub

Plain Overview#

The Plain API provides functionality for automating customer support tasks, such as managing conversations, customers, and team inboxes. Within Pipedream, you can leverage these features to create custom workflows that respond to events from your app or external services, triggering actions in Plain. By integrating the Plain API with Pipedream, you can enhance customer support efficiency, streamline communication, and keep customer data synchronized across platforms.

Trigger Code#

import common from "../common/base-webhook.mjs"; import sampleEmit from "./test-event.mjs"; export default { ...common, key: "plain-email-sent", name: "Email Sent", description: "Emit new event when an email is sent.", version: "0.0.1", type: "source", dedupe: "unique", methods: { ...common.methods, getEventType() { return "thread.email_sent"; }, getSummary({ payload }) { return `Email Sent ID ${payload.email.id}`; }, }, 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
Plain	`plain`	`app`	This component uses the Plain app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
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.

Trigger Authentication#

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

To get an API key, follow the following instructions: https://www.plain.com/docs/api-reference/graphql/authentication

About Plain#

Customer support for modern tools. Fast, flexible and extendable.

Action#

Update User Story on Taiga

Description:Update an existing user story in a Taiga project. [See the documentation](https://docs.taiga.io/api.html#_user_stories)

Version:0.0.2

Key:taiga-update-userstory

View on GitHub

Action Code#

import { cleanObj, parseObject, } from "../../common/utils.mjs"; import taiga from "../../taiga.app.mjs"; export default { key: "taiga-update-userstory", name: "Update User Story", description: "Update an existing user story in a Taiga project. [See the documentation](https://docs.taiga.io/api.html#_user_stories)", version: "0.0.2", annotations: { destructiveHint: true, openWorldHint: true, readOnlyHint: false, }, type: "action", props: { taiga, projectId: { propDefinition: [ taiga, "projectId", ], }, userStoryId: { propDefinition: [ taiga, "userStoryId", ({ projectId }) => ({ projectId, }), ], }, subject: { propDefinition: [ taiga, "userStorySubject", ], optional: true, }, description: { propDefinition: [ taiga, "userStoryDescription", ], optional: true, }, status: { propDefinition: [ taiga, "userStoryStatus", ({ projectId }) => ({ projectId, }), ], optional: true, }, assignedTo: { propDefinition: [ taiga, "userId", ({ projectId }) => ({ projectId, }), ], label: "Assigned To", description: "User to assign the user story to", optional: true, }, tags: { propDefinition: [ taiga, "tags", ], description: "Tags to associate with the user story", optional: true, }, backlogOrder: { propDefinition: [ taiga, "backlogOrder", ], optional: true, }, kanbanOrder: { propDefinition: [ taiga, "kanbanOrder", ], optional: true, }, sprintOrder: { propDefinition: [ taiga, "sprintOrder", ], optional: true, }, clientRequirement: { propDefinition: [ taiga, "clientRequirement", ], optional: true, }, isBlocked: { propDefinition: [ taiga, "isBlocked", ], description: "Whether the user story is blocked", optional: true, }, milestone: { propDefinition: [ taiga, "milestone", ({ projectId }) => ({ projectId, }), ], description: "Milestone to associate the user story with", optional: true, }, points: { propDefinition: [ taiga, "points", ], optional: true, }, teamRequirement: { propDefinition: [ taiga, "teamRequirement", ], optional: true, }, watchers: { propDefinition: [ taiga, "userId", ({ projectId }) => ({ projectId, }), ], type: "string[]", label: "Watchers", description: "Users to watch the user story", optional: true, }, }, async run({ $ }) { const userStory = await this.taiga.getUserStory({ userStoryId: this.userStoryId, }); const response = await this.taiga.updateUserStory({ $, userStoryId: this.userStoryId, data: cleanObj({ version: userStory.version, subject: this.subject, description: this.description, status: this.status, assigned_to: this.assignedTo, tags: parseObject(this.tags), backlog_order: this.backlogOrder, client_requirement: this.clientRequirement, is_blocked: this.isBlocked, milestone: this.milestone, points: parseObject(this.points), team_requirement: this.teamRequirement, watchers: parseObject(this.watchers), }), }); $.export("$summary", `Updated user story: ${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
Taiga	`taiga`	`app`	This component uses the Taiga app.
Project ID	`projectId`	`string`	Select a value from the drop down menu.
User Story ID	`userStoryId`	`string`	Select a value from the drop down menu.
Subject	`subject`	`string`	The user story subject/title
Description	`description`	`string`	The user story description
User Story Status	`status`	`string`	Select a value from the drop down menu.
Assigned To	`assignedTo`	`string`	Select a value from the drop down menu.
Tags	`tags`	`string[]`	Tags to associate with the user story
Backlog Order	`backlogOrder`	`integer`	The order in the backlog
Kanban Order	`kanbanOrder`	`integer`	The order in the kanban
Sprint Order	`sprintOrder`	`integer`	The order in the sprint
Client Requirement	`clientRequirement`	`boolean`	Whether the user story is a client requirement
Is Blocked	`isBlocked`	`boolean`	Whether the user story is blocked
Milestone	`milestone`	`string`	Select a value from the drop down menu.
Points	`points`	`object`	A dictionary of points. The key is the id of the role and the value is the id of the points Format: `{"10469741": 20817870, "10469742": 20817871, "10469743": 20817872, "10469744": 20817873}`
Team Requirement	`teamRequirement`	`boolean`	Whether the user story is a team requirement
Watchers	`watchers`	`string[]`	Select a value from the drop down menu.

Action Authentication#

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

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

Update User Story with Taiga API on Email Sent from Plain API

Pipedream makes it easy to connect APIs for Taiga, Plain and 2,900+ other apps remarkably fast.

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

Developers ♥ Pipedream

1-24of2,900+apps by most popular

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