PHPackages                             tonsoo/task-tracker - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. tonsoo/task-tracker

ActiveLibrary[Utility & Helpers](/categories/utility)

tonsoo/task-tracker
===================

v1.0.1(2mo ago)00PHP

Since Feb 21Pushed 2mo agoCompare

[ Source](https://github.com/tonsoo/task-tracker)[ Packagist](https://packagist.org/packages/tonsoo/task-tracker)[ RSS](/packages/tonsoo-task-tracker/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (6)Versions (3)Used By (0)

Task Tracker
============

[](#task-tracker)

Um pacote Laravel que transforma mensagens recebidas do WhatsApp em tarefas acionáveis em qualquer gerenciador configurado (Trello, Linear, sistemas internos) usando extração de intenção por IA. Ele escuta webhooks do WhatsApp, interpreta mensagens via adapters, classifica a intenção com um LLM e orquestra operações no gerenciador de tarefas (criar/atualizar/fechar, adicionar contexto, etc.).

Recursos
--------

[](#recursos)

- **Ingestão de webhooks de mensageria** via `routes/api.php` para `MessagingWebhookController`
- **Padrão Adapter** para plataformas de mensagens (`MessagingAdapter`), com `WhatsAppAdapter` embutido
- **Registro automático de webhooks** para drivers de mensageria configurados
- **Análise de intenção por IA** usando `OpenAI` através do contrato `LLMClient`
- **Orquestração inteligente de tarefas** para deduplicar relatos e atualizar itens existentes
- **Integrações pluggable** via `TaskDriver` (Trello incluso por padrão)
- **Publicação de config** e configuração por ambiente (`config/task-tracker.php`)
- **Processamento em fila** com tratamento idempotente de mensagens recebidas

Início Rápido
-------------

[](#início-rápido)

1. **Instalação**

```
composer require tonsoo/task-tracker
```

2. **Publicar configuração**

```
php artisan vendor:publish --tag=task-tracker-config
```

3. **Variáveis de ambiente** (veja `.env.example` e `docs/concepts/configuration.md`)

```
WHATSAPP_TOKEN=...
WHATSAPP_FROM_NUMBER=...
WHATSAPP_FROM_ID=...
WHATSAPP_SECRET=...

TASK_TRACKER_DRIVER=trello

TRELLO_KEY=...
TRELLO_TOKEN=...
TRELLO_BOARD_ID=...
TRELLO_LIST_ID=...

OPENAI_API_KEY=...
OPENAI_MODEL=gpt-4.1-mini
TASK_TRACKER_AI_DRIVER=openai
```

4. **Rotas de webhook**

- GET `/webhooks/messaging/whatsapp` para verificação
- POST `/webhooks/messaging/whatsapp` para eventos

5. **Worker da fila**

```
php artisan queue:work
```

Arquitetura
-----------

[](#arquitetura)

- **Service Provider**: `src/TaskTrackerServiceProvider.php`

    - Faz bind de `LLMClient` para `OpenAILLMClient`
    - Faz bind do `TaskDriver`, do `TaskManager` e do `TaskOrchestrator`
    - Registra `WhatsAppAdapter`
    - Carrega rotas e publica config
- **HTTP**: `routes/api.php` → `MessagingWebhookController`

    - Verifica webhook (`whatsappAuth()`)
    - Interpreta payload via `WhatsAppAdapter` e despacha `ProcessIncomingMessageJob`
- **Messaging**: contrato `MessagingAdapter` + `WhatsAppAdapter` + `IncomingMessage`
- **IA**: `AiIntentAnalyzer` + `LLMClient` (implementação OpenAI)
- **Caso de Uso**: `ProcessIncomingMessage` → extrai intenção → delega ao `TaskOrchestrator`
- **Integrações**: `TaskDriver` (cria manager + orchestrator) + `TaskManager`

Ciclo (alto nível)
------------------

[](#ciclo-alto-nível)

1. Plataforma envia webhook → `MessagingWebhookController@ingest`
2. `WhatsAppAdapter` converte para `IncomingMessage[]`
3. Cada mensagem é enfileirada como `ProcessIncomingMessageJob` (lock idempotente por id da mensagem quando houver)
4. `ProcessIncomingMessage` usa `AiIntentAnalyzer` para obter `StructuredIntent`
5. `TaskOrchestrator`:
    - `bug_report`: encontra tarefa similar via palavras‑chave + IA; atualiza existente ou cria nova
    - `bug_fixed`: adiciona resolução e fecha a tarefa
    - `feature_request`: cria nova tarefa

Documentação
------------

[](#documentação)

- **[Visão Geral](docs/concepts/overview.md)**
- **[Instalação](getting-started.md)**
- **[Configuração](docs/concepts/configuration.md)**
- **[Uso](docs/concepts/usage.md)**
- **[Transcrições](docs/integrations/transcriptions.md)**
- **[Adapters de Mensageria](docs/integrations/adapters.md)**
- **[Análise de IA](docs/ai/overview.md)**
- **[Gerenciadores de Tarefas](docs/drivers/task-managers.md)**
- **[Integração com Trello](docs/drivers/trello.md)**
- **[HTTP & Webhooks](docs/integrations/http-webhooks.md)**
- **[Estendendo o Pacote](docs/concepts/extending.md)**

Requisitos
----------

[](#requisitos)

- PHP 8.2+
- Laravel 12.x
- Fila configurada e worker em execução
- Chave e token do gerenciador (Trello incluso)
- App do WhatsApp Cloud API configurado
- Chave de API da OpenAI

Contribuição
------------

[](#contribuição)

Issues e PRs são bem-vindos. Siga PSR-12 e rode testes/linters antes de enviar.

Licença
-------

[](#licença)

MIT

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance83

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity35

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~2 days

Total

2

Last Release

85d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/32c5f40ac08285ef9e848f0d7bc76d30cc427d3670c272e3b1151e0724a85898?d=identicon)[tonsoo](/maintainers/tonsoo)

---

Top Contributors

[![tonsoo](https://avatars.githubusercontent.com/u/81568701?v=4)](https://github.com/tonsoo "tonsoo (28 commits)")

---

Tags

ai-integrationaudio-transcriptionlaravel-packagellmopenai-apiphptask-trackertrello-apiwebhook-integration

### Embed Badge

![Health badge](/badges/tonsoo-task-tracker/health.svg)

```
[![Health](https://phpackages.com/badges/tonsoo-task-tracker/health.svg)](https://phpackages.com/packages/tonsoo-task-tracker)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3274.9M308](/packages/psalm-plugin-laravel)[watson/active

Laravel helper for recognising the current route, controller and action

3253.6M14](/packages/watson-active)[prologue/alerts

Prologue Alerts is a package that handles global site messages.

3486.1M30](/packages/prologue-alerts)[api-platform/laravel

API Platform support for Laravel

59126.4k6](/packages/api-platform-laravel)[dragon-code/pretty-routes

Pretty Routes for Laravel

10058.7k4](/packages/dragon-code-pretty-routes)[bakame/laravel-domain-parser

Laravel package to integrate PHP Domain parser.

26534.8k4](/packages/bakame-laravel-domain-parser)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)