Przejdź do treści
Intum

Obsługa zgłoszeń

Aktualizacja: • 2 min czytania

Przejdź do sekcji

  1. Zgłoszenia (Tickets)
  2. Tworzenie zgłoszenia
  3. Statusy
  4. Priorytety
  5. Przydzielanie
  6. Odkładanie (snooze)
  7. Komentarze
  8. Załączniki
  9. Powiązanie z zadaniami
  10. Powiadomienia e-mail

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"
  }
}