{"id":15027433,"url":"https://github.com/badchoice/handesk","last_synced_at":"2025-05-15T08:07:48.775Z","repository":{"id":37588038,"uuid":"99229860","full_name":"BadChoice/handesk","owner":"BadChoice","description":"A Powerful Laravel Help Desk and Lead Management App","archived":false,"fork":false,"pushed_at":"2024-10-02T14:29:23.000Z","size":5459,"stargazers_count":1428,"open_issues_count":117,"forks_count":400,"subscribers_count":37,"default_branch":"dev","last_synced_at":"2025-04-03T18:52:29.744Z","etag":null,"topics":["lead","php","support","ticket","ticketing"],"latest_commit_sha":null,"homepage":"https://github.com/BadChoice/handesk","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BadChoice.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-08-03T12:24:19.000Z","updated_at":"2025-03-22T23:05:50.000Z","dependencies_parsed_at":"2024-11-21T02:02:30.241Z","dependency_job_id":null,"html_url":"https://github.com/BadChoice/handesk","commit_stats":{"total_commits":678,"total_committers":50,"mean_commits":13.56,"dds":"0.37315634218289084","last_synced_commit":"479f359c4a114c5d56567c31e322f1dc26f9bdf8"},"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BadChoice%2Fhandesk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BadChoice%2Fhandesk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BadChoice%2Fhandesk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BadChoice%2Fhandesk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BadChoice","download_url":"https://codeload.github.com/BadChoice/handesk/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248439812,"owners_count":21103684,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["lead","php","support","ticket","ticketing"],"created_at":"2024-09-24T20:06:25.736Z","updated_at":"2025-04-11T16:26:49.309Z","avatar_url":"https://github.com/BadChoice.png","language":"PHP","readme":"# Handesk\n\n## Description\nHandesk has been created by our need (At Revo Systems www.revo.works) to have a powerful yet simple Ticketing system, we needed a system that allowed us to\nhave multiple teams, with multiple users, easy and efficient reporting by all/team/user as well as lead management.\n\n[Landing page: http://handesk.io](http://handesk.io)\n\nCheck out the screenshots to see how nice it looks, and feel free to contribute by sending us PRs.\nWe will keep adding features as we need them, but our basic workflow is totally covered :D\n\n## Features\n- Email polling (new tickets and tickets updates)\n- Email attachments as ticket attachments (using laravel storage driver)\n- API for creating/updating/fetching tickets/leads so you can display them into your main app\n- Instant email/slack notifications when tickets are created/updated\n- Everything is unlimited\n- Lead management (With its API as well)\n- Auto lead subscription to mailChimp based on its tags\n- Tickets reporting\n- Tickets internal notes\n- Tickets can be escalated, so assistants can comment on them to help the teams\n- Can merge tickets\n- Mention agents with @name so they get notified\n- Lead tasks, that can have a due date, and sending daily tasks email\n- Create issues to your code repository directly from the ticket\n- Updating the ticket automatically when an issue is marked as resolved\n- UI multi language support (default en, alternative ca, de, fr, es)\n- Roadmap module, you can create ideas that come from your customers or your own, give them deadlines and integrate them with your repository manager,\nyou can even create ideas from support tickets so you never lose track.\n- You can also create ideas by sending an email to you support accounts starting with `Idea:` it will create an idea instead of a ticket\n- Ticket rating, when a ticket is solved a rating email is sent to the customer (check config/handesk.php to disable it)\n\n\u003e Follow us on twitter [@codepassionapp](https://twitter.com/codepassionapp) to stay tuned\n\n\n## Installation\nIts very simple, you just need to follow the standard Laravel installation\n\n```shell\ngit clone https://github.com/BadChoice/handesk.git\ncd handesk\ncomposer install\n# Setup your .env file to match your desired database\nphp artisan key:generate\n\n# Purge the cache before running migrations\nphp artisan config:cache\nphp artisan config:clear\n\n# Run migrations and seed\nphp artisan migrate --seed\nphp artisan storage:link #if you use the local driver\n```\n\nAlternatively, you can use the following [docker setup](https://github.com/BadChoice/handesk/blob/dev/docker-installation.md)\n\n\n\u003e The default admin user is admin@handesk.io / admin\n\u003e If you want email pulling, you need to enable the `imap` extension on php (note that on mac the php-cli runs very slow, you need to update your /etc/hosts file\n\n```\n::1         localhost YourMac.local\n127.0.0.1   localhost YourMac.local\n```\n\nOpen your `app/Console/Kernel.php` to update the schedulers as you want (comment them if not needed)\nAdd the cron job `* * * * * php /path-to-your-project/artisan schedule:run \u003e\u003e /dev/null 2\u003e\u00261`\n\n### Further configuration\n#### Email pulling\nEnter your mail credentials in .env\n\n````\nMAIL_FETCH_HOST=pop3.handesk.com\nMAIL_FETCH_PORT=110\nMAIL_FETCH_USERNAME=hello@handesk.com\nMAIL_FETCH_PASSWORD=secret-password\n````\n\n### Sidebar\nYou can toggle the visibility of `leads` and `ideas` in the `config/handesk.php` file.\n```\n'leads'    =\u003e env('HANDESK_LEADS_ENABLED', true),\n'roadmap'  =\u003e env('HANDESK_ROADMAP_ENABLED', true),\n```\n\n#### Mailchimp\nSet your mailchimp key in .env\n`MAILCHIMP_API_KEY=448027f3acac5594605be3adf78be862-us15`\n\nAnd enter the relation of `tags =\u003e list` id in `config/services.php` mailchimp section\n\n#### Bitbucket\nYou can create issues directly to your code repository from tickets. You need to setup your credentials in the .env\n```\nBITBUCKET_USER=bitbucket-user-if-using-basic-auth\nBITBUCKET_PASSWORD=bitbucket-password-if-using-basic-auth\n```\n\nAnd enter your repositories list in `config/issues.php` file, filling the `repositories` field.\n\nYou can event update the tickets automatically (adding a private note using bitbucket webhooks).\nYou just need to go to your report webhooks settings and add a new webhook with the url\n\n`http://{handesk.io}/webhook/bitbucket`\n\nYou just need to check the `issues updated` option\n\n\n#### Api Token\nSet your desired API token in the .env\n\n```API_TOKEN=the-api-token```\n\nWe have the following SDK's to easily interact with Handesk api\nThere is the `badchoice/handesk-php` package in packagist to easily talk with the api.\n[Handesk-php](https://github.com/BadChoice/handesk-php)\n[Handesk-ios](https://github.com/BadChoice/handesk-ios) *In progress*\n\n### Screenshots\n![Tickets screenshot](https://raw.githubusercontent.com/BadChoice/handesk/master/resources/screenshots/tickets.png)\n![Ticket screenshot](https://raw.githubusercontent.com/BadChoice/handesk/master/resources/screenshots/ticket.png)\n![Leads screenshot](https://raw.githubusercontent.com/BadChoice/handesk/master/resources/screenshots/leads.png)\n![Lead screenshot](https://raw.githubusercontent.com/BadChoice/handesk/master/resources/screenshots/lead.png)\n![Invitation screenshot](https://raw.githubusercontent.com/BadChoice/handesk/master/resources/screenshots/invitation.png)\n![Email screenshot](https://raw.githubusercontent.com/BadChoice/handesk/master/resources/screenshots/email.png)\n\n## Community\nWe have a slack channel at [https://handesk.slack.com/](https://handesk.slack.com)\nAnd you can join with the following [invitation](https://handesk.slack.com/shared_invite/enQtMzQwMTg5ODkwNDUxLWVhYjFkNzNkMmE2NWUxYjcwZTNhMmM0M2M3NmVkMzdhNWI0NTU0ZGM0ODFlNTVlMGZhMTA0YzM0YjA3NjcxMTc)\n\nJoin in with the following link\n\n[Join handesk slack](https://join.slack.com/t/handesk/shared_invite/enQtMzg4MzE4ODcwNzg2LTlmZTk4NGRjZDA5N2ExYTI2ZDhhNzAyOThmMDM1YjgwZTMzZTQ5ZjkxNDVlNzIwY2ZkZWExN2U2NDUwNWFiOWU)\n\nOr you can follow me on twitter too\n[@codepassionapp](https://twitter.com/codepassionapp)\n\nEven at instragram [codepasssion.io](https://www.instagram.com/codepassion.io/)\n\n\n## Development\nWe try to follow a TDD approach as well as some mixed functional CSS for the frontend.\n\n**PRs are welcome!**\n\n## License\nHandesk is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).\n\nSpecial thanks to [Jetbrains](https://www.jetbrains.com) for their support to open source projects!\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbadchoice%2Fhandesk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbadchoice%2Fhandesk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbadchoice%2Fhandesk/lists"}