# Zo zet je je klanten van Excel over naar een crm zonder gegevens te verliezen of contacten te dupliceren

> Stap-voor-stapgids om je klantenbestand van Excel naar een crm te migreren: werkblad voorbereiden, csv in UTF-8 exporteren, kolommen koppelen, in batches importeren en dubbelen samenvoegen.

- **Bron (source):** https://aistohire.com/nl/aicrm-eenvoudige-crm-met-api-om-klanten-en-leads-te-beheren-109/blog/klanten-van-excel-naar-een-crm-zonder-dubbelen
- **Platform (platform):** AIstoHire
- **Taal (language):** nl
- **Bijgewerkt (updated):** 2026-11-20

## Kort samengevat

- Excel kan **1.048.576 rijen** aan (Microsoft Learn, «Excel-specificaties en -limieten», geraadpleegd op 25 oktober 2026), dus het probleem is nooit de omvang: een werkblad bewaart geen geschiedenis, waarschuwt niet voor dubbelen en weet niet wie wat heeft aangepast.
- De migratie loopt bijna altijd stuk op **vier dingen**: het scheidingsteken van de csv, de codering van de accenten, de telefoonnummers die Excel in getallen omzet en de kolom «status» die iedereen op zijn eigen manier heeft verzonnen.
- Normaliseer vóór het importeren: **één rij per persoon, één kopregel, telefoonnummers in één formaat (`+34…`) en de labels in één kolom** gescheiden door komma's.
- Importeer **in batches en met het foutenbestand bij de hand**: het is normaal dat tussen 2 % en 10 % van de rijen mislukt door een verkeerd geschreven e-mailadres of een lege naam, en die rijen los je op in de csv, niet met de hand in de crm.
- Migreren heeft geen zin als je over drie maanden terugkeert naar het werkblad. De enige manier om niet terug te gaan is dat **nieuwe contacten vanzelf binnenkomen** via de website, het formulier of de chat.

Dit artikel is een praktische migratiegids, geen brochure. We schrijven het vanuit **AiCrm**, de lichte crm met eigen api van **AIsToHire**, omdat het precies de weg is die iedereen aflegt die bij de app terechtkomt: een map met drie werkbladen, twee oude exports uit een andere tool en het gevoel dat er onderweg iets verloren gaat. Je kunt zien wat de app doet op de [landingspagina van AiCrm, de lichte crm met api van AIsToHire](/nl/aicrm-eenvoudige-crm-met-api-om-klanten-en-leads-te-beheren-109).

De stappen gelden voor elke crm die csv importeert. Wanneer iets afhangt van hoe AiCrm het specifiek doet —limieten, regels, foutmeldingen— zeggen we dat met het getal erbij, zodat je het zelf kunt controleren.

