
# 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.


3. **Map coloane.** Expertul citește rândul de antet al fișierului tău și încearcă să potrivească automat fiecare coloană cu un câmp țintă: **Prenume, Nume, Telefon, Email, Etichete, Note** sau **Nu importa**. Verifică sugestia pentru fiecare coloană și corectează-le pe cele greșite folosind selectorul de lângă ele. Un tabel de previzualizare arată primele câteva rânduri exact așa cum vor fi importate.
   * 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ă sunt create automat pentru tine; etichetele care există deja sunt refolosite, ignorând majusculele.


4. **Revizuire.** Alege:
   * **Canal implicit** — WhatsApp Business, WhatsApp Web sau SMS. Aceasta se aplică oricărui contact importat care nu specifică deja un canal.
   * **Listă** — alege o listă existentă din meniul derulant sau tastează un nume pentru a crea una nouă pe loc. Poți face doar una sau alta, nu ambele.
   * **Actualizează contactele existente** — dezactivat implicit. Dacă este dezactivat, rândurile care corespund unui contact pe care îl ai deja (același număr de telefon) sunt omise ca duplicate: nimic din acel contact nu se modifică și acesta **nu** este adăugat în listă. Dacă este activat, acele rânduri **actualizează** contactul în schimb: numele, emailul și notele din fișierul tău suprascriu ceea ce există (celulele goale lasă valoarea curentă neschimbată), orice etichetă din rând este adăugată, iar contactul este adăugat în lista aleasă de tine. Acesta este modul în care reimportezi un fișier pentru a corecta sau îmbogăți contactele pe care le ai deja.


5. Dă clic pe **Importă [count]**. Vei ajunge pe un ecran de rezultate care arată câte contacte au fost create, câte contacte existente au fost actualizate (când acea opțiune este activată) ș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.).

---

## 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 de rezultate.
* **Prenume / Nume / Email** se mapează direct pe câmpurile de bază ale contactului.
* **Note** se mapează pe câmpul [Note / Profil Lead](custom-contact-fields.md#notes-lead-profile) al contactului.
* **Etichete** creează (sau refolosește) etichete reale și le aplică contactului — aceleași etichete după care filtrezi, cu care vizezi difuzările și de la 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 dăunează; contactează asistența dacă dorești să fie șters de la fiecare contact).
* În prezent nu există mapare de coloane pentru câmpuri personalizate arbitrare (cum ar fi coloanele `custom_<fieldname>` din versiunea clasică) — consultă [Încărcarea în masă a câmpurilor personalizate](custom-contact-fields.md#bulk-loading-custom-fields) pentru soluția actuală.

---

## Sfaturi

- Verifică 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 trebuie să elimini 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 procesate integral în browserul tău, deci nu există o limită fixă de dimensiune a încărcării din partea expertului — dar numărul total de contacte este în continuare limitat de planul tău. Dacă un import te-ar depăși limita planului, acele rânduri sunt respinse și apar pe ecranul de 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 de rezultate. Importul nu creează niciodată o a doua copie a cuiva. Pentru a edita în masă contactele pe care le ai deja (a corecta nume sau emailuri, a adăuga etichete, a le pune într-o listă), activează **Actualizează contactele existente** la pasul de Revizuire și reimportă fișierul.

---

## Întrebări frecvente

**CSV-ul meu are o coloană `custom_company` dintr-o exportare veche — se va mapa corect?**
Nu automat. Potrivirea automată a asistentului recunoaște doar antetele de nume/telefon/email/etichete/note; orice altceva este setat implicit pe **Nu importa**, deci o coloană `custom_company` nu va popula singură câmpul personalizat `company`. Adaugă valorile ulterior prin [Câmpuri personalizate](custom-contact-fields.md) sau prin API.

**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](excluding-contacts-from-bot.md).

---

## Pașii următori

- [Organizarea listelor și a contactelor](list-and-contact-management.md) — gestionează și sortează contactele nou importate.
- [Trecerea de la Campanii la Difuzări și Agenți](../moving-from-campaigns.md) — începe să trimiți mesaje către lista ta importată.
- [Câmpuri personalizate, profilul lead-ului și note](custom-contact-fields.md) — completează detalii mai bogate după import.
