An open API service indexing awesome lists of open source software.

https://github.com/telexintegrations/task-prioritizer

A custom integration that automatically notifies Telex team members of High priority tasks from jira
https://github.com/telexintegrations/task-prioritizer

Last synced: 10 months ago
JSON representation

A custom integration that automatically notifies Telex team members of High priority tasks from jira

Awesome Lists containing this project

README

          

# Task Prioritizer Integration

## Overview

Task Prioritizer is a FastAPI-based integration that detects high priority tasks from Jira and notifies telex team members automatically. This helps ensure that high-priority issues get the attention they need.

## Features

- Listens for Jira webhook events (`jira:issue_created`).
- Extracts task details (issue key, summary, priority, assignee).
- Filters and processes only high-priority tasks.
- Sends real-time notifications to a telex channel.

## Setup Instructions

### 1. Clone the Repository

```bash
git clone https://github.com/malachsalama/Task-Prioritizer.git
cd Task-Prioritizer
```

### 2. Install Dependencies

```bash
pip install -r requirements.txt
```

### 3. Set Up Environment Variables

Create a `.env` file in the project root and define:

```ini
TELEX_WEBHOOK_URL=https://ping.telex.im/v1/webhooks/01951eae-6cb0-720c-bfd5-0a345fae22fa
```

### 4. Run the Application

Start the FastAPI server:

```bash
uvicorn main:app --host 0.0.0.0 --port 8000 --reload
```

## Testing the Integration

### 1. Manually Trigger a Webhook Event

Send a test request to the webhook endpoint:

```bash
curl -X POST "https://task-prioritizer.onrender.com/api/v1/jira-webhook" \
-H "Content-Type: application/json" \
-d '{
"webhookEvent": "jira:issue_created",
"issue": {
"key": "TEST-123",
"fields": {
"summary": "Treat this task urgently!",
"priority": {
"name": "High"
},
"assignee": {
"displayName": "Malach Salama"
}
}
}
}'
```

### Expected Response

```
{
"status": "success",
"message": "Notification sent to Telex."
}
```

### 2. Verify Telex Notification

- If successful, a Slack message should appear in the configured channel.
- If it fails, an error message is sent instead.

## Contributing

Feel free to open an issue or submit a pull request if you have improvements!

## License

MIT License