How tutujaru/ticketz works
Ticketz is a WhatsApp-based communicator with CRM and helpdesk features. Users work through the frontend to manage contacts, conversations, tickets, queues, and campaigns; agents handle ticket/message activity while WhatsApp integrations carry customer communications. The backend separates HTTP routing and controllers from domain services and persistent models, with Socket.IO supporting live updates. The README also documents dashboard, subscription/payment, and Docker-management capabilities. Many of those modules are listed in the tree but were not sampled, so their internal connections are omitted rather than inferred.
Main entry points: UpdateTicketService.ts Ticket handling · WhatsappCloudApiService.ts Cloud API · ContactServices Contact management · server.ts Backend startup
Components 23
User interface
- Ticketz UI
frontend/src/App.js
Backend API
- Contact endpoints
backend/src/controllers/ContactController.ts - Contact routes
backend/src/routes/contactRoutes.ts - Message endpoints
backend/src/controllers/MessageController.ts
CRM and helpdesk
- Ticket handling
backend/src/services/TicketServices/UpdateTicketService.ts - Ticket records
backend/src/models/Ticket.ts - Contact management
backend/src/services/ContactServices - Contact records
backend/src/models/Contact.ts - Message records
backend/src/models/Message.ts - Queue configuration
backend/src/models/Queue.ts - Campaign management
backend/src/services/CampaignService - Dashboard reporting
backend/src/services/ReportService/DashboardService.ts
Messaging integrations
- WhatsApp sessions
backend/src/services/WbotServices/StartWhatsAppSession.ts - Inbound messages
backend/src/services/WbotServices/wbotMessageListener.ts - Cloud API
backend/src/services/WhatsappCloudApiService.ts - WhatsApp accounts
backend/src/models/Whatsapp.ts
Platform services
- Live events
backend/src/libs/socket.ts - Backend startup
backend/src/server.ts - Database setup
backend/src/database/index.ts - Plans and payments
backend/src/services/PaymentGatewayServices/PaymentGatewayServices.ts - Container management
backend/src/services/DockerServices
Other components
- Agents and admins
Connections 17
- Agents and admins → Ticketz UI: uses
README.md - Ticketz UI → Contact routes: requests contacts
- Contact routes → Contact endpoints: routes to
backend/src/routes/contactRoutes.ts - Contact endpoints → Contact management: calls
backend/src/controllers/ContactController.ts - Contact management → Contact records: persists contacts
- Message endpoints → Ticket handling: loads ticket
backend/src/controllers/MessageController.ts - Ticket handling → Ticket records: updates ticket
backend/src/services/TicketServices/UpdateTicketService.ts - Ticket handling → Message records: uses messages
backend/src/services/TicketServices/UpdateTicketService.ts - Inbound messages → Ticket handling: updates tickets
backend/src/services/TicketServices/UpdateTicketService.ts - WhatsApp sessions → WhatsApp accounts: loads accounts
- WhatsApp → Inbound messages: sends messages
- Cloud API → Contact management: creates contacts
backend/src/services/WhatsappCloudApiService.ts - Cloud API → Ticket handling: opens tickets
backend/src/services/WhatsappCloudApiService.ts - Cloud API → Message records: creates messages
backend/src/services/WhatsappCloudApiService.ts - Backend startup → Live events: initializes
backend/src/server.ts - Backend startup → Database setup: initializes
- Ticket handling → Live events: emits updates
backend/src/services/TicketServices/UpdateTicketService.ts