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 koptekstrij van je bestand en probeert elke kolom automatisch te koppelen aan een doelveld: Voornaam, Achternaam, Telefoon, E-mail, Tags, Notities, een van je aangepaste velden, of Niet importeren. Controleer de suggestie voor 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 waarvan de koptekst de naam is van een van je aangepaste velden, wordt automatisch aan dat veld gekoppeld. Hoofdletters en accenten maken niet uit, dus een CPF-kolom vindt een veld genaamd cpf. Je kunt ook handmatig elk aangepast veld voor elke kolom kiezen.
    • Een kolom die nog geen aangepast veld is, kan er een worden: kies Nieuw aangepast veld: in de kiezer en het veld wordt aangemaakt wanneer je importeert.
    • Als een aangepast veld een type heeft (Getal, Selectievakje, Keuzelijst) en sommige waarden in de kolom passen daar niet bij, waarschuwt de wizard je voor het importeren hoeveel rijen dit betreft. Die rijen worden volledig overgeslagen, inclusief naam en e-mailadres. Klik op Wijzig naar Tekst in de waarschuwing om het type van het veld in één stap te wijzigen, of corrigeer de waarden, of stel de kolom in op Niet importeren.
    • Een kolom voor telefoonnummers is verplicht — je kunt niet doorgaan zonder er een toe te wijzen.
    • Een kolom die is toegewezen aan Tags wordt omgezet in echte tags voor elk contact. 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 hoofdlettergebruik wordt genegeerd.
  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. Als je de import opent terwijl de pagina Contactpersonen een van je lijsten toont, is die lijst al voor je geselecteerd; wis deze als je dat niet wilt.
    • Bestaande contactpersonen bijwerken — standaard uitgeschakeld. Indien uitgeschakeld, worden rijen die overeenkomen met een contactpersoon die je al hebt (hetzelfde telefoonnummer) overgeslagen als duplicaten: er verandert niets aan die contactpersoon, hoewel de contactpersoon die je al hebt wel aan de gekozen lijst wordt toegevoegd als je er een hebt geselecteerd. Indien ingeschakeld, werken die rijen de contactpersoon bij: de naam, het e-mailadres en de notities in je bestand overschrijven wat er al 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 aan te vullen.
  1. Klik op Importeer [count]. Je komt op een resultaatpagina terecht die laat zien hoeveel contacten er zijn aangemaakt, hoeveel bestaande contacten zijn bijgewerkt (wanneer die optie is ingeschakeld), hoeveel contacten die je al had zijn toegevoegd aan de gekozen lijst, en, als er rijen zijn overgeslagen, een overzicht van de reden (ongeldig telefoonnummer, ontbrekend telefoonnummer, duplicaat, contactlimiet bereikt, enz.). Als Bestaande contacten bijwerken uitstond en sommige rijen overeenkwamen met contacten die je al hebt, geeft het resultaatsscherm dit aan en biedt het Deze contacten bijwerken aan: met één klik worden alleen die rijen opnieuw verwerkt met de schakelaar aan, zodat je het bestand niet opnieuw hoeft te importeren.

Details over kolomtoewijzing

  • Telefoon is de enige verplichte kolom. Rijen zonder telefoonnummer worden vóór het importeren verwijderd en apart geteld in het resultaatvenster.
  • Voornaam / Achternaam / E-mail worden direct gekoppeld aan de basisvelden van de contactpersoon.
  • Notities wordt 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, uitzendingen 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 contactpersonen 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 bij elke contactpersoon wordt verwijderd).
  • Aangepaste velden — elk van je aangepaste velden is een eigen doel. Een koptekst die overeenkomt met de naam van een veld wordt voor je geselecteerd; de waarde wordt exact zoals deze in het bestand staat opgeslagen bij de contactpersoon (een Getal-, Datum-, Selectievakje- of Keuzelijstveld converteert herkenbare vormen zoals 19,99, 01/02/1990 of yes). Kies Nieuw aangepast veld om een veld aan te maken op basis van een kolom. Met Bestaande contactpersonen bijwerken ingeschakeld, werken waarden van aangepaste velden in het bestand ook contactpersonen bij die je al hebt; lege cellen laten de huidige waarde ongewijzigd.
  • Een kolom die identificatiegegevens bevat met punten, streepjes of voorloopnullen (een CPF, een belastingnummer, een postcode) hoort in een Tekst-veld. In een Getal-veld passen deze waarden niet en wordt de rij overgeslagen.

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 geen spaties, streepjes of haakjes uit telefoonnummers te verwijderen — de importfunctie accepteert gangbare opmaak, maar de landcode is wel vereist.
  • Bestanden worden volledig in je browser verwerkt, dus er is geen vaste uploadlimiet 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 op 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. Het kiezen van een lijst werkt nog steeds voor die rijen: de contactpersoon die je al hebt, wordt toegevoegd aan de lijst en afzonderlijk geteld op het resultatenscherm. Het opnieuw importeren van hetzelfde bestand is dus de manier om een lijst te vullen met mensen die al in je account staan. Om ook hun gegevens te vernieuwen (namen of e-mailadressen corrigeren, tags toevoegen), schakel je Bestaande contactpersonen 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 vanzelf, omdat de koptekst niet exact company is. Kies Aangepast veld: company in de kiezer van die kolom en het wordt geïmporteerd in het company veld. Door de koptekst vóór het uploaden te hernoemen naar company, zorgt de wizard ervoor dat deze automatisch wordt gekoppeld.

Sommige rijen zijn overgeslagen met “Een waarde voor een aangepast veld past niet bij het type van dat veld” — hoe komt dat? De kolom is gekoppeld aan een getypeerd aangepast veld (bijvoorbeeld Getal) en die rijen bevatten iets anders, zoals 001.576.401-08 in een Getal-veld. Klik op Wijzig naar Tekst bij de waarschuwing in de stap Kolommen toewijzen (of wijzig het type onder Aangepaste velden) en importeer het bestand opnieuw met Bestaande contacten bijwerken ingeschakeld.

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