Docs

Trello

This integration allows you to connect your Botpress bot with Trello, a leading project management platform. With this integration, you can easily manage your boards, lists and cards directly from your bot.

Prerequisites

Setup in Botpress

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

The Trello integration has the following settings:

  • Enabled: Whether Botpress will communicate with Trello
  • Webhook URL: The URL for receiving data in Botpress
  • API Key: The API key for the Trello Power-Up
  • Token: The token for the Trello Power-Up

Setup in Trello

  1. Visit the Power-Ups Admin Page and click the New button to obtain the API key. Name the Power-Up as “Botpress Connector”, fill in the email and author fields, then click Create.
  2. Once the Power-Up is created, you will be redirected to API Key settings page, displayed below. Generate a new API key, then copy and paste this key into the API Key field in Botpress.
  1. Click on the “Token” link (marked in the image below) and authorize the Power-Up access to your Trello account by selecting Allow.
  1. After authorization, copy the displayed token and paste it into the Token field in Botpress.
  2. Make sure the integration is enabled then press the button “Save configuration”.

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

Cards

Add card comment

Add a new comment to a card

inputobject
outputobject

Create new card

Create a card and add it to a list

inputobject
outputobject

Delete card

Deletes a card by its unique identifier

inputobject

Get all board members

Get all members of a board

inputobject
outputobject

Get all boards

Get all boards managed by the authenticated user

outputobject

Get all card members

Get all members of a card

inputobject
outputobject

Get board by ID

Get a board by its unique identifier

inputobject
outputobject

Get members by name

Find all members whose display name match this name

inputobject
outputobject

Get boards by name

Find all boards whose display name match this name

inputobject
outputobject

Get card by ID

Get a card by its unique identifier

inputobject
outputobject

Find cards by name

Find all cards whose display name match this name

inputobject
outputobject

Get cards in list

Get all cards in a list

inputobject
outputobject

Get list by ID

Get a list by its unique identifier

inputobject
outputobject

Get lists by name

Find all lists whose display name match this name

inputobject
outputobject

Get lists in board

Get all lists in a board

inputobject
outputobject

Get member by ID or username

Get a member by their unique identifier or username

inputobject
outputobject

Move card down

Move a card n spaces down

inputobject
outputobject

Move card to another list

Move a card to another list within the same board

inputobject
outputobject

Move card up

Move a card n spaces up

inputobject
outputobject

Update card

Update the details of a card

inputobject
outputobject

Triggers

Card Attachment Added

Triggered when an attachment is added to a card

payloadobject

Checklist Added To Card

Triggered when a checklist is added to a card

payloadobject

Card Label Added

Triggered when a label is added to a card

payloadobject

Member Added To Card

Triggered when a member is added to a card

payloadobject

Comment Created

Triggered when a comment is added to a card

payloadobject

Card Created

Triggered when a card is created

payloadobject

Checklist Item Created

Triggered when a checklist item is added to a card

payloadobject

Card Attachment Removed

Triggered when an attachment is removed from a card

payloadobject

Card Deleted

Triggered when a card is deleted

payloadobject

Checklist Item Deleted

Triggered when a checklist item is removed from a card

payloadobject

Comment Deleted

Triggered when a comment is deleted from a card

payloadobject

Card Label Removed

Triggered when a label is removed from a card

payloadobject

Member Removed From Card

Triggered when a member is removed from a card

payloadobject

Card Updated

Triggered when a card is updated

payloadobject

Checklist Item Updated

Triggered when a checklist item is modified on a card

payloadobject

Checklist Item Completion Updated

Triggered when the completion status of a checklist item is updated

payloadobject

Comment Updated

Triggered when a comment is updated on a card

payloadobject

Card Votes Updated

Triggered when a vote is added to or removed from a card

payloadobject