# Epic OP-13533 - Spike: Integrate OpenProject in Matrix Hookshot

Project: OpenProject
Status: new
URL: https://community.openproject.org/work_packages/OP-13533

## Detailed specification

### Motivation and background information

### Acceptance criteria

### Out of scope

| Attribute | Value |
| --- | --- |
| Mockups |  |

## Planning

| Attribute | Value |
| --- | --- |
| Roadmap |  |
| Date | 2023-10-17 –  |
| Votes |  |
| List |  |
| Target versions | Wish List |
| Sprint |  |
| Backlog bucket |  |
| Relevance |  |

## Subitems

_No work packages_

## Bugs and other work packages

_No work packages_

## Details

| Attribute | Value |
| --- | --- |
| Module |  |
| Enterprise plan |  |
| Labels |  |

## People

| Attribute | Value |
| --- | --- |
| Assignee |  |
| Accountable |  |
| Product manager |  |
| Feature Lead |  |
| Designer |  |
| Developers |  |
| Requested by |  |
| Interest by |  |

## Estimates and progress

| Attribute | Value |
| --- | --- |
| Work |  |

## Description

# User Problem

## User

*What persona, persona segment, or customer type experiences the problem most acutely?*

  - Project teams from the public sector that chose the openDesk collaboriation plattform
  - Project teams in highly regulated industries with demanding requirements concerning data security and data privacy.
  - Project teams from organizations that already use either OpenProject or Element/Matrix (Open Source Evangelists)

## Problem

  - Team communication and collaboration is spreat across different tools and channels.
  - Chat tools lack workflow features. It is difficult to really ensure a process and to track process.
  - Ticketing tools don't allow for a fluent communication.
  - Information is duplicated.

## Pain

  - Users are asked in the chat to do something. It is hard to track if this has been done. Esspecially for a third party.
  - The user always have to search in multiple places
      - Mail
      - Chat
      - Ticketing system

# Business Case

## Solution

*How do we solve the user’s problem. What is our “pain killer”? What must we achieve in the first version of the solution in order to achieve value for the user?*

  - Integration into [Matrix Hookshot](https://github.com/matrix-org/matrix-hookshot) (similar to GitHub and GitLab)
  - OAuth authentication process

## Out of Scope for the MVC

*What should NOT be in the minimal viable change, and can be considered for future iterations? Why? Please order them by importance.*

  - Time tracking
  - Pushing notifications from OpenProject to Element
  - Opening a work package inside of Element

## Differentiation

*What do you believe will differentiate us from the current experience or competitive experiences?*

  - There are other applications that already do this.

## Next iteration

*What is the next solution that would allow us to release meaningful customer value quickly?*

  - Subscription to OpenProject notifications in Element/Matrix app through webhooks
  - Adding a user to a channel gives the user the needed permissions in a corresponing OpenProject project.
  - Creating a project automatically creates a channel
  - Adding, removing a project member in OpenProject adds/removes members from the Matrix channel.

# Launch and Growth

## Measures

*How will you know you solved the problem? Please list measurable, quantitative indicators (preferred) or qualitative ways you plan on assessing the solution?*

  - 1000 installations within one quarter.
  - The Element team decides to use OpenProject for project management
  - We use it internally at OpenProject
  - We use it at the openDesk project

## Messaging

*If you were to write a press release, how would you describe the value to customers?*

<figure class="table op-uc-figure_align-center op-uc-figure"><table class="op-uc-table"><tbody><tr class="op-uc-table--row"><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Headline</p></th><td class="op-uc-table--cell"><p class="op-uc-p">Element and OpenProject launched an integration</p></td></tr><tr class="op-uc-table--row"><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">First Paragraph</p></th><td class="op-uc-table--cell"><p class="op-uc-p">The Element Hookshot now supports OpenProjec.t This allows project teams to easily create tasks from chat messages.</p></td></tr><tr class="op-uc-table--row"><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Customer Quote</p></th><td class="op-uc-table--cell"><p class="op-uc-p">"I always missed the ability to create tasks from my chat integration. With the new integration I can now easily create task from Element without leaving my chat application."</p></td></tr></tbody></table></figure>

## Go to market

*How are you planning on getting this into users' hands?*
