Documentation & Tutorial

HelpDesk AI Docs

Quick start, fitur lengkap, dan kredensial akses demo. Cocok untuk evaluasi maupun saat onboarding tim.

Akses Demo

Semua akun di-seed otomatis. Password sama untuk semua: password

Role Email Password Akses
Admin admin@helpdesk.test password Full admin panel di /admin
Agent agent@helpdesk.test password Tickets, conversations, knowledge base
Customer customer@helpdesk.test password Dashboard user, submit ticket
Bulk Customer customer0@demo.test … customer299@demo.test password 300 akun customer untuk uji pagination & load
Bulk Agent agent0@demo.test … agent39@demo.test password 40 akun agent untuk uji assignment & workload

Database juga ter-seed dengan ~7.500 record demo: 3.505 tickets, 1.805 replies, 150 conversations + 1.500 messages, 156 knowledge articles, 60 blog posts, 45 services.

Cara Jalan (Local Install)

  1. Clone repo dan masuk ke folder project.
  2. Copy .env.example ke .env, isi DB_* dengan kredensial MySQL lokal.
  3. Jalankan perintah berikut:
composer install
npm install && npm run build
php artisan key:generate
php artisan migrate:fresh --seed
php artisan db:seed --class=DemoDataSeeder   # optional: 5k+ demo records
php artisan storage:link
php artisan serve                            # http://localhost:8000
# untuk realtime chat (opsional):
php artisan reverb:start
php artisan queue:work

Fitur Utama

Ticket Management

Multi-channel (web, email piping, API), SLA, prioritas, kategori, departement, bulk action, star.

AI Auto-Reply & Classification

Pluggable provider (OpenAI, Anthropic, Gemini, Ollama, dll.) — BYOK, user input API key sendiri.

Knowledge Base + FAQ

Public knowledge base + search, FAQ, kategori, view counter.

Conversations (Live Chat)

Realtime via Laravel Reverb, agent assignment, internal note.

Canned Responses & Automation

Template balasan, rules engine untuk auto-assign, auto-tag, auto-reply.

SLA & Analytics

Policy per kategori/prioritas, first-response, resolution time, charts.

Email Templates

Notification email yang fully editable di admin panel.

Programmatic SEO

Halaman /best-helpdesk-software, /compare/{a}-vs-{b}, /alternatives-to/{slug}, sitemap.xml dinamis.

API Keys + Sanctum

REST API + Bearer token, rate-limit, scope per key.

Activity Log

Audit trail seluruh aksi admin dan agent.

Multi-role RBAC

Spatie permission: admin / agent / customer + permission granular.

Dynamic AI Providers

20 preset JSON, 3 format adapter (OpenAI-compatible / Anthropic / Gemini) — provider baru cukup add di UI.

Tutorial Singkat

  1. Login sebagai Admin — buka /login, gunakan kredensial admin@helpdesk.test / password.
  2. Add AI Provider — di /admin/ai-providers/create, isi nama provider (bebas), pilih format (OpenAI-compatible / Anthropic / Gemini), masukkan API key & base URL. Klik "Test Connection" untuk validasi.
  3. Mapping AI Feature — di /admin/ai-features, pilih provider + model untuk tiap fitur (auto-classify, smart reply, sentiment, dll.).
  4. Buat Departemen & Kategori — /admin/departments dan /admin/categories.
  5. Tambah Tim Agent — /admin/users → New User → assign role "agent".
  6. Test Submit Ticket sebagai Customer — logout, login pakai customer@helpdesk.test, buka /tickets/create.
  7. Reply & Assign — dari admin panel, buka ticket, gunakan form reply, tombol assign, update status/priority.
  8. Public-facing Pages — /blog, /services, /knowledge-base, /contact, dan halaman pSEO seperti /best-helpdesk-software/2026.

REST API (Sanctum Bearer)

Login lewat POST /api/login untuk dapat token. Pasang di header Authorization: Bearer <token>.

Method Endpoint Fungsi
POST /api/login Login → dapat Bearer token
GET /api/me Profil user aktif
GET /api/tickets List ticket milik user
POST /api/tickets Buat ticket baru
GET /api/tickets/{id} Detail ticket
GET /api/knowledge List artikel KB
GET /api/knowledge/search?q= Cari artikel
GET /api/conversations List chat conversation
POST /api/conversations/{id}/message Kirim pesan chat
POST /api/ai/classify Klasifikasi subject+body
POST /api/ai/suggest Generate draft reply
POST /api/ai/sentiment Analisa sentimen pesan
GET /api/analytics/summary Ringkasan analytics 
curl -X POST https://helpdeskai.whitelabel.co.id/public/api/login \
  -H "Content-Type: application/json" \
  -d '{"email":"admin@helpdesk.test","password":"password"}'

# response: { "token": "1|abc...", "user": {...} }

curl https://helpdeskai.whitelabel.co.id/public/api/tickets \
  -H "Authorization: Bearer 1|abc..."

Quick Links

Admin Dashboard User Dashboard Blog Services Knowledge Base Contact sitemap.xml Best Helpdesk

Dokumentasi teknis lengkap (PRD, arsitektur, ERD, security, deployment) ada di folder docs/ repository — 15 file Markdown ~6.200 baris.