Your AI Connector Docs

Importarea contactelor dintr-un fișier

Dacă aveți o listă de contacte într-un tabel, le puteți încărca pe toate odată în loc să le adăugați pe rând. Aplicația folosește un asistent în 3 pași — Încărcare → Mapare coloane → Revizuire — care funcționează cu fișierul CSV pe care îl aveți deja, fără a fi nevoie să descărcați mai întâi un șablon.

Cum să imporți contacte

  1. Faceți clic pe Contacts în bara laterală din stânga, apoi faceți clic pe Import în partea de sus a paginii.
  2. Încărcare. Trageți fișierul CSV în zona de plasare sau faceți clic pe aceasta pentru a naviga. Nu există un șablon de descărcat mai întâi — aduceți fișierul pe care îl aveți deja.
  1. Maparea coloanelor. Expertul citește rândul de antet al fișierului și încearcă să potrivească automat fiecare coloană cu un câmp țintă: Prenume, Nume, Telefon, Email, Etichete, Note, oricare dintre câmpurile personalizate sau Nu importa. Verifică sugestia pentru fiecare coloană și corectează-le pe cele greșite folosind selectorul de lângă acestea. Un tabel de previzualizare arată primele câteva rânduri exact așa cum vor fi importate.
    • O coloană al cărei antet este numele unuia dintre câmpurile tale personalizate este potrivită automat cu acel câmp. Majusculele și accentele nu contează, deci o coloană CPF va găsi un câmp numit cpf. De asemenea, poți alege manual orice câmp personalizat pentru orice coloană.
    • O coloană care nu este încă unul dintre câmpurile tale personalizate poate deveni unul: alege Câmp personalizat nou: în selectorul său, iar câmpul va fi creat în momentul importului.
    • Dacă un câmp personalizat are un tip (Număr, Casetă de bifare, Listă derulantă) și unele dintre valorile coloanei nu se potrivesc, expertul te avertizează câte rânduri sunt afectate înainte de import. Acele rânduri sunt omise complet, inclusiv numele și adresa de email. Dă clic pe Schimbă în Text în avertisment pentru a modifica tipul câmpului într-un singur pas, sau corectează valorile, ori setează coloana pe Nu importa.
    • O coloană pentru numărul de telefon este obligatorie — nu poți continua fără a mapa una.
    • O coloană mapată la Etichete devine etichete reale pentru fiecare contact. Mai multe etichete într-o singură celulă sunt acceptate — separă-le cu o virgulă sau un punct și virgulă (vip; newsletter; hotmart). Etichetele care nu există încă vor fi create automat; etichetele care există deja vor fi refolosite, ignorând scrierea cu majuscule.
  1. Revizuire. Alegeți:
    • Canal implicit — WhatsApp Business, WhatsApp Web sau SMS. Aceasta se aplică oricărui contact importat care nu specifică deja un canal.
    • Listă — alegeți o listă existentă din meniul derulant sau tastați un nume pentru a crea una nouă pe loc. Puteți face doar una sau alta, nu pe amândouă. Dacă deschideți importul în timp ce pagina Contacte afișează una dintre listele dvs., acea listă este deja selectată pentru dvs.; ștergeți-o dacă nu o doriți.
    • Actualizare contacte existente — dezactivat implicit. Dacă este dezactivat, rândurile care corespund unui contact pe care îl aveți deja (același număr de telefon) sunt omise ca duplicate: nimic din acel contact nu se modifică, deși dacă ați ales o listă, contactul pe care îl aveți deja se va alătura acesteia. Dacă este activat, acele rânduri actualizează contactul în schimb: numele, adresa de e-mail și notele din fișierul dvs. suprascriu ceea ce există (celulele goale lasă valoarea curentă neschimbată), orice etichete din rând sunt adăugate, iar contactul este adăugat la lista pe care ați ales-o. Acesta este modul în care reimportați un fișier pentru a corecta sau îmbogăți contactele pe care le aveți deja.
  1. Dă clic pe Importă [count]. Vei ajunge pe un ecran cu rezultate care arată câte contacte au fost create, câte contacte existente au fost actualizate (când această opțiune este activată), câte contacte pe care le aveai deja au fost adăugate la lista aleasă și, dacă au fost omise rânduri, o detaliere a motivului (număr de telefon invalid, număr de telefon lipsă, duplicat, limită de contacte atinsă etc.). Dacă opțiunea Actualizează contactele existente a fost dezactivată și unele rânduri corespundeau unor contacte pe care le ai deja, ecranul cu rezultate va menționa acest lucru și va oferi opțiunea Actualizează aceste contacte: un singur clic retrimite doar acele rânduri cu opțiunea activată, astfel încât să nu fie nevoie să imporți din nou fișierul.