![Rommelige werkbladen die door een trechter gaan en één enkele klantkaart worden met gekleurde labels](https://cdn.aistohire.com/i/7452-ujnw-ycaa-orka-jrqv.webp)

---

## Wanneer is Excel niet meer geschikt als crm?

Excel is niet meer geschikt op de dag dat je moet weten **wat er is gebeurd** met een klant, niet alleen **wie het is**. Een werkblad bewaart de laatste staat van een gegeven goed (naam, telefoon, e-mail), maar bewaart niet het gesprek, niet wie er heeft gebeld en niet wanneer je weer moet schrijven: dat belandt in een kolom «Notities» die zo lang wordt dat hij onleesbaar is, of in iemands hoofd.

De technische limiet is bijna nooit de reden. Excel ondersteunt 1.048.576 rijen en 16.384 kolommen per werkblad (Microsoft Learn, geraadpleegd op 25 oktober 2026); geen enkele mkb-bedrijf komt daar in de buurt. Wat faalt is het **gegevensmodel**.

| Wat het werkblad goed doet | Wat pijn begint te doen |
|---|---|
| 500 rijen in één oogopslag bekijken en bewerken | Twee mensen die tegelijk bewerken: de laatste die opslaat wint |
| Totalen en percentages berekenen | Niemand weet of rij 318 dezelfde persoon is als rij 1.204 |
| Filteren en sorteren op kolom | Er is geen geschiedenis: je weet niet wanneer de status veranderde of wie hem veranderde |
| Een bestand per e-mail delen | Drie versies van hetzelfde bestand in omloop per e-mail |
| Alles in elke cel opslaan | «Status» met andere waarden in elke rij: *Actief*, *actief*, *OK*, *Ja* |
| Kopiëren en plakken van overal | Nieuwe contacten van de website komen nog steeds met de hand binnen, één voor één |

Het duidelijke teken dat het te krap is geworden, is niet het aantal rijen: het is dat iemand vraagt *«hebben we deze al gebeld?»* en het antwoord in de mail van iemand anders staat.

---

## Wat gaat er precies verloren bij een slecht uitgevoerde migratie?

Wat verloren gaat zijn niet de contacten: het is het deel van de gegevens dat de csv niet kan weergeven. De zes gebruikelijke ravages zijn de accenten, de telefoonnummers, de stille dubbelen, de statuskolom, de lege rijen en de labels die in één cel zijn geplakt. Ze worden allemaal opgelost **voordat** je het bestand uploadt.

| Symptoom na afloop | Echte oorzaak | Hoe je het voorkomt |
|---|---|---|
| `Jos� Mart�nez` op alle kaarten | De csv is opgeslagen in ANSI/Windows-1252, niet in UTF-8 | Opslaan als «CSV UTF-8 (door komma's gescheiden)» |
| Het hele bestand in één kolom | De csv gebruikt `;` en de importfunctie verwachtte `,` (of andersom) | Een importfunctie gebruiken die het scheidingsteken detecteert |
| `34600112233` waar `+34 600 11 22 33` stond | Excel behandelt de cel als getal en eet de `+` en de spaties op | De kolom als **Tekst** opmaken voordat je schrijft |
| 1.180 contacten waar er 1.050 waren | Dezelfde klant stond in twee werkbladen, in één met het e-mailadres in hoofdletters | E-mailadressen normaliseren naar kleine letters en dubbelen nakijken |
| Iedereen als «lead» | De kolom «Status» had waarden die de crm niet herkent | De waarden vertalen naar die van de crm vóór het importeren |
| Eén gigantisch label per contact | De labels stonden in verschillende kolommen (`Tag1`, `Tag2`, `Tag3`) | Ze samenvoegen in één kolom gescheiden door komma's |

Het telefoongeval is het verraderlijkst omdat het **geen foutmelding geeft**: het gegeven komt binnen, ziet er goed uit en je merkt het pas de dag dat de dubbelendetector twee kaarten met hetzelfde nummer niet herkent. Excel interpreteert een cel die met `+` begint als het begin van een formule, dus `+34600112233` wordt het getal `34600112233`; en nullen vooraan verdwijnen (`0600…` → `600…`). Bovendien vult Excel vanaf **15 significante cijfers** de rest met nullen (Microsoft, «Last digits are changed to zeros when you type long numbers in cells», geraadpleegd op 25 oktober 2026), wat iban-nummers en lange codes verwoest als je ze in hetzelfde werkblad hebt.

---

## Stap 1: hoe bereid ik de Excel voor vóór het exporteren?

Besteed een kwartier om het werkblad in een vorm te brengen die een importfunctie begrijpt: **één rij per persoon, één enkele kopregel op de eerste regel en één kolom per gegeven**. Bijna alle importfouten worden hier beslist, niet in de crm.

De concrete checklist:

1. **Verwijder de versieringsrijen.** Documenttitel, logo, lege rijen tussen blokken, totalen onderaan. De eerste rij van het bestand moet de kopregel zijn: veel importfuncties —waaronder AiCrm— nemen rij 1 als kolomnamen zonder het te vragen.
2. **Maak samengevoegde cellen ongedaan.** Een samengevoegde cel wordt geëxporteerd als één cel met waarde en één lege: een deel van je gegevens gaat naar de verkeerde rij.
3. **Eén kolom per gegeven.** Als je «Voor- en achternaam» in één cel hebt, is dat prima: de meeste crm's bewaren één enkel naamveld. Wat niet kan, is «Contact» met *María (mobiel 600…)* erin.
4. **Normaliseer de telefoonnummers naar één formaat.** Kies `+34600112233` of `0034600112233`, maar meng ze niet: AiCrm vergelijkt telefoonnummers **alleen op hun cijfers** en verwijdert de `+` vooraan, dus `+34600112233` en `0034600112233` zijn **niet** hetzelfde nummer voor de dubbelendetector (`34600112233` tegenover `0034600112233`). Maak de kolom op als Tekst voordat je eraan komt.
5. **Zet e-mailadressen om naar kleine letters.** Formule `=KLEINE.LETTERS(B2)`, kopiëren, plakken speciaal als waarden. Een `Laura@Voorbeeld.com` en een `laura@voorbeeld.com` zijn dubbelen die geen enkele importfunctie vindt als hij letterlijk vergelijkt.
6. **Voeg de labels samen in één kolom.** Als je `Tag1`, `Tag2` en `Tag3` had, voeg ze dan samen met komma's: `=TEKST.COMBINEREN(",";WAAR;E2:G2)`. AiCrm accepteert in de labelkolom de scheidingstekens `,`, `;` en `|`, en normaliseert elk label naar kleine letters, zonder dubbele spaties en met een maximum van 40 tekens.
7. **Bepaal de statuskolom.** Hieronder staat de equivalentietabel; elke waarde die de crm niet herkent, wordt stilzwijgend «lead».
8. **Verwijder de voor de hand liggende dubbelen in het werkblad zelf.** *Gegevens → Duplicaten verwijderen*, op de e-mailkolom. Het is gratis en bespaart je later het samenvoegen van kaarten.

Zo zou het bestand eruit moeten zien vóór het exporteren:

```
nombre,email,telefono,empresa,pais,estado,etiquetas,notas
Laura Méndez,laura@ejemplo.com,+34600112233,Ejemplo SL,ES,active,"klant,terugkerend",Betaalt binnen 30 dagen
Carlos Ruiz,carlos@otraempresa.com,+34611223344,Otra Empresa,ES,lead,"web,offerte",Vroeg in september een offerte aan
Sofía Torres,sofia@tienda.com,,Tienda Online,ES,active,"winkel",
```

Let op twee details: de labels staan **tussen aanhalingstekens** omdat ze komma's bevatten, en de rij van Sofía heeft een leeg telefoonnummer. Beide zijn correct en een degelijke csv-parser kan ze aan.

---

## Stap 2: hoe exporteer ik de csv zonder accenten of scheidingstekens te breken?

Gebruik in Excel **Bestand → Opslaan als → «CSV UTF-8 (door komma's gescheiden) (*.csv)»**, beschikbaar sinds Excel 2016. De oude optie «CSV (door komma's gescheiden)» slaat op in de lokale codering van het systeem en is verantwoordelijk voor 90 % van de `Jos�`.

Er is een tweede detail dat veel mensen verrast: in een Windows met Nederlandse of Belgische regio-instelling is het lijstscheidingsteken de puntkomma, dus een bestand «door komma's gescheiden» komt in werkelijkheid **gescheiden door `;`** eruit. Het is geen fout van jou en ook niet van de crm.

| Herkomst | Wat te exporteren | Scheidingsteken dat meestal verschijnt | Codering |
|---|---|---|---|
| Excel (Windows, Nederlands) | CSV UTF-8 (door komma's gescheiden) | `;` | UTF-8 met BOM |
| Excel (macOS) | CSV UTF-8 | `,` | UTF-8 |
| Google Sheets | Bestand → Downloaden → Door komma's gescheiden waarden (.csv) | `,` | UTF-8 |
| LibreOffice Calc | CSV, met «Filterinstellingen bewerken» aangevinkt | het scheidingsteken dat je kiest | de codering die je kiest (kies UTF-8) |
| Export uit een andere crm | Standaard-csv | `,` | meestal UTF-8 |

Wat AiCrm doet bij het ontvangen van het bestand, zodat je niet hoeft te raden:

- **Detecteert het scheidingsteken zelf**: kijkt naar de eerste regel en kiest de meest voorkomende kandidaat uit komma, puntkomma en tab.
- **Verwijdert de BOM** (dat onzichtbare teken dat Excel aan het begin van het UTF-8-bestand zet en dat, als het niet wordt verwijderd, de eerste kopregel onuitspreekbaar maakt).
- **Leest in UTF-8 en probeert, als het vervangingsteken `�` wordt gedetecteerd, het hele bestand opnieuw in latin1.** Het is het vangnet voor csv-bestanden die in ANSI zijn opgeslagen; exporteer toch in UTF-8: het vangnet raadt niet, het slaagt alleen in het gewone geval.
- **Respecteert dubbele aanhalingstekens**, inclusief regeleinden binnen een veld en ge-escapete aanhalingstekens (`""`), wat je lange notities redt.
- **Verwerpt volledig lege rijen** voordat er iets wordt geteld.

---

## Stap 3: hoe koppel ik de kolommen van mijn werkblad aan de velden van de crm?

Koppelen is de crm vertellen welke kolom van je bestand de naam is, welke het e-mailadres en welke genegeerd moet worden. In AiCrm wordt de koppeling vanzelf voorgesteld op basis van de kopregel en, als de kopregel niets zegt, door naar de inhoud van de eerste gegevensrij te kijken; jij corrigeert het voordat je begint.

![Koppelschema: de csv-kolommen links met lijnen verbonden met de velden van de klantkaart rechts, met twee niet-toegewezen kolommen](https://cdn.aistohire.com/i/9219-agpt-iivs-hjsh-fibl.webp)

Dit zijn de **acht velden** waaraan een kolom kan worden gekoppeld, en wat elk accepteert:

| Veld | Kopregels die het zelf herkent | Wat het accepteert | Als het ontbreekt |
|---|---|---|---|
| `name` | nombre, name, contacto | Vrije tekst | Het deel van het e-mailadres vóór de `@` wordt gebruikt |
| `email` | mail, correo | Formaat `iets@iets.domein` | Mag leeg zijn (maar je verliest de dubbelendetectie) |
| `phone` | tel, phone, movil, móvil, celular | Tekst; wordt alleen op cijfers vergeleken | Mag leeg zijn |
| `company` | empresa, compan…, organiz…, firma | Vrije tekst | Leeg |
| `country` | pais, país, country | Tekst; wordt in hoofdletters opgeslagen (gebruik ISO-2: `ES`, `MX`, `AR`) | Leeg |
| `status` | estado, status | `lead`, `active`, `inactive`, `churned` | `lead` |
| `tags` | tag, etiqueta | Gescheiden door komma, puntkomma of verticale streep | Geen labels |
| `notes` | nota, note, coment… | Vrije tekst, accepteert regeleinden | Leeg |

Komt een kopregel met geen van die patronen overeen, dan kijkt AiCrm naar de eerste gegevensrij: bevat de waarde een `@`, dan stelt hij het voor als e-mailadres; lijkt hij op een telefoonnummer (`+` of een cijfer gevolgd door minstens zes tekens uit cijfers, spaties, punten, streepjes of haakjes), dan stelt hij het voor als telefoon. Wat nergens past, blijft **niet gekoppeld**, en een niet-gekoppelde kolom wordt gewoon niet geïmporteerd: het is de juiste manier om de kolom «Toegewezen verkoper» of «Bedrag 2024» weg te laten die je crm niet heeft.

**Harde regel:** je moet minstens **naam of e-mailadres** koppelen. Als je geen van beide koppelt, start de import niet eens.

De equivalentietabel voor statussen, zodat je ze in je werkblad vertaalt voordat je het uploadt:

| Wat je Excel meestal invult | Waarde die je moet schrijven |
|---|---|
| Nieuw, In afwachting, Contact, Prospect, Geïnteresseerd | `lead` |
| Klant, Actief, OK, Ja, Lopend | `active` |
| Slapend, Oud, Geen activiteit, Koud | `inactive` |
| Opgezegd, Verloren, Geannuleerd, Niet geïnteresseerd | `churned` |

Elke andere waarde —ook `Active` met hoofdletter als je crm `active` verwacht— valt **zonder waarschuwing** terug op `lead`. Het is de meest voorkomende stille fout van de hele migratie: het bestand komt «goed» binnen en de volgende dag heb je 900 leads en geen enkele klant.

---

## Stap 4: hoe importeer ik en wat doe ik met de rijen die mislukken?

Importeer altijd **met het foutenbestand bij de hand** en in twee rondes: eerst een test van 20 rijen, je controleert het resultaat in de crm, en daarna het volledige bestand. De test van 20 rijen kost twee minuten en vindt 100 % van de koppelfouten.

Hoe het van binnen werkt in AiCrm, met de echte cijfers:

| Parameter | Waarde |
|---|---|
| Maximum aantal rijen per bestand | **10.000** (heb je er meer, splits de csv) |
| Rijen verwerkt per batch | **100** |
| Hervatbaar | Ja: de taak bewaart de cursor in de database |
| Opgeslagen fouten per import | Tot **500**, te downloaden als csv |
| Automatisch toegevoegd label | `importacion-AAAA-MM-DD` (de datum van de dag) |
| Extra labels | Die jij toevoegt bij het starten van de import, aan alle rijen |
| Moet het tabblad open blijven? | **Ja.** De verwerking wordt batch voor batch door de browser aangestuurd; sluit je hem, dan blijft de taak half af en hervat je hem vanuit de geschiedenis |

De rijen die mislukken blokkeren de import niet: ze worden apart gezet, geteld en teruggegeven met het **echte regelnummer van het bestand**, zodat je ze in je Excel corrigeert en alleen die opnieuw uploadt. De drie redenen voor afwijzing:

| Reden | Wanneer het gebeurt | Hoe je het oplost |
|---|---|---|
| **Lege naam** | De rij heeft geen naam en geen e-mailadres om hem uit af te leiden | Vul de naam in de csv in |
| **Ongeldig e-mailadres** | Voldoet niet aan `iets@iets.domein` | Corrigeer het e-mailadres of laat het leeg |
| **Dubbel (e-mailadres bestaat al)** | Dat e-mailadres staat al in je crm en je hebt «bestaande bijwerken» **niet** aangevinkt | Beslis: de rij negeren of opnieuw importeren met de optie geactiveerd |

Die derde optie, **«bestaande bijwerken»**, is wat een tweede import veilig maakt. Met het vakje aangevinkt maakt AiCrm, als het e-mailadres al bestaat, **geen nieuwe kaart aan**: hij werkt de bestaande bij, en doet dat behoudend —hij vult alleen de velden die leeg waren en **voegt** de nieuwe labels toe aan wat er al was, zonder er een te verwijderen—. Met het vakje uitgevinkt wordt de rij geweigerd en vind je hem terug in de foutencsv.

Een belangrijk detail voordat je begint: **er is geen knop «import ongedaan maken»**. De import uit de geschiedenis verwijderen verwijdert de registratie van de taak, niet de contacten die hij heeft aangemaakt. Wat je wel hebt, is het label `importacion-AAAA-MM-DD` op alle kaarten van die batch, waarmee je ze kunt filteren en nakijken; maar verwijderen in AiCrm gaat contact voor contact, er is geen bulkverwijdering. Daarom is de test van 20 rijen niet optioneel.

---

## Wat doe ik met de dubbelen die het werkblad al bevatte?

Dubbelen los je niet op bij de import: je lost ze daarna op, één voor één, door te beslissen welk gegeven van elke kaart je houdt. Wat de crm wel kan doen is ze **voor je vinden** en je ze laten samenvoegen zonder de geschiedenis van beide te verliezen.

![Twee bijna identieke klantkaarten die over elkaar heen vallen en samensmelten tot één, met de labels van beide samengevoegd in één regel](https://cdn.aistohire.com/i/3141-mbob-onib-nfrf-cgdo.webp)

AiCrm detecteert ze met drie regels, in deze volgorde:

1. **Exact e-mailadres** (vergeleken in kleine letters). Het is de sterke regel: bij een match is er zeker een dubbel.
2. **Exact telefoonnummer**, alleen als de kaart geen e-mailadres heeft. Vergelijkt uitsluitend de cijfers, negeert spaties, streepjes, punten en haakjes, en verwijdert de `+` vooraan.
3. **Gelijkende naam**, met een gelijkenis **groter dan of gelijk aan 0,8**. De formule is `1 − (Levenshtein-afstand ÷ lengte van de langste naam)`, alles in kleine letters.

Die derde regel verdient twee concrete voorbeelden, omdat ze tegelijk uitlegt wat ze vangt en wat niet:

- `jose luis ramirez` tegenover `josé luís ramírez`: drie vervangingen (drie accenten) op 17 tekens → `1 − 3/17 = 0,82`. **Haalt 0,8: wordt gedetecteerd.**
- `marta gomez` tegenover `marta gomez ruiz`: er moeten vijf tekens worden ingevoegd op 16 → `1 − 5/16 = 0,69`. **Haalt 0,8 niet: wordt niet gedetecteerd.**

Praktische conclusie: de automatische detectie vangt tikfouten en accenten, maar **niet** dezelfde persoon die één keer met de voornaam en een andere keer met de voornaam en beide achternamen is geregistreerd. Voor die gevallen is de zoekfunctie op naam, e-mailadres, telefoon of bedrijf je gereedschap.

De detectie draait ook **terwijl je typt** bij een nieuw contact: een halve seconde nadat je het e-mailadres of de naam hebt ingetypt, waarschuwt het formulier als er al iemand soortgelijks bestaat, met een link om de bestaande kaart te bekijken en de optie om het contact toch aan te maken.

### Wat gebeurt er precies bij het samenvoegen van twee kaarten

Het samenvoegen in AiCrm gaat veld voor veld: je kiest voor elk gegeven of je dat van de hoofdkaart houdt of dat van de tweede kaart.

| Gegeven | Hoe het wordt opgelost |
|---|---|
| Naam, e-mailadres, telefoon, bedrijf, land, status, notities | Jij kiest, veld voor veld |
| Labels | **Samenvoeging** van beide: er gaat er geen verloren |
| Aanmaakdatum | De **oudste** van de twee blijft |
| Laatste activiteit | De **meest recente** blijft |
| Tijdlijn van activiteiten | Alle activiteiten van de tweede kaart worden **toegewezen** aan de hoofdkaart |
| Herinneringen | Idem: worden toegewezen aan de hoofdkaart |
| Tweede kaart | Wordt verwijderd, en in de tijdlijn blijft een samenvoegingsregel staan met de naam en het e-mailadres van de opgenomen kaart |

Dat wil zeggen: na het samenvoegen kun je nog steeds reconstrueren wat er is gebeurd, omdat de samenvoeging zelf in de geschiedenis wordt genoteerd.

---

## Hoe voorkom ik dat ik over zes maanden terugga naar het werkblad?

Bijna iedereen die migreert gaat om dezelfde reden terug naar het werkblad: **nieuwe contacten komen nog steeds met de hand binnen**. Zolang het formulier van de website per e-mail bij je aankomt en iemand moet kopiëren en plakken, verschijnt het parallelle werkblad weer. De oplossing is geen discipline, maar de handmatige stap wegnemen.

![Integratieschema: webformulier, chat en winkel sturen de contacten naar de database van de crm, die op haar beurt twee externe servers waarschuwt via webhooks](https://cdn.aistohire.com/i/8613-clnb-vmia-rhuh-tylu.webp)

AiCrm heeft daarvoor een **openbare rest-api**. Je maakt een sleutel aan in de app, stuurt hem mee in de header `X-Api-Key` en je website maakt het contact op het moment zelf aan:

```
curl -X POST https://aistohire.com/api/apps/public/crm/customers \
  -H "X-Api-Key: JOUW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"laura@ejemplo.com","name":"Laura Méndez","phone":"+34600112233","company":"Ejemplo SL","tags":["web","presupuesto"],"subId":"formulario-contacto"}'
```

Wat je over dat endpoint moet weten:

| Gedrag | Detail |
|---|---|
| Nieuw contact | Antwoordt met **201** met `action: "created"` en de id van het contact |
| E-mailadres (of telefoon) bestaat al | Antwoordt met **200** met `action: "existing"`: **maakt geen dubbel**; vult de lege velden, voegt de nieuwe labels toe en noteert een nieuwe inzending in de tijdlijn |
| Verplicht minimum | E-mailadres **of** telefoon. Stuur je geen naam mee, dan wordt het deel van het e-mailadres vóór de `@` gebruikt |
| Automatisch label | `api-lead`, naast die je zelf meestuurt |
| Herkomstgegevens | Bewaart het **IP-adres** en het **land** van het verzoek |
| `subId` | Vrije tekst om te weten van welk formulier of welke campagne het kwam; verschijnt in de tijdlijn van het contact |
| Gebruikslimiet | **100 verzoeken per minuut en per sleutel**; bij overschrijding geeft hij `429` terug |

En andersom: als er iets verandert in de crm, waarschuwen de **webhooks** je systemen. Beschikbare events: `customer.created`, `customer.updated`, `customer.deleted` en `activity.created`. Elke levering bevat de header `X-AiCrm-Event` met de naam van het event en `X-AiCrm-Signature` met een HMAC-SHA256 van de body, berekend met het geheim van de webhook, zodat je kunt controleren dat de aanroep van ons komt en niet van een derde.

Eerlijk over de webhooks, want het is belangrijk voor het ontwerp van je integratie: het verzenden is *best effort*, met **één enkele directe herpoging na 1,5 seconde** en een **timeout van 5 seconden**. Er is **geen persistente wachtrij voor herpogingen**: als je server twee minuten uit de lucht is, gaat dat event verloren. Heb je een leveringsgarantie nodig, gebruik de webhook dan als melding en de api `GET /crm/customers` als bron van waarheid om af te stemmen.

De rest van de api, voor als je integratie meer nodig heeft dan aanmaken:

| Methode | Pad | Waarvoor |
|---|---|---|
| `POST` | `/api/apps/public/crm/customers` | Aanmaken (of het bestaande teruggeven) |
| `GET` | `/api/apps/public/crm/customers` | Lijst met `page`, `perPage`, `search`, `status`, `tags`, `country` |
| `GET` | `/api/apps/public/crm/customers/:id` | Kaart met haar activiteit |
| `PUT` | `/api/apps/public/crm/customers/:id` | Bijwerken |
| `DELETE` | `/api/apps/public/crm/customers/:id` | Verwijderen |
| `POST` | `/api/apps/public/crm/customers/:id/activities` | Een activiteit aan de tijdlijn toevoegen |

---

## Wat doet AiCrm NIET? De limieten, op papier

Een migratieartikel dat je de limieten van de tool niet vertelt, laat je twee keer tijd verliezen: bij het migreren en bij het opnieuw migreren. Dit zijn die van AiCrm, zoals ze zijn.

| Limiet | Waarde / gedrag |
|---|---|
| Contacten die worden doorlopen bij filteren of exporteren | **5.000 per aanmaak**. Boven dat aantal is dit niet de juiste tool |
| Rijen per import | **10.000** per bestand |
| Contacten in de pdf van de lijst | **500** |
| Pushmeldingen van herinneringen | **Er zijn er geen.** Herinneringen zie je in «Vandaag openstaand» en in het gedeelte Herinneringen, met markering voor verlopen, voltooien en uitstellen |
| Verzenden van e-mails of berichten aan klanten | **Nee.** AiCrm organiseert en registreert; het schrijft niemand namens jou |
| Bulkverwijdering van contacten | **Er is geen.** Je verwijdert kaart voor kaart |
| Import met gesloten tabblad | **Nee.** Hij is hervatbaar vanuit de geschiedenis, maar gaat niet vanzelf verder |
| Herpogingen van webhooks | Eén directe, in het geheugen. Geen persistente wachtrij |
| Opgeslagen weergaven en `@`-vermeldingen in notities | In behandeling: er is nog geen interface |
| Kunstmatige intelligentie | **De app gebruikt geen enkele AI-motor.** Statistieken, trends, dubbelendetectie en rapporten zijn deterministische berekeningen op de server |

Die laatste rij is bewust: er is geen magische leadscore of gegenereerde samenvatting. De dubbelendetectie is een formule die je zelf met de hand kunt berekenen, en daarom hebben we je die hierboven laten zien.

Wat het wel doet, kort samengevat: kaarten met labels, statussen en tijdlijn; zoeken op naam, e-mailadres, telefoon of bedrijf; filters op status, labels, land en datums; herinneringen met datum en tijd; detectie en samenvoeging van dubbelen; csv-import en -export; rapporten in pdf of csv; api-sleutels, webhooks en een dashboard met totalen per status, nieuwe contacten van de laatste 30 dagen met hun verandering, landen en browsers van herkomst en trendgrafieken over 7, 30, 90 dagen en een jaar.

---

## En de gegevensbescherming bij het verplaatsen van een klantenbestand?

Contacten van een werkblad naar een crm verplaatsen verandert je verplichtingen niet, maar wel hoe makkelijk het is om eraan te voldoen. Verordening (EU) 2016/679 (AVG) eist in artikel 5.1.d dat persoonsgegevens «juist zijn en zo nodig worden geactualiseerd», en dat onjuiste gegevens onverwijld worden gewist of gerectificeerd: drie verschillende kaarten van dezelfde persoon met verschillende telefoonnummers zijn letterlijk onjuiste gegevens.

Een migratie is ook het natuurlijke moment voor de opruiming die je al uitstelt: de contacten die geen grondslag meer hebben om daar te staan, migreer je niet.

Wat AiCrm op dit terrein biedt, zonder overdrijven: elk contact is een unieke, verwijderbare kaart, de geschiedenis legt vast wanneer en via welke weg het is aangemaakt, en je kunt **de gegevens van één persoon of van het hele bestand naar csv exporteren** wanneer je wilt, met de velden die je kiest —nuttig om te antwoorden op een verzoek om inzage of overdraagbaarheid (art. 15 en 20 AVG)—.

> **Waar de grens ligt:** AiCrm is een database van contacten, geen tool voor naleving van regelgeving. Het beheert geen toestemmingen, houdt het register van verwerkingsactiviteiten van artikel 30 niet bij en beoordeelt je rechtsgrond niet. Dit artikel is informatief en **geen juridisch advies**: raadpleeg voor jouw concrete geval een professional of je functionaris voor gegevensbescherming.

---

## Migratiechecklist, van begin tot eind

Print hem uit of kopieer hem. Bij een bestand van 1.000-2.000 contacten past het hele proces in een ochtend.

1. Verzamel **alle** bronnen: de werkbladen, de oude exports, het adresboek van je telefoon, de e-mails van het formulier.
2. Plak alles in één werkblad met dezelfde kopregel en voeg een kolom «herkomst» toe (die gebruik je als label).
3. Ruim op: versieringsrijen weg, samengevoegde cellen ongedaan, e-mailadressen in kleine letters, telefoonnummers in één formaat.
4. Vertaal de statuskolom naar `lead` / `active` / `inactive` / `churned`.
5. Voeg de labels samen in één kolom gescheiden door komma's.
6. *Gegevens → Duplicaten verwijderen* op e-mailadres.
7. Sla op als **CSV UTF-8**.
8. Knip een testbestand van **20 rijen** af en upload het.
9. Bekijk de voorgestelde koppeling, corrigeer wat nodig is en start de test.
10. Controleer in de crm: accenten, telefoonnummers, statussen en labels van die 20 kaarten.
11. Upload het volledige bestand (maximaal 10.000 rijen per ronde) en **laat het tabblad open** tot het einde.
12. Download de foutencsv, corrigeer die rijen in je Excel en upload alleen die opnieuw, dit keer met «bestaande bijwerken» aangevinkt.
13. Controleer dubbelen bij de kaarten die je bekend voorkomen en voeg ze samen.
14. Plan de herinneringen voor de vijf contacten die je deze week moet bellen. Doe je dit niet, dan blijft de crm een dood archief.
15. Koppel het formulier van je website aan de api zodat nieuwe contacten niet meer via een werkblad lopen.

---

## Veelgestelde vragen

### Hoeveel contacten kan ik in één keer importeren?

Tot **10.000 rijen per bestand** in AiCrm, verwerkt in batches van 100. Is je bestand groter, splits de csv dan in meerdere bestanden en upload ze na elkaar. Houd rekening met de andere limiet, die echt bepalend is: filters en export doorlopen maximaal **5.000 contacten per aanmaak**, dus als je tienduizenden records beheert, heb je een tool uit een andere categorie nodig.

### Waarom komt mijn csv met kapotte accenten eruit?

Omdat hij is opgeslagen in de lokale codering van het systeem (ANSI / Windows-1252) in plaats van in UTF-8. Ga terug naar Excel en gebruik **Opslaan als → «CSV UTF-8 (door komma's gescheiden)»**, beschikbaar sinds Excel 2016. AiCrm probeert het bestand opnieuw in latin1 als hij het teken `�` detecteert, maar dat is een vangnet, geen garantie: exporteer meteen goed en je bespaart jezelf de schrik.

### Krijg ik dubbele contacten als ik hetzelfde bestand twee keer importeer?

Nee, als je de optie goed gebruikt. Met **«bestaande bijwerken»** aangevinkt werken de rijen waarvan het e-mailadres al in de crm staat de bestaande kaart bij in plaats van een andere aan te maken: ze vullen de velden die leeg waren en voegen de nieuwe labels toe zonder de oude te verwijderen. Vink je die optie niet aan, dan worden die rijen geweigerd en verschijnen ze in de foutencsv als «Dubbel (e-mailadres bestaat al)». Let op: de bescherming werkt **op e-mailadres**; een rij zonder e-mailadres kan wel een nieuwe kaart aanmaken.

### Kan ik een import ongedaan maken als ik een fout heb gemaakt?

Er is geen knop om ongedaan te maken. De import uit de geschiedenis verwijderen verwijdert de registratie van de taak, niet de contacten die hij heeft aangemaakt, en in AiCrm gaat het verwijderen van contacten kaart voor kaart, zonder bulkverwijdering. Wat je wel hebt, is het automatische label `importacion-AAAA-MM-DD` op alle kaarten van die batch, waarmee je ze snel kunt filteren en nakijken. Daarom is het verstandig altijd eerst een test met 20 rijen te doen vóór het volledige bestand.

### Wat gebeurt er met de kolom «Status» van mijn Excel?

Er worden maar vier waarden herkend: `lead`, `active`, `inactive` en `churned`. Al het andere —«Klant», «Actief» met hoofdletter, «OK», «In afwachting»— wordt `lead` **zonder enige waarschuwing**. Vertaal die kolom in je werkblad vóór het exporteren, anders staat je hele bestand als lead gemarkeerd.

### Kan ik importeren vanuit Google Sheets of vanuit de export van een andere crm?

Ja: elke csv is goed. In Google Sheets: **Bestand → Downloaden → Door komma's gescheiden waarden (.csv)**, die al in UTF-8 en door komma's gescheiden uitkomt. Kom je van een andere crm, exporteer dan naar csv en koppel de kolommen aan de acht velden van AiCrm; kolommen zonder equivalent laat je niet gekoppeld en worden gewoon niet geïmporteerd. Wat in geen geval via csv wordt gemigreerd, is de gespreksgeschiedenis van het andere systeem: de tijdlijn begint bij nul, met de aanmaak door import als eerste regel.

### Moet ik kunnen programmeren om AiCrm te gebruiken?

Nee. Al het beheer —kaarten aanmaken, labelen, zoeken, filteren, importeren, exporteren, dubbelen samenvoegen en herinneringen plannen— gebeurt vanuit de app zonder een regel code aan te raken. De api en de webhooks zijn optioneel en zijn er voor als je wilt dat je website, je formulier of je chatbot de contacten zelf aanmaken.

### En als ik morgen naar een andere tool wil?

Je exporteert. AiCrm genereert een csv met de velden die je kiest uit dertien beschikbare (id, naam, e-mailadres, telefoon, bedrijf, land, status, labels, aanmaakdatum, laatste activiteit, notities, IP en browser), over het hele bestand of alleen over wat je op dat moment hebt gefilterd. Je kunt ook samenvattingsrapporten, contactrapporten of activiteitsrapporten in pdf of csv halen. Je gegevens komen eruit in hetzelfde formaat waarin ze erin gingen.

---

## In één zin

**AiCrm is de lichte crm van AIsToHire die je contacten verzamelt in kaarten met labels, statussen, notities, herinneringen en tijdlijn, ze importeert en exporteert in csv, dubbelen detecteert en samenvoegt, en je website zelf klanten laat aanmaken via zijn rest-api met webhooks; je vindt hem op [AiCrm — Lichte crm met api om klanten aan te maken vanuit elk systeem](/nl/aicrm-eenvoudige-crm-met-api-om-klanten-en-leads-te-beheren-109)** Hij gebruikt geen kunstmatige intelligentie, schrijft je klanten niet namens jou aan en is bedoeld voor bestanden tot enkele duizenden contacten: als dat jouw geval beschrijft, past de migratie die je net hebt gelezen in een ochtend.

> Probeer AiCrm gratis en importeer je csv

- [AiCrm — Lichte CRM met API om klanten vanuit elk systeem aan te maken](https://aistohire.com/nl/aicrm-eenvoudige-crm-met-api-om-klanten-en-leads-te-beheren-109)

## Over het platform

**AiCrm — Lichte CRM met API om klanten vanuit elk systeem aan te maken** — app van AIstoHire. Beschikbaar in: https://aistohire.com/nl/aicrm-eenvoudige-crm-met-api-om-klanten-en-leads-te-beheren-109/blog/klanten-van-excel-naar-een-crm-zonder-dubbelen

### Andere talen

- `es`: https://aistohire.com/es/aicrm-crm-ligero-con-api-109/blog/pasar-clientes-de-excel-a-un-crm-sin-duplicados
- `en`: https://aistohire.com/aicrm-lightweight-crm-with-api-109/blog/transfer-clients-from-excel-to-a-crm-without-duplicates
- `fr`: https://aistohire.com/fr/aicrm-crm-leger-avec-api-109/blog/transferer-clients-excel-vers-crm-sans-doublons
- `it`: https://aistohire.com/it/aicrm-crm-leggero-con-api-109/blog/trasferire-clienti-da-excel-a-un-crm-senza-duplicati
- `pt`: https://aistohire.com/pt/aicrm-crm-leve-com-api-109/blog/transferir-clientes-do-excel-para-um-crm-sem-duplicados
- `de`: https://aistohire.com/de/aicrm-leichtes-crm-mit-api-109/blog/kunden-von-excel-zu-einem-crm-ubertragen-ohne-duplikate
- `bg`: https://aistohire.com/bg/aicrm-lesen-crm-s-api-za-upravlenie-na-klienti-i-liydove-109/blog/prehvarlyane-na-klienti-ot-excel-v-crm-bez-dubliki
- `ja`: https://aistohire.com/ja/aicrm-lightweight-crm-with-api-109/blog/excel-kokyaku-crm-iko-juufuku-nashi
- `ko`: https://aistohire.com/ko/aicrm-api-gyeongnyang-crm-109/blog/eksel-gogaek-crm-ijeon-jungbok-eopsi
- `sv`: https://aistohire.com/sv/aicrm-enkelt-crm-med-api-for-att-hantera-kunder-och-leads-109/blog/flytta-kunder-fran-excel-till-crm-utan-dubbletter
- `da`: https://aistohire.com/da/aicrm-enkelt-crm-med-api-til-at-styre-kunder-og-leads-109/blog/flyt-kunder-fra-excel-til-crm-uden-dubletter
- `ar`: https://aistohire.com/ar/aicrm-nzam-crm-bsit-ma-api-lidara-alamla-walamla-almhtmlin-109/blog/excel-to-crm-migration-no-duplicates
- `no`: https://aistohire.com/no/aicrm-enkelt-crm-med-api-for-a-styre-kunder-og-leads-109/blog/flytte-kunder-fra-excel-til-crm-uten-duplikater
- `fi`: https://aistohire.com/fi/aicrm-yksinkertainen-crm-rajapinnalla-asiakkaille-ja-liideille-109/blog/asiakkaiden-siirto-excelista-crm-ilman-kaksoiskappaleita
- `zh`: https://aistohire.com/zh/ai-crm-rest-api-webhooks-109/blog/migrate-customers-from-excel-to-crm-no-duplicates
- `pl`: https://aistohire.com/pl/aicrm-prosty-crm-z-api-do-zarzadzania-klientami-i-leadami-109/blog/przenoszenie-klientow-z-excela-do-crm-bez-duplikatow
- `he`: https://aistohire.com/he/aicrm-crm-pshot-am-api-lnihol-lkochot-vlidim-109/blog/lehaavir-lekochot-me-excel-le-crm-bli-kfilut
- `cs`: https://aistohire.com/cs/aicrm-jednoduche-crm-s-api-pro-spravu-klientu-a-leadu-109/blog/prevod-zakazniku-z-excelu-do-crm-bez-duplicit
- `id`: https://aistohire.com/id/aicrm-crm-sederhana-dengan-api-untuk-mengelola-pelanggan-dan-lead-109/blog/memindahkan-pelanggan-dari-excel-ke-crm-tanpa-duplikat
