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

ייבוא אנשי קשר לאוכלוסייה ב-Pristo CX מקובץ Excel או CSV בגודל של עד 10 MB, עם עמודת מזהה ועמודה של אימייל או של מספר טלפון.

ב-Pristo CX מייבאים אנשי קשר מקובץ Excel (`.xlsx`) או CSV בלשונית **אוכלוסיה**, בתפריט **פעולות** > **ייבוא אנשי קשר**. לכל איש קשר צריך מזהה, ובקובץ צריכה להיות עמודה של אימייל או של טלפון.

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

- תפקיד: הפעולה זמינה למנהלי חשבון ולמנהלי תוכנית. משתמשי תוכנית לא יכולים לייבא. ראו [תפקידים והרשאות](https://docs.pristo.io/he/cx/users/roles-and-permissions).
- חבילה: כל חבילה חוץ מהחבילה החינמית. [האוכלוסייה](https://docs.pristo.io/he/cx/glossary) לא זמינה בחבילה החינמית.
- הגדרה מראש: כדי לשמור עמודות נוספות, כמו עיר או רמת לקוח, הגדירו אותן קודם כמאפייני אנשי קשר. ראו [מאפייני אנשי קשר](https://docs.pristo.io/he/cx/populations/contact-attributes).
- קובץ: איש קשר אחד בכל שורה, עד 10 MB. בקובץ Excel, שימו את אנשי הקשר בגיליון הראשון.

## שלבים

![סקיצה של החלון לייבוא אנשי קשר, פתוח מעל דף האוכלוסייה. סימון 3 נמצא על הכפתור שבוחר את הקובץ. סימון 4 נמצא על האפשרות לקובץ שהשורה הראשונה בו מכילה את שמות העמודות. סימון 5 נמצא על האפשרות שמעדכנת אנשי קשר קיימים. סימון 6 נמצא על מיפוי העמודות, שבו בוחרים אות עמודה לכל שדה. סימון 7 נמצא על הכפתור שבודק את הקובץ, בפינה השמאלית התחתונה של החלון.](https://docs.pristo.io/_astro/import-contacts.DyQB_Vlh.webp)

1. פתחו את הלשונית **אוכלוסיה**.

2. בתפריט **פעולות**, בחרו באפשרות **ייבוא אנשי קשר**.

3. לחצו על **בחר קובץ** ובחרו את הקובץ.

4. השאירו את האפשרות **הקובץ מכיל כותרות** מסומנת אם השורה הראשונה מכילה את שמות העמודות. בטלו את הסימון אם הנתונים מתחילים כבר בשורה הראשונה.

5. השאירו את האפשרות **עדכן אנשי קשר שהמזהה שלהם כבר קיים** מסומנת כדי לעדכן אנשי קשר שכבר נמצאים באוכלוסייה. בטלו את הסימון כדי להוסיף רק אנשי קשר חדשים.

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

7. לחצו על **הבא**. בשלב הזה Pristo CX בודקת את הקובץ בלי לייבא שום דבר.

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

9. כשמופיעה ההודעה **הייבוא הושלם בהצלחה**, לחצו על **סגירה**.

החלון זוכר את המיפוי שלכם, כך שהייבוא הבא מתחיל עם אותן עמודות.

## התוצאה

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

כדי לייבא פעילויות (אירועים) במקום אנשי קשר, השתמשו באפשרות **ייבוא פעילויות** באותו תפריט, כמו שמוסבר בדף [ייבוא פעילויות](https://docs.pristo.io/he/cx/populations/import-activities).

## מגבלות

- סוגי קבצים: `.xlsx` ו-`.csv` בלבד, עד 10 MB. מקובץ Excel נקרא רק הגיליון הראשון.
- עמודות: אפשר למפות עמודות מ-A עד BZ.
- מזהה: חובה, עד 50 תווים, וייחודי בקובץ. שורה עם מזהה שכבר קיים מעדכנת את איש הקשר הזה, או שמדלגים עליה כשהעדכון כבוי.
- כשאיש קשר מתעדכן, שדות השם, האימייל, הטלפון והמאפיינים שלא מיפיתם שומרים על הערכים הקיימים שלהם.
- שם ושם משפחה: עד 50 תווים. ערכים ארוכים יותר נחתכים ל-50 תווים, עם אזהרה.
- אימייל: כתובת לא תקינה לא מיובאת, עם אזהרה, ושאר הפרטים של איש הקשר מיובאים.
- טלפון: הודעות SMS נשלחות רק למספרים ש-Pristo CX מזהה כמספרי נייד ישראליים (+972 5…). מספר בלי קידומת מדינה נקרא כמספר ישראלי. מספרים אחרים מיובאים עם אזהרה, ובדף של איש הקשר מופיע הכיתוב **מספר לא תקין**.
- שפה: קוד בן שתי אותיות, כמו `en` או `he`. אם עמודת השפה לא ממופה, או שאי אפשר לקרוא ערך, איש הקשר מקבל את שפת ברירת המחדל של האוכלוסייה.
- אי אפשר לייבא קובץ שיש בו שגיאה כלשהי. הבדיקה מפסיקה לפרט שגיאות אחרי כ-100 שגיאות.

## פתרון בעיות

**החלון מציג הודעה שהקובץ לא תקין.** ההודעה **קובץ לא חוקי. אנא בחר קובץ xlsx או csv חוקי בגודל עד 10MB** אומרת שהקובץ אינו `.xlsx` או `.csv`, או שהוא גדול מ-10 MB. שמרו אותו באחד מהפורמטים האלה או פצלו אותו לקבצים קטנים יותר.

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

**עמודה מהקובץ שלי לא יובאה.** רק עמודות ממופות מיובאות ל-Pristo CX. הגדירו את העמודה כמאפיין איש קשר, ואז ייבאו את הקובץ שוב כשהאפשרות **עדכן אנשי קשר שהמזהה שלהם כבר קיים** מסומנת.

**איש קשר לא מקבל SMS.** פתחו את איש הקשר. אם ליד הטלפון שלו מופיע **מספר לא תקין**, תקנו את המספר בקובץ וייבאו אותו שוב כשהעדכון מופעל.

## ראו גם

- [סקירה כללית של אוכלוסיות](https://docs.pristo.io/he/cx/populations/overview)
- [ייבוא פעילויות](https://docs.pristo.io/he/cx/populations/import-activities)
- [מאפייני אנשי קשר](https://docs.pristo.io/he/cx/populations/contact-attributes)
- [יצירת הפצה](https://docs.pristo.io/he/cx/distributions/create-a-distribution)
- [שליחת סקרים אחרי אירוע](https://docs.pristo.io/he/cx/distributions/event-based)
- [תפקידים והרשאות](https://docs.pristo.io/he/cx/users/roles-and-permissions)