Asana

Asana Integration allows you to seamlessly connect your Botpress and Asana, a well-established project management platform. This integration equips your bot with the ability to manage projects and tasks right from its interface. After the setup, you will be able to perform actions such as task creation, task updates, task comment addition, and more.

Prerequisites

An Asana account
Access to an existing Asana workspace.

Setting up the Asana integration in Botpress

Go to the Integration Hub in Botpress Cloud (if you don’t have the integration installed yet).
Find and open the Asana integration then click on the “Install to Bot” button, now go back to your bot settings.

The Asana integration has the following settings:

Enabled: Whether Botpress will communicate with Asana
Webhook URL: The URL for receiving data in Botpress. (You shall not be using it)
API Token: The API token generated from Asana
Workspace Gid: The workspace ID obtained from Asana

Setting up Asana

Generate a Personal Access Token on Asana. Follow these instructions to get your token. Once you have it, paste it in the API Token input in Botpress.
Get the workspace ID. You can obtain your workspace ID by visiting this link while logged in to your Asana account. The workspace ID corresponds to the gid parameter of the workspace you want to use. Paste it in the Workspace Gid input in Botpress.

That’s it! Now the Asana integration is operational and ready for use within your bot.

NoteThe Asana API rate limits are applicable. Also, note that certain advanced Asana features tied to paid plans may not be accessible.

With the Asana Integration, you can interact with Asana directly from your Botpress bot. The integration introduces various actions, including task creation, task updates, task comment addition, and more, making the task and user management processes more efficient.

Cards

The following Cards are available with the Asana integration:

Create task

Creates a new task in Asana. Input fields:

Show child attributes

name

string

required

The name of the new task.

notes

string

The description of the task.

assignee

string

default:"me"

required

The ID of the user who will be assigned to the task.Enter me to assign to the current user.

projects

string

The IDs of projects associated with the task. Each ID should be separated by a comma.

parent

string

The ID of the parent task.

start_on

string

The start date of the task in YYYY-MM-DD format.

due_on

string

The due date of the task in YYYY-MM-DD format (optional).

Output:

Show output

permalink_url

string

The permalink URL of the task.

Update task

Updates an existing task in Asana. Input fields:

Show input fields

Name

name

string

The name of the task.

Notes

notes

string

The description of the task.

Assignee

assignee

string

The ID of the user to assign to the task. Enter me to assign to the current user.

Start On

start_on

string

The start date of the task in YYYY-MM-DD format.

Due On

due_on

string

The due date of the task in YYYY-MM-DD format.

Task ID

taskId

string

required

The ID of the task to update.

Completed

completed

string

If you want to mark the task as completed, enter true. Otherwise, the task will keep its previous status.

Output:

Show output

permalink_url

string

The permalink URL of the updated task.

Find user

Finds an Asana user and their associated metadata. Input fields:

Show input fields

User Email

userEmail

string

The email address of the user to find.

Output:

Show output

gid

string

The found user’s global ID (GID).

string

The found user’s email address.

photo

object | null

The found user’s profile photo.

Show child attributes

image_21x21

string

required

The image URL in 21x21 resolution.

image_36x36

string

required

The image URL in 60x60 resolution.

image_60x60

string

required

The image URL in 60x60 resolution.

image_128x128

string

required

The image URL in 128x128 resolution.

resource_type

string

The type of the resource within Asana’s data model.

workspaces

object[]

An array of the found user’s workspaces.

Show child attributes

gid

string

required

The workspace’s global ID (GID).

name

string

required

The name of the workspace.

resource_type

string

required

The type of the resource within Asana’s data model.

Add comment to task

Adds a comment to a task in Asana. Input fields:

Show child attributes

Task ID

taskId

string

required

The ID of the task to comment on.

Comment

comment

string

required

The content of the comment.

Output:

Show child attributes

text

string

required

The text of the added comment.

Get Started

Functional Integrations

Integration Guides

Prerequisites

Setting up the Asana integration in Botpress

Setting up Asana

Cards

Create task

Update task

Find user

Add comment to task

Get Started

Functional Integrations

Integration Guides

​Prerequisites

​Setting up the Asana integration in Botpress

​Setting up Asana

​Cards

​Create task

​Update task

​Find user

​Add comment to task

Prerequisites

Setting up the Asana integration in Botpress

Setting up Asana

Cards

Create task

Update task

Find user

Add comment to task