# ייבוא אנשי קשר מגיליון

מכינים קובץ CSV או XLSX, ממפים עמודות ובודקים אילו רשומות נוצרו או עודכנו ואילו שורות דולגו או נכשלו.

Canonical: https://docs.lead-knight.com/he/contacts/import-contacts/

## מה הייבוא עושה

הייבוא יוצר אנשי קשר חדשים ומשלים פרטים בכרטיסים קיימים שנמצאה להם התאמה. זו אינה דריסה גורפת: שמות ופרטי זיהוי שכבר קיימים נשמרים, אפשר להשלים פרטים חסרים ולמזג תגיות. התוצאות מוצגות בסיכום ובפירוט השורות הבעייתיות.

## לפני שמתחילים

- משתמשים בחשבון עם תפקיד בעלים או מנהל בסביבה. בתפקידים אחרים לא מופיע **ייבוא** בדף **אנשי קשר**.
- מכינים CSV בקידוד UTF-8 או קובץ Excel מסוג `.xlsx` עם שורת כותרות. הפורמט הישן `.xls` אינו נתמך.
- גודל הקובץ עד 2 MiB, כלומר 2,097,152 בתים, ועד 5,000 שורות נתונים מעבר לשורת הכותרות. אלה מגבלות ייבוא אנשי קשר, לא המגבלות של ייבוא לקהל.
- לכל עמודה שממפים נותנים כותרת ייחודית שאינה ריקה. כותרות לא ריקות שחוזרות על עצמן נדחות. בגיליון מותרות עד 100 עמודות; מגבלת התווים בכל תא היא 4,096 ב־CSV ו־500 ב־XLSX.
- כוללים עמודת שם ולפחות עמודת טלפון או אימייל. אנשי קשר חדשים חייבים לעמוד ב־**פרטי קשר נדרשים** של הסביבה; מיפוי עמודת זיהוי אחת אינו מבטל דרישה לשני הפרטים.

## מעלים וממפים

1. פותחים **אנשי קשר** ולוחצים על **ייבוא**. נפתח חלון **ייבוא אנשי קשר**.
2. תחת **קובץ CSV או Excel** לוחצים על **בחירת קובץ**, או משתמשים באזור **גררו לכאן קובץ או בחרו קובץ**. לאחר טעינת התצוגה המקדימה מוצגים שם הקובץ, מספר שורות הנתונים ודוגמאות ערכים.
3. בודקים את המיפוי שהוצע. כותרות מוכרות בעברית ובאנגלית עשויות להיות ממופות אוטומטית, אך עדיין בודקים את הדוגמאות.
4. ממפים **שם**, **טלפון** ו־**אימייל** לעמודות המתאימות. **ללא עמודה** משאיר שדה רשות ללא מיפוי. הייבוא אינו זמין בלי עמודת שם ולפחות עמודת טלפון או אימייל.
5. לפי הצורך ממפים **תגיות**, **מקור**, **הערות** ושדות מותאמים של אנשי קשר. עבור תגיות, הערות ושדות מותאמים אפשר לבחור **ערך קבוע** שיינתן לכל שורה במקום קריאה מעמודה. לא משתמשים בשתי השיטות יחד לאותו שדה.
6. בוחרים **מקור ברירת מחדל** לשורות שזקוקות למקור חלופי. בוחרים **אחראי** אם הכרטיסים החדשים מיועדים לחבר צוות אחר שמופיע ברשימה. כרטיס קיים שנמצאה לו התאמה שומר על האחראי שלו.
7. במהדורת הנדל״ן, **קונה / מוכר** מאפשר להוסיף תפקיד קונה, מוכר או את שניהם. **ללא** אינו מוסיף תפקידים; הייבוא לא מסיר תפקידים קיימים.
8. לוחצים על **ייבא אנשי קשר**. בזמן הביצוע מופיע **מייבא…**. ממתינים לתוצאה ולא שולחים שוב את אותו קובץ.
9. בודקים **נוצרו**, **עודכנו**, **דולגו (פרטים מוסתרים)**, **כפילויות אפשריות** ו־**שגיאות**. בודקים כל **שורה** שמפורטת לפני שמסיקים שהייבוא הושלם במלואו.

## ערכים קבועים ושדות מותאמים

ברשימת תגיות קבועה אפשר להזין עד 20 תגיות, עד 40 תווים לכל תגית. הערה קבועה מוגבלת ל־4,000 תווים, וערך מותאם קבוע ל־500 תווים. ערך מותאם חייב להתאים גם לסוג השדה, למשל מספר או תאריך. ערך קבוע לא תקין חוסם את השליחה; מתקנים את השדה המסומן, בלי למחוק את כל המיפוי.

התצוגה המקדימה זמינה ל־15 דקות. אם פג תוקפה, בוחרים מחדש את הקובץ ובודקים שוב את המיפוי. היא קשורה למשתמש ולסביבה שבהם בוצעה ההעלאה.

## מה קורה כשיש התאמה

| תוצאה | המשמעות |
| --- | --- |
| **נוצרו** | נוצר כרטיס חדש משורה תקינה. |
| **עודכנו** | הטלפון או האימייל התאימו לכרטיס נגיש אחד; אפשר להשלים פרטים חסרים ולמזג תגיות בלי להחליף את האחראי. |
| **דולגו (פרטים מוסתרים)** | נמצאה התאמה שאין לכם גישה לפרטיה. הכרטיס לא השתנה; התוצאה עשויה להציג את האחראי בלי לחשוף את פרטי הכרטיס. |
| **כפילויות אפשריות** | למשל, הטלפון מתאים לכרטיס אחד והאימייל לאחר. השורה מסומנת לבדיקה במקום להפוך לכרטיס נוסף. |
| **שגיאות** | השורות הללו לא עברו בדיקה. שורות תקינות אחרות עשויות כבר להיות מיובאות. |

שם, טלפון ואימייל שכבר נשמרו אינם מוחלפים רק משום שבגיליון יש ערך אחר. שדות מותאמים משלימים ערכים ריקים. הערה זהה שהמשתמש המייבא כבר הוסיף לא מתווספת שוב. לשינוי מכוון של פרטים קיימים משתמשים ב־[עריכת פרטי איש קשר](https://docs.lead-knight.com/he/contacts/details-and-tags/).

## אם משהו לא מסתדר

| הודעה או שגיאה | מה המשמעות ומה עושים |
| --- | --- |
| **אפשר לייבא קובץ CSV או Excel.** | סוג הקובץ אינו נתמך. מייצאים כ־CSV או `.xlsx`; שינוי שם הקובץ אינו תיקון לפורמט. |
| **הקובץ גדול מדי או מכיל יותר מדי שורות.** | מפצלים לקבצים שעומדים במגבלות הגודל ומספר השורות, ושומרים כותרות בכל קובץ. זו עשויה להיות שגיאת `import_too_large` או HTTP 413. |
| **לא ניתן לייבא את הקובץ הזה בבטחה. בחר/י קובץ אחר.** | `import_file_unsafe`: בדיקות בטיחות נכשלו; גם חריגת גודל או שורות ב־XLSX ומגבלת ההעלאה יכולות להפיק אותה. מייצאים קובץ CSV/XLSX נקי וקטן יותר ובוחרים בו מחדש. |
| **קובץ ה-CSV אינו תקין.** | פענוח CSV נכשל או שכותרות חוזרות. בודקים מרכאות וכותרות ייחודיות ומייצאים מחדש. |
| **לא ניתן לייבא אנשי קשר. נסו שוב.** | כשל כללי, כולל `invalid_file` בקובץ XLSX פגום. מייצאים גיליון תקין או CSV ובוחרים מחדש. |
| **תוקף הייבוא פג. יש לבחור את הקובץ מחדש.** | התצוגה הזמנית אינה זמינה עוד. בוחרים וממפים מחדש. |
| **העמודה שנבחרה אינה קיימת בקובץ. יש לבחור את הקובץ מחדש.** | המיפוי אינו תואם לתצוגה המקדימה. בוחרים שוב את הקובץ הרצוי. |
| **הייבוא עמוס כרגע. נסה/י שוב בקרוב; אם התצוגות המקדימות מלאות, הן יפוגו תוך 15 דקות.** | `import_busy`: הקיבולת הזמנית מלאה. ממתינים ומנסים שוב במקום לפתוח עוד ועוד תצוגות מקדימות. |
| **מספר טלפון לא תקין.**, **כתובת אימייל לא תקינה.** או **חסר:** | מתקנים את השורה המצוינת ועומדים בדרישות הסביבה. מייבאים את השורות הכושלות לאחר תיקון ולא מניחים שכל הקובץ נכשל. |

## מדריכים קשורים

- [סקירת אנשי קשר](https://docs.lead-knight.com/he/contacts/overview/)
- [הוספת איש קשר אחד](https://docs.lead-knight.com/he/contacts/add-contact/)
- [עריכת פרטים ותגיות](https://docs.lead-knight.com/he/contacts/details-and-tags/)
- [קהלים](https://docs.lead-knight.com/he/audiences/overview/)


## ייבוא אנשי קשר מקובץ

[ייבוא אנשי קשר מקובץ](https://kwqpaiaguxkmadaipfrf.supabase.co/storage/v1/object/public/guide-videos/guides/videos/J3/nadlanite-he-4532cacce664.mp4)

1. כדי להכניס אנשי קשר מקובץ, לוחצים על ייבוא.
2. בוחרים קובץ CSV או אקסל.
3. העמודות מותאמות אוטומטית לשדות. אפשר לשנות כל התאמה מהרשימה.
4. קובעים מקור ברירת מחדל לכל מי שבקובץ.
5. אפשר גם לסמן קונים או מוכרים ולבחור מי אחראי עליהם.
6. לוחצים על ייבא אנשי קשר.
7. בסיום רואים כמה אנשי קשר נוצרו, עודכנו או דולגו.