[Intum](https://intum.fr/aide.md) / [CRM](https://intum.fr/aide/crm.md)

# [Notatki](https://intum.fr/aide/crm/notatki.md) | [API](#api)

## Notatki CRM

Notatki pozwalają zapisywać informacje o kontaktach z [klientami](klienci), [kontaktami](kontakty) i [interesami](interesy). Służą jako historia komunikacji i ważnych ustaleń.

## Zastosowanie

- Zapis ustaleń z rozmów telefonicznych
- Notatki ze spotkań
- Ważne informacje o kliencie
- Historia negocjacji

## Właściwości notatki

- **Nazwa** — krótki tytuł (np. "Rozmowa telefoniczna", "Spotkanie")
- **Treść** — opis w formacie Markdown
- **Data** — kiedy nastąpił kontakt
- **Rodzaj** — typ notatki (np. telefon, spotkanie, e-mail)

## Powiązanie

Notatka jest zawsze przypisana do jednego obiektu:

- [Klienta](klienci)
- [Kontaktu](kontakty)
- [Interesu](interesy)

Z poziomu karty klienta/kontaktu/interesu widać listę wszystkich powiązanych notatek, posortowanych od najnowszej.

---

## 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 | `/crm/notes.json` | Lista notatek |
| GET | `/crm/notes/:id.json` | Pojedyncza notatka |
| POST | `/crm/notes.json` | Utworzenie notatki |
| PATCH | `/crm/notes/:id.json` | Aktualizacja notatki |
| DELETE | `/crm/notes/:id.json` | Usunięcie notatki |

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

## Pola note

| Pole | Typ | Wymagane | Opis |
|------|-----|----------|------|
| `name` | string | nie | Nazwa/tytuł notatki |
| `content` | text | nie | Treść (Markdown) |
| `kind` | string | nie | Typ notatki |
| `note_at` | datetime | nie | Data notatki |
| `noteable_id` | integer | tak | ID powiązanego obiektu |
| `noteable_type` | string | tak | Typ: `Crm::Client`, `Crm::Contact` lub `Crm::Deal` |

## Przykład utworzenia

```json
{
  "api_token": "TOKEN",
  "note": {
    "name": "Rozmowa telefoniczna",
    "content": "Klient zainteresowany ofertą Premium. Umówiony follow-up na przyszły tydzień.",
    "kind": "phone",
    "note_at": "2026-03-05T14:00:00",
    "noteable_id": 123,
    "noteable_type": "Crm::Client"
  }
}
```

## Notatka do interesu

```json
{
  "api_token": "TOKEN",
  "note": {
    "name": "Negocjacje",
    "content": "Klient akceptuje warunki. Czekamy na podpis umowy.",
    "noteable_id": 456,
    "noteable_type": "Crm::Deal"
  }
}
```