Detalii despre maparea coloanelor

  • Telefon este singura coloană obligatorie. Rândurile fără niciun număr de telefon sunt eliminate înainte de import și numărate separat pe ecranul cu rezultate.
  • Prenume / Nume / Email se mapează direct pe câmpurile de bază ale contactului.
  • Note se mapează pe câmpul Note / Profil Lead al contactului.
  • Etichete creează (sau refolosește) etichete reale și le aplică contactului — aceleași etichete după care filtrezi, cu care vizezi difuzări și din care declanșezi webhook-uri. Pune mai multe într-o singură celulă separate prin virgule sau punct și virgulă. Înainte de 19 august 2026, această coloană era salvată ca un câmp personalizat numit tags; dacă ai importat înainte de acea dată, reimportă același fișier cu Actualizează contactele existente activat și etichetele vor fi aplicate corect (câmpul personalizat tags rămas nu face niciun rău; contactează asistența dacă dorești să fie șters de la fiecare contact).
  • Câmpuri personalizate — fiecare dintre câmpurile tale personalizate este propria sa țintă. Un antet care se potrivește cu numele unui câmp este selectat automat pentru tine; valoarea este salvată pe contact exact așa cum este în fișier (un câmp de tip Număr, Dată, Casetă de bifare sau Listă derulantă convertește formele recunoscute precum 19,99, 01/02/1990 sau yes). Alege Câmp personalizat nou pentru a crea un câmp dintr-o coloană. Cu Actualizează contactele existente activat, valorile câmpurilor personalizate din fișier actualizează și contactele pe care le ai deja; celulele goale lasă valoarea curentă neschimbată.
  • O coloană care conține identificatori cu puncte, liniuțe sau zerouri inițiale (un CPF, un cod fiscal, un cod poștal) aparține unui câmp de tip Text. Într-un câmp de tip Număr, acele valori nu se potrivesc și rândul este omis.

Sfaturi

  • Verificați de două ori dacă numerele de telefon includ prefixul țării. Fără acesta, mesajele nu vor fi livrate — iar rândurile fără un număr de telefon utilizabil sunt omise complet.
  • Nu este nevoie să eliminați spațiile, liniuțele sau parantezele din numerele de telefon — importatorul tolerează formatarea obișnuită, dar are totuși nevoie de prefixul țării.
  • Fișierele sunt analizate complet în browserul dvs., deci nu există o limită fixă de dimensiune a încărcării din partea expertului în sine — dar numărul total de contacte este totuși limitat de planul dvs. Dacă un import v-ar depăși limita planului, acele rânduri sunt respinse și apar pe ecranul cu rezultate ca contact_limit_reached.
  • Dacă un contact cu același număr de telefon există deja, acel rând este omis implicit — apare ca duplicate pe ecranul cu rezultate. Importul nu creează niciodată o a doua copie a cuiva. Alegerea unei liste funcționează în continuare pe acele rânduri: contactul pe care îl aveți deja este adăugat la listă și numărat separat pe ecranul cu rezultate, deci reimportarea aceluiași fișier este modul în care completați o listă cu persoane care se află deja în contul dvs. Pentru a reîmprospăta și câmpurile acestora (corectarea numelor sau a e-mailurilor, adăugarea de etichete), activați Actualizare contacte existente la pasul Revizuire și reimportați fișierul.

Întrebări frecvente

CSV-ul meu are o coloană custom_company dintr-o exportare veche — se va mapa corect? Nu de la sine, deoarece antetul nu este exact company. Alege Câmp personalizat: company în selectorul acelei coloane și se va importa în câmpul company. Redenumirea antetului în company înainte de încărcare va face ca expertul să îl potrivească automat pentru tine.

Unele rânduri au fost omise cu mesajul „O valoare a câmpului personalizat nu se potrivește cu tipul câmpului” — de ce? Coloana este mapată la un câmp personalizat cu tip definit (de exemplu, Număr), iar acele rânduri conțin altceva, cum ar fi 001.576.401-08 într-un câmp de tip Număr. Dă clic pe Schimbă în Text în avertismentul de la pasul Maparea coloanelor (sau schimbă tipul din secțiunea Câmpuri personalizate) și importă fișierul din nou cu opțiunea Actualizează contactele existente activată.

Unde a dispărut butonul „Descărcare șablon”? Nu mai există — asistentul funcționează direct cu orice CSV ai deja și îți permite să corectezi orice coloană nepotrivită în pasul de Mapare.

Am importat deja contactele mele — cum adaug etichete sau corectez câmpurile pentru toate deodată? Reimportă același fișier (sau unul actualizat) cu Actualizează contactele existente activat la pasul de Revizuire. Rândurile care corespund unui număr de telefon existent actualizează acel contact — nume, email, note, etichete și listă — în loc să fie omise. Doar numerele de telefon sunt folosite pentru potrivire, așa că păstrează acea coloană exact așa cum a fost.

Pot importa contacte de Instagram sau Messenger dintr-un fișier? Nu. Importul acceptă doar WhatsApp Business, WhatsApp Web și SMS, deoarece acele canale ajung la persoane prin număr de telefon. În schimb, Instagram și Messenger identifică persoanele prin contul lor social, astfel încât acele contacte sunt create automat atunci când cineva vă trimite un mesaj pe acel canal.

Pot importa contacte ca fiind inactive pentru bot? Nu există o coloană per rând pentru acest lucru. Importă lotul mai întâi, apoi folosește acțiunea în masă Bot oprit pe contactele importate — consultă Excluderea contactelor din botul AI.

Pașii următori