Your AI Connector Docs

Contacten importeren vanuit een bestand

Als je een lijst met contactpersonen in een spreadsheet hebt, kun je ze allemaal tegelijk uploaden in plaats van ze één voor één toe te voegen. De app gebruikt een wizard van 3 stappen — Uploaden → Kolommen toewijzen → Controleren — die werkt met het CSV-bestand dat je al hebt, zonder dat je eerst een sjabloon hoeft te downloaden.

Hoe je contacten importeert

  1. Klik op Contacten in de linkerzijbalk en klik vervolgens op Importeren bovenaan de pagina.
  2. Uploaden. Sleep je CSV-bestand naar het dropzone-gebied of klik erop om te bladeren. Er hoeft geen sjabloon te worden gedownload — gebruik gewoon het bestand dat je al hebt.
  1. Kolommen toewijzen. De wizard leest de koprij van je bestand en probeert elke kolom automatisch te koppelen aan een doelveld: Voornaam, Achternaam, Telefoonnummer, E-mail, Tags, Notities of Niet importeren. Controleer de gok van elke kolom en corrigeer eventuele fouten met de kiezer ernaast. Een voorbeeldtabel toont de eerste paar rijen precies zoals ze worden geïmporteerd.
    • Een kolom voor telefoonnummers is verplicht — je kunt niet verder zonder er een toe te wijzen.
    • Een kolom die is toegewezen aan Tags wordt echte tags op elke contactpersoon. Meerdere tags in één cel zijn prima — scheid ze met een komma of puntkomma (vip; newsletter; hotmart). Tags die nog niet bestaan, worden voor je aangemaakt; bestaande tags worden hergebruikt, waarbij geen onderscheid wordt gemaakt tussen hoofdletters en kleine letters.
  1. Controleren. Kies:
    • Standaardkanaal — WhatsApp Business, WhatsApp Web of SMS. Dit is van toepassing op elke geïmporteerde contactpersoon waarvoor nog geen kanaal is opgegeven.
    • Lijst — kies een bestaande lijst uit het vervolgkeuzemenu of typ een naam om direct een nieuwe aan te maken. Je kunt slechts één van beide doen, niet beide.
    • Bestaande contacten bijwerken — standaard uitgeschakeld. Indien uitgeschakeld, worden rijen die overeenkomen met een contactpersoon die je al hebt (hetzelfde telefoonnummer) overgeslagen als dubbel: er verandert niets aan die contactpersoon en deze wordt niet aan de lijst toegevoegd. Indien ingeschakeld, werken die rijen de contactpersoon bij: de naam, e-mail en notities in je bestand overschrijven wat er staat (lege cellen laten de huidige waarde ongewijzigd), eventuele tags in de rij worden toegevoegd en de contactpersoon wordt toegevoegd aan de lijst die je hebt gekozen. Dit is hoe je een bestand opnieuw importeert om contactpersonen die je al hebt te corrigeren of te verrijken.
  1. Klik op Importeer [count]. Je komt op een resultatenscherm terecht dat laat zien hoeveel contactpersonen er zijn aangemaakt, hoeveel bestaande contactpersonen zijn bijgewerkt (wanneer die optie is ingeschakeld) en, als er rijen zijn overgeslagen, een overzicht van de reden (ongeldig telefoonnummer, ontbrekend telefoonnummer, dubbel, contactlimiet bereikt, enz.).

Details over kolomtoewijzing

  • Telefoonnummer is de enige verplichte kolom. Rijen zonder telefoonnummer worden vóór het importeren verwijderd en afzonderlijk geteld in het resultatenscherm.
  • Voornaam / Achternaam / E-mail worden direct gekoppeld aan de basisvelden van de contactpersoon.
  • Notities worden gekoppeld aan het veld Notities / Leadprofiel van de contactpersoon.
  • Tags maakt (of hergebruikt) echte tags aan en past deze toe op de contactpersoon — dezelfde tags waarop je filtert, broadcasts richt en webhooks activeert. Plaats er meerdere in één cel, gescheiden door komma’s of puntkomma’s. Vóór 19 augustus 2026 werd deze kolom opgeslagen als een aangepast veld genaamd tags; als je vóór die datum hebt geïmporteerd, importeer het bestand dan opnieuw met Bestaande contacten bijwerken ingeschakeld en de tags worden correct toegepast (het overgebleven tags aangepaste veld kan geen kwaad; neem contact op met de ondersteuning als je wilt dat het van elke contactpersoon wordt verwijderd).
  • Er is momenteel geen kolomtoewijzing voor willekeurige aangepaste velden (zoals de custom_<fieldname>-kolommen van de klassieke versie) — zie Bulk-Loading Custom Fields voor de huidige tijdelijke oplossing.

Tips

  • Controleer dubbel of telefoonnummers de landcode bevatten. Zonder deze code worden berichten niet afgeleverd — en rijen zonder bruikbaar telefoonnummer worden volledig overgeslagen.
  • Je hoeft spaties, streepjes of haakjes niet uit telefoonnummers te verwijderen — de importeur tolereert algemene opmaak, maar heeft nog steeds de landcode nodig.
  • Bestanden worden volledig in je browser geparseerd, dus er is geen vaste limiet voor de uploadgrootte vanuit de wizard zelf — maar je totale aantal contactpersonen wordt nog steeds beperkt door je abonnement. Als een import je over de limiet van je abonnement zou tillen, worden die rijen geweigerd en verschijnen ze in het resultatenscherm als contact_limit_reached.
  • Als een contactpersoon met hetzelfde telefoonnummer al bestaat, wordt die rij standaard overgeslagen — deze verschijnt als duplicate op het resultatenscherm. De import maakt nooit een tweede kopie van iemand aan. Om contactpersonen die je al hebt in bulk te bewerken (namen of e-mails corrigeren, tags toevoegen, ze aan een lijst toevoegen), schakel je Bestaande contacten bijwerken in bij de stap Controleren en importeer je het bestand opnieuw.

Veelgestelde vragen

Mijn CSV heeft een custom_company-kolom uit een oude export — wordt deze correct toegewezen? Niet automatisch. De automatische koppeling van de wizard herkent alleen kopteksten voor naam/telefoon/e-mail/tags/notities; al het andere wordt standaard ingesteld op Niet importeren, dus een custom_company-kolom zal het aangepaste veld company niet uit zichzelf vullen. Voeg de waarden achteraf toe via Aangepaste velden of via de API.

Waar is de knop “Sjabloon downloaden” gebleven? Die is verdwenen — de wizard werkt direct met elk CSV-bestand dat je al hebt en laat je in de stap ‘Toewijzen’ eventuele verkeerd gekoppelde kolommen corrigeren.

Ik heb mijn contactpersonen al geïmporteerd — hoe voeg ik tags toe of corrigeer ik velden voor allemaal tegelijk? Importeer hetzelfde bestand (of een bijgewerkt bestand) opnieuw met Bestaande contacten bijwerken ingeschakeld in de stap Controleren. Rijen die overeenkomen met een bestaand telefoonnummer werken die contactpersoon bij — naam, e-mail, notities, tags en lijst — in plaats van te worden overgeslagen. Alleen telefoonnummers worden gebruikt voor de koppeling, dus houd die kolom precies zoals deze was.

Kan ik Instagram- of Messenger-contacten importeren vanuit een bestand? Nee. Importeren ondersteunt alleen WhatsApp Business, WhatsApp Web en sms, omdat deze kanalen mensen bereiken via een telefoonnummer. Instagram en Messenger identificeren mensen daarentegen via hun sociale account, dus die contacten worden automatisch aangemaakt wanneer iemand je een bericht stuurt via dat kanaal.

Kan ik contacten importeren als bot-inactief? Er is geen kolom per rij voor. Importeer de batch eerst en gebruik daarna de bulkactie Bot uit op de geïmporteerde contacten — zie Contacten uitsluiten van de AI-bot.

Volgende stappen