Jeśli dane o klientach żyją w Twoim systemie (ERP, sklepie, własnej aplikacji), nie musisz ich przepisywać do Intum ręcznie ani wgrywać plików. Aplikacja “CRM - import i synchronizacja klientów” daje stały kanał: Twój system wysyła dane, a Intum na bieżąco tworzy i aktualizuje klientów w CRM. Dzięki temu np. dział marketingu może wysyłać kampanie do grup klientów wybranych po aktualnych danych - planie, saldzie, statusie - bez czekania na ręczne importy.
Krok 1. Zainstaluj aplikację
Wejdź w Ustawienia konta - Aplikacje i dodatki, znajdź “CRM - import i synchronizacja klientów” i kliknij Zainstaluj. Po instalacji panel aplikacji znajdziesz pod adresem /a/crm-data-ingest (link pojawi się też w ustawieniach CRM).
Tak wygląda panel aplikacji:
Krok 2. Załóż pola własne
Zastanów się, jakie informacje o kliencie chcesz widzieć w CRM poza standardowymi (nazwa, NIP, adres, email). Może to być np. plan abonamentowy, saldo, data ostatniej płatności, status współpracy. Każdą taką informację załóż jako pole własne klienta w module Automatyzacja - Pola własne (panel aplikacji ma bezpośredni link).
To ważne: przy imporcie zapisywane są tylko wartości pól, które wcześniej zdefiniujesz. Nieznane pola są pomijane, a ich liczba widoczna w statystykach - łatwo więc wyłapiesz literówkę w nazwie pola.
Krok 3. Utwórz token dla swojego systemu
W panelu aplikacji kliknij “Utwórz token tylko do importu”. Powstanie klucz dostępu ograniczony wyłącznie do wysyłania danych - Twój system nie będzie mógł nim zrobić niczego innego w Intum, więc można go bezpiecznie przekazać np. zewnętrznej firmie utrzymującej Twój ERP. Token jest pokazywany tylko raz - skopiuj go od razu.
Krok 4. Skopiuj gotowy przykład i podłącz swój system
Panel aplikacji generuje gotowy do użycia przykład zapytania (curl) na podstawie Twoich pól własnych - z adresem, tokenem i przykładowymi wartościami. Przekaż go osobie technicznej odpowiedzialnej za Twój system. W przykładzie jest jedno miejsce do świadomej decyzji: nazwa źródła (source_code), np. “moj_erp” albo “sklep”. Ta nazwa wiąże identyfikatory klientów z Twojego systemu z klientami w CRM, więc raz wybranej nie zmieniaj.
Dane można wysyłać pojedynczo (przy każdej zmianie klienta) albo paczkami do 5000 rekordów - przy pierwszym zasileniu całej bazy używaj paczek.
Przykład: co wysyła Twój system
Poniżej przykładowe zapytanie dla konta “twojafirma” z dwoma polami własnymi: “plan” i “saldo” (najpierw załóż je w polach własnych klienta). Adres i token znajdziesz w panelu aplikacji.
POST https://twojafirma.intum.com/automation/import_batches.json
Authorization: Bearer TWOJ_TOKEN
Content-Type: application/json
{
"kind": "crm_clients",
"source_code": "moj_erp",
"batch_id": "2026-08-21-0001",
"clients": [
{
"external_id": "123",
"name": "Firma Przykładowa Sp. z o.o.",
"email": "[email protected]",
"tax_no": "5551112233",
"fields": {
"plan": "premium",
"saldo": 199.99
}
},
{
"external_id": "124",
"name": "Jan Kowalski",
"email": "[email protected]",
"fields": {
"plan": "podstawowy",
"saldo": 0
}
}
]
}
Pole “batch_id” to identyfikator paczki nadawany przez Twój system (np. numer kolejny albo data z licznikiem). Chroni przed podwójnym przetworzeniem: gdy po błędzie połączenia wyślesz tę samą paczkę ponownie, Intum rozpozna ją po batch_id i pominie duplikat - przy błędach zawsze bezpiecznie jest ponowić wysyłkę.
W odpowiedzi dostaniesz potwierdzenie przyjęcia (202) - dane pojawią się w CRM po chwili, gdy bufor zostanie przetworzony.
Co się dzieje po wysłaniu
Dane trafiają najpierw do bufora (dostajesz natychmiastowe potwierdzenie), a Intum przetwarza je w tle:
- klient, którego jeszcze nie ma w CRM, zostanie utworzony automatycznie
- jeśli klient już istnieje, ale nie był jeszcze powiązany z Twoim systemem, Intum spróbuje go dopasować - domyślnie po NIP-ie lub numerze rejestrowym (w ustawieniach można włączyć też dopasowanie po emailu i telefonie albo je wyłączyć)
- ponowne wysłanie tej samej paczki jest bezpieczne - duplikat zostanie rozpoznany i pominięty
W panelu aplikacji ustawisz też, czy import ma nadpisywać wypełnione pola, czy tylko uzupełniać puste.
Monitorowanie
Panel pokazuje listę źródeł z datą ostatniej wrzutki i liczbą paczek czekających w buforze, ostatnie paczki oraz statystyki przetwarzania: ilu klientów utworzono, zaktualizowano, powiązano, ile było błędów i jakie nieznane pola się pojawiły.
Co dalej: kampanie do grup klientów
Gdy dane płyną, pola własne klientów są dostępne w zaawansowanym filtrze CRM i w listach odbiorców Marketing Automation typu “filtr”. Możesz np. utworzyć listę “klienci z planem premium i saldem powyżej zera” - lista odświeża się automatycznie przed każdą wysyłką kampanii.