README

getodden/crm-service is Odden's help desk module: support tickets with threaded conversations, SLA policies with business hours, ticket routing, canned responses, ticket merging, a knowledge base, a customer portal, an embeddable chat widget, and an email-to-ticket webhook. It is headless; use the Filament admin or build your own agent screens.

Requirements

• PHP 8.3 or newer
• Laravel 12 or 13
• getodden/crm-core (installed automatically)

Installation

composer require getodden/crm-service
php artisan migrate

The service provider is auto-discovered and loads its own migrations. Publish the config file only if you need to change something:

php artisan vendor:publish --tag=odden-service-config

Optionally publish the chat widget script into your public directory (it is also served at /api/service/widget.js):

php artisan vendor:publish --tag=odden-service-widget

Schedule the SLA and automation commands listed in the installation guide.

Documentation

• Service overview
• Tickets, SLA policies, routing, canned responses and merging
• Knowledge base, customer portal, chat widget, email to ticket
• Configuration, routes and commands

The full documentation lives in the docs/ folder of the monorepo, which is the single source of truth for behavior, signatures, configuration keys and commands. This README only covers installing the package.

Testing

composer install
vendor/bin/pest

License

MIT. See LICENSE.md.