[Intum](https://intum.pl/pomoc.md) / [CRM](https://intum.pl/pomoc/crm.md)

# [Notatki](https://intum.pl/pomoc/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.
<h3>Film - jak zapisać notatkę</h3>
<p><iframe src="https://s3.eu-west-1.amazonaws.com/attachments.intum.net/public-files/2/65980b96d5b8c59dccf8ea428b0ef5fa841018a8?v=https%3A%2F%2Fs3.eu-west-1.amazonaws.com%2Fattachments.intum.net%2Fpublic-files%2F2%2Fa3598ffe92cfe5434560237595d12c48b6381b8a&amp;poster=https%3A%2F%2Fs3.eu-west-1.amazonaws.com%2Fattachments.intum.net%2Fpublic-files%2F2%2F58dd49cee3805cff0c02c2f40a5a4e798cbf9396&amp;start=0" style="width:100%;max-width:720px;aspect-ratio:16/9;height:auto;display:block;margin:0 auto;border:0" loading="lazy" frameborder="0" allowfullscreen></iframe></p>

---

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