[Intum](https://intum.fr/aide.md) / [WebChat](https://intum.fr/aide/webchat.md)

# [Szablony czatu](https://intum.fr/aide/webchat/szablony-czatu.md) | [API](#api)

## Szablony odpowiedzi

Szablony to gotowe odpowiedzi, które operator może szybko wstawić w rozmowie czatowej. Przyspieszają obsługę klienta i zapewniają spójność komunikacji.

## Zastosowanie

- **Powitania** — standardowe przywitanie klienta
- **FAQ** — odpowiedzi na najczęściej zadawane pytania
- **Pożegnania** — zakończenie rozmowy
- **Instrukcje** — gotowe instrukcje dla typowych problemów

## Właściwości szablonu

- **Nazwa** — identyfikator szablonu (np. "Powitanie", "Instrukcja resetowania hasła")
- **Treść** — tekst wiadomości do wstawienia
- **Aktywny** — czy szablon jest dostępny do użycia
- **Widget** — opcjonalnie można przypisać szablon do konkretnego widgetu

## Jak korzystać

W panelu operatora podczas rozmowy operator może wybrać szablon z listy — treść zostanie wstawiona do pola wiadomości, gotowa do wysłania lub modyfikacji.

---

## API

### Ogólne API

# Intum API

Dokumentacja API platformy [Intum](https://intum.pl) - system operacyjny firmy.

## Host

Host jest zawsze taki sam jak adres konta: `xxxx.intum.com` lub `xxx.intum.pl` (w zależności od ustawień konta)

## Autoryzacja

Wszystkie requesty API wymagają `api_token`:
- header: `Authorization: Bearer TOKEN`

Token możesz wygenerować w **Ustawienia Konta** → **Tokeny API**

## Endpointy

| Metoda | Ścieżka | Opis |
|--------|---------|------|
| GET | `/webchat/templates.json` | Lista szablonów |
| GET | `/webchat/templates/:id.json` | Pojedynczy szablon |
| POST | `/webchat/templates.json` | Utworzenie szablonu |
| PATCH | `/webchat/templates/:id.json` | Aktualizacja szablonu |
| DELETE | `/webchat/templates/:id.json` | Usunięcie szablonu |

**Autoryzacja:** `Authorization: Bearer TOKEN` (uprawnienie: **webchat**)

## Pola template

| Pole | Typ | Wymagane | Opis |
|------|-----|----------|------|
| `name` | string | tak | Nazwa szablonu |
| `template` | text | nie | Treść szablonu |
| `active` | boolean | nie | Czy aktywny (domyślnie `true`) |
| `widget_id` | integer | nie | ID widgetu (opcjonalnie) |

## Przykład utworzenia

```json
{
  "api_token": "TOKEN",
  "template": {
    "name": "Powitanie",
    "template": "Dzień dobry! W czym mogę pomóc?",
    "active": true
  }
}
```

## Odpowiedź

```json
{
  "id": 1,
  "name": "Powitanie",
  "template": "Dzień dobry! W czym mogę pomóc?",
  "active": true,
  "widget_id": null
}
```