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(4mo ago)00PHP Since Feb 21Pushed 4mo 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 today 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 31 — LowBetter than 66% of packages Maintenance76 Regular maintenance activity Popularity0 Limited adoption so far Community6 Small or concentrated contributor base Maturity36 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 132d 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 3355.3M346](/packages/psalm-plugin-laravel)[api-platform/laravel API Platform support for Laravel 58171.6k14](/packages/api-platform-laravel)[laravel/pulse Laravel Pulse is a real-time application performance monitoring tool and dashboard for your Laravel application. 1.7k15.1M132](/packages/laravel-pulse)[roots/acorn Framework for Roots WordPress projects built with Laravel components. 9762.4M131](/packages/roots-acorn)[sebdesign/laravel-viva-payments A Laravel package for integrating the Viva Payments gateway 4851.0k](/packages/sebdesign-laravel-viva-payments)[tomshaw/electricgrid A feature-rich Livewire package designed for projects that require dynamic, interactive data tables. 119.4k](/packages/tomshaw-electricgrid) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)