SwiftKanban supports adding cards on a Kanban board via email and then adding attachments and comments in due course of time. This feature is intended to help Support and Helpdesk teams, who get a lot of support tickets and issues reported to them via email. With this feature, Support teams members using SwiftKanban for managing their support activities can automatically convert such emails to Ticket/ Issue cards on their Kanban boards and also add comments or attachments them based on work progress or customer email interaction.
Specifically, the following card operation are supported using the E-mail integration feature:
- Adding Card: Create and add a new card on Kanban board
- Adding Comment: Add new comments
- Assigning Owners: Assign resources to a card
- Adding Attachment: Attach a file sent via email to an existing card
- Moving Card or Updating Card Status: Get email notification for card movement or status updates
To add a card via e-mail, you need to send an e-mail in the following format:
- Subject: <ProjectUniqueID:CardType> Card Title
Note: ProjectUniqueID is the unique id of the Board which you can find under the Additional Details section on the Board Profile. This id identifies the Board and creates the card there. To access the Board Profile menu, go to Board menu, and then select Board Profile.
- CC: Card Owner(s)
- E-mail Body Description of the Card
- Attachments: Files to be attached to the card
Following is an example of an e-mail sent to add a card:
The following are details required to send an e-mail:
To: System Email alias for creating a card is firstname.lastname@example.org.
Project Unique ID to mention in email subject
To find the Project Unique ID, go to Board Profile as shown below, and click the Additional Details link.
On successful creation of card, you will receive an acknowledgment e-mail confirming that a card has been added, and provide its details:
Once the above e-mail is sent, a card is created with the following details:
- Project Unique id: 1541322
- Card Id: TASK3
- Title: SwiftKanban Demo
- Card Description: Requested by *****@digite.com – Can you please organize a demo on SwiftKanban.
- Card Owner: Unassigned
The card is assigned to the user whose e-mail id is entered in the CC field of your e-mail. If no e-mail id is mentioned or if the email id is invalid, then the card remains “Unassigned”.
Note that once a card is assigned to a card owner, the owner cannot be updated any longer via e-mail. Of course, you can modify it within SwiftKanban.
Once a card has been added to a Kanban board, users can interact with each other using the Comments feature of the card. These comments can be directly added within SwiftKanban (if users have access to SwiftKanban), or can be added via email.
To add comments on the card via email, you must have the system acknowledgement email that was sent after card creation. You will receive this acknowledgement email if you are card creator, card owner, or board manager for the card. To add a new comment, simply reply to the acknowledgement e-mail without changing the subject as shown in the e-mail below:
Once the comment is added, the following acknowledgement e-mail is sent:
The newly added comment displays on the card as shown below:
Important: The subject line of the acknowledgement e-mail has ProjectUniqueId:Cardtype#CardId>. Do not make any changes to the subject line of the acknowledgment e-mail when replying to the e-mail.
To add one or more files as attachments to a Kanban card, you can either attach them to the email to add the card or, you can attach the files directly within SwiftKanban after the card has been created on the board.
To attach a file while creating a new card, simply attach those files to the initial email you send in. Once the card is created, you can also attach files while replying to the acknowledgment e-mail. Such attachments in the reply email are also appended to the card and will be shown in the Attachments tab of the card.
Important: The subject line of the acknowledgement email has <ProjectUniqueId:Cardtype#CardId>. Do not make ANY changes to the subject line of the acknowledgment email when replying to the email.
Once the comment is added, you will receive an acknowledgment email.
Changes made to cards (new comments or attachments) are highlighted on the card on board as shown below:
An update notification is sent by e-mail when the card is:
You will receive the update notifications if you have either created the card or you are the card owner for it.
Any card movement across the board triggers an e-mail to you as the creator of the card to keep you updated on the card status. For example, if the card is moved from Backlog to the Board, you will receive an e-mail as shown below:
When the card is archived, you will also receive an acknowledgment mail: