Quickstart
From an empty account to a ticket with full diagnostic context.
1. Create a site
A site is one product you support. Create one in the dashboard, then verify its domain so ChaosDesk knows you control it. Unverified sites cannot accept tickets.
2. Issue an ingest token
Open Site settings, then Integration, and generate a token. It is shown once and stored only as a hash; if you lose it, generate a new one. Put it in your application environment:
CHAOSDESK_URL=https://chaosdesk.eu/api/v1
CHAOSDESK_SITE_TOKEN=your-ingest-tokenThis token is a server-side secret. Never expose it to a browser or ship it in a mobile app.
3. Configure priorities and SLA targets
Under Priorities, define the levels you use. Under SLA, set your business hours, timezone and holidays, then the working minutes allowed per priority for a first response and for resolution. Leave every weekday disabled to run a 24/7 clock.
4. Submit a ticket
curl -X POST https://chaosdesk.eu/api/v1/public/tickets \
-H "X-Site-Token: $CHAOSDESK_SITE_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"email": "[email protected]",
"subject": "Cannot save my settings",
"message": "The form reverts every time I press save.",
"context": {
"source": "web",
"app": {"name": "Acme", "version": "2.4.1"},
"page": {"url": "https://acme.test/settings"},
"user": {"external_id": "4711", "plan": "pro"}
}
}'The response carries the ticket and a per-ticket access token. Store that token against the user so they can view and reply to the thread later.
5. Use the Laravel SDK instead
If your application is a Laravel app, the SDK does all of the above for you, including collecting the context.
composer require three_oh_eight/laravel-chaosdesk<livewire:chaosdesk-support />