Endpointy
| Metoda | Ścieżka | Opis |
|——–|———|——|
| GET | /helpdesk/tickets.json | Lista zgłoszeń |
| GET | /helpdesk/tickets/:id.json | Pojedyncze zgłoszenie |
| POST | /helpdesk/tickets.json | Utworzenie zgłoszenia |
| PATCH | /helpdesk/tickets/:id.json | Aktualizacja zgłoszenia |
| DELETE | /helpdesk/tickets/:id.json | Usunięcie zgłoszenia |
| POST | /helpdesk/tickets/:id/close | Zamknięcie (status: resolved) |
| POST | /helpdesk/tickets/:id/reopen | Ponowne otwarcie |
| POST | /helpdesk/tickets/:id/snooze | Odłożenie do daty |
| POST | /helpdesk/tickets/:id/unsnooze | Cofnięcie odłożenia |
| POST | /helpdesk/tickets/:id/change_bulk_option | Zmiana statusu/odpowiedzialnego |
Autoryzacja: Authorization: Bearer TOKEN (uprawnienie: helpdesk)
Pola ticket
| Pole | Typ | Wymagane | Opis |
|——|—–|———-|——|
| title | string | tak | Tytuł zgłoszenia |
| content | text | nie | Treść zgłoszenia |
| status | string | nie | open, in_progress, waiting, resolved |
| priority | string | nie | low, normal, high, urgent |
| desk_id | integer | tak | ID desku |
| category_id | integer | nie | ID kategorii |
| selected_responsible_id | string | nie | ID odpowiedzialnego (user lub grupa) |
| client_id | integer | nie | ID klienta CRM |
| client_email | string | nie | E-mail klienta |
| internal_note | text | nie | Notatka wewnętrzna |
| read | boolean | nie | Czy przeczytane |
| task_ids | array | nie | ID powiązanych zadań |
Filtrowanie (GET /helpdesk/tickets.json)
| Parametr | Opis |
|———-|——|
| q | Szukaj w: number, title, content, client_email |
| status | Filtruj po statusie |
| priority | Filtruj po priorytecie |
| desk_id | Filtruj po desku |
| category_id | Filtruj po kategorii |
| responsible_id | Filtruj po odpowiedzialnym |
| client_id | Filtruj po kliencie CRM |
| snoozed | yes = tylko odłożone, puste = bez odłożonych |
| created_at_from, created_at_to | Zakres dat utworzenia |
Komentarze
| Metoda | Ścieżka | Opis |
|——–|———|——|
| POST | /helpdesk/tickets/:ticket_id/comments.json | Dodanie komentarza |
| PATCH | /helpdesk/tickets/:ticket_id/comments/:id.json | Edycja komentarza |
| DELETE | /helpdesk/tickets/:ticket_id/comments/:id.json | Usunięcie komentarza |
Pola komentarza
| Pole | Typ | Opis |
|——|—–|——|
| content | text | Treść komentarza (wymagane) |
| internal | boolean | true = notatka wewnętrzna, false = widoczna dla klienta |
Snooze
POST /helpdesk/tickets/:id/snooze
{
"snoozed_until": "2026-03-15"
}
Przykład utworzenia
{
"api_token": "TOKEN",
"ticket": {
"title": "Problem z logowaniem",
"content": "Klient nie może się zalogować po zmianie hasła",
"desk_id": 1,
"priority": "high",
"client_email": "klient@firma.pl"
}
}