Przejdź do treści
Intum

Desk

Aktualizacja: • 2 min czytania

Przejdź do sekcji

  1. Deski (Desks)
  2. Kiedy używać wielu desków
  3. Konfiguracja desku
  4. Podstawowe ustawienia
  5. Numeracja zgłoszeń
  6. Skrzynka pocztowa
  7. Załączniki
  8. Bezpieczeństwo
  9. Treść pomocy
  10. Kod widgetu
  11. Statystyki

Endpointy

Metoda Ścieżka Opis
GET /helpdesk/desks.json Lista desków
GET /helpdesk/desks/:id.json Pojedynczy desk
POST /helpdesk/desks.json Utworzenie desku
PATCH /helpdesk/desks/:id.json Aktualizacja desku
DELETE /helpdesk/desks/:id.json Usunięcie desku

Autoryzacja: Authorization: Bearer TOKEN (uprawnienie: helpdesk)

Pola desk

Pole Typ Wymagane Opis
name string tak Nazwa desku
description text nie Opis desku
color string nie Kolor HEX (np. #3b82f6)
active boolean nie Czy aktywny (domyślnie true)
attachments_enabled boolean nie Czy załączniki włączone (domyślnie true)
locale string nie Język desku (pl, en, uk, de, fr, es, cs, sk)
mailbox_id integer nie ID skrzynki pocztowej
security_level string nie "signature" = wymagaj HMAC
ticket_pattern string nie Wzorzec numeracji zgłoszeń
help_content text nie Treść pomocy w widgecie
email_ticket_created_subject string nie Temat e-maila przy utworzeniu
email_ticket_created_body text nie Treść e-maila przy utworzeniu
email_comment_added_subject string nie Temat e-maila przy komentarzu
email_comment_added_body text nie Treść e-maila przy komentarzu
default_send_on_create boolean nie Domyślnie wysyłaj e-mail przy tworzeniu
default_send_on_comment boolean nie Domyślnie wysyłaj e-mail przy komentarzu

Przykład utworzenia

{
  "api_token": "TOKEN",
  "desk": {
    "name": "Support techniczny",
    "color": "#3b82f6",
    "locale": "pl",
    "mailbox_id": 5,
    "help_content": "Opisz swój problem jak najdokładniej."
  }
}

Odpowiedź

{
  "id": 1,
  "name": "Support techniczny",
  "token": "abc123...",
  "color": "#3b82f6",
  "active": true,
  "attachments_enabled": true,
  "tickets_count": 0,
  "open_tickets_count": 0,
  "unassigned_tickets_count": 0
}

Regeneracja klucza

Aby wygenerować nowy secret_key (dla podpisów HMAC widgetu):

{
  "api_token": "TOKEN",
  "desk": {
    "regenerate_secret_key": "1"
  }
}