זיהוי לקוחות ובדיקת השייכות שלהם למערכת העסק

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

איך זה עובד

• הוכחה: האם לאדם הזה יש שליטה בטלפון או באימייל?
• שייכות: האם במערכת העסק שלכם יש חשבון משתמש שמתאים לפרט הזה?

למשל, קוד יכול להוכיח שליטה בכתובת אימייל. הוא לא מוכיח שבעל הכתובת הוא תלמיד רשום.

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

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

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

איפה זה נמצא

לקוחות ← זיהוי משתמשים הוא המקום לניהול מקורות משתמשים. להגדרות ההוכחה הנדרשת לכל יכולת, פתחו את הכלל שלה ב־הבוט ← המדריך ← מה [שם העוזר] עושה כש… ← למי זה מיועד.

הגדרה

שימוש בחנות Shopify כמקור משתמשים

כשאתם מחברים את חנות Shopify, מופיע מקור עם הכותרת Shopify · ושם החנות, כשהוא כבוי. אין צורך להוסיף אותו בעצמכם.

1. מצאו את מקור ה־Shopify תחת מי המשתמשים שלכם.
2. הפעילו את פעיל כדי לפתוח את מסך הבדיקה לפני ההפעלה.
3. בדקו את החנות ואת שתי המשמעויות שבהמשך. אם יש דרישות קיימות שלא מציינות מקור, מופיע גם מספרן.
4. בחרו הפעלה כדי להפעיל את המקור, או ביטול כדי להשאיר אותו כבוי.

• משתמש מאומת · Shopify אומר שיש אימות מתאים וקישור עדכני לחשבון בחנות. זה יכול להתבסס על טלפון או אימייל מאומתים שמקושרים לחשבון, או על כניסה מהימנה לחשבון בחנות כפי שמוסבר בהמשך. אימות לבדו, בלי הקישור לחשבון, לא מספיק.
• מזוהה · Shopify אומר שנמצאה התאמה לפי הזמנות החנות, בלי הוכחה שהחשבון שייך לאדם שמשוחח. בחרו בזה רק אם אתם מתכוונים לאפשר את הבדיקה החלשה יותר.

הפעלת המקור מאפשרת גם להתאמות מתאימות מ־Shopify לעמוד בדרישות כל ספק שלא מציינות מקור מסוים. ההשפעה אינה מוגבלת לפעולות שבהן בחרתם במפורש ב־Shopify.

אפשר לשנות את שם המקור או לכבות את פעיל. ב־Shopify אין מיפוי תשובה, רשימת תפקידים או נסו בעצמכם. המקור נכבה כשהחנות מתנתקת. חיבור מחדש של אותה חנות מחזיר אותו לפעולה רק אם הניתוק הוא שכיבה אותו. מקור שמעולם לא הפעלתם או שכיביתם בעצמכם נשאר כבוי. חיבור חנות אחרת משאיר אותו כבוי עד שתבדקו ותפעילו אותו שוב.

מאפשרים ללקוחות להיכנס לחשבון בחנות

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

1. תחת איך אנשים מוכיחים מי הם, מצאו את כניסה עם חשבון בחנות (Shopify). האזור מופיע כשיש חיבור לחנות וקו של צ׳אט באתר.
2. אם חסרה הרשאה, בחרו אישור ב-Shopify והשלימו את אישור הגישה ב-Shopify ואת הקישור בחזרה ל־omotto. פתיחת הכפתור רק מבקשת גישה; היא לא מעניקה אותה. מתן ההרשאה הנוספת מחבר את החנות מחדש. שיחות קודמות שנקשרו לכניסה לחנות מתחילות מחדש אחרי החיבור הזה.
3. פתחו פעם אחת את החנות שפורסמה, עם הצ׳אט הרגיל מותקן. חזרו למסך הזה ובדקו שמופיעים ההרשאה ב-Shopify ניתנה ו־הבדיקה בחנות עברה עם מועד הבדיקה. הרשאה לבדה אינה בדיקה מוצלחת.
4. בקו הרצוי, הפעילו את לקוחות מחוברים לחנות נחשבים מאומתים. קראו את שם החנות והקו בחלון האישור, ובחרו הפעלה.
5. השאירו את להציע כניסה לחשבון בחנות בצ׳אט מופעל אם תרצו להציע את כפתור הכניסה כשנדרש אימות. כיבויו מפסיק את הצעת הכפתור, בלי לבטל את האמון בכניסה קיימת לחנות.

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

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

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

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

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

סוכן מחובר יכול לבדוק את ההגדרה לפי קו, לשנות את הצעת הכניסה או לכבות את האמון. הפעלת האמון דורשת בדיקה שלכם ב־omotto; קישור מהסוכן לא מעניק הרשאת Shopify ולא מפעיל את האמון עבורכם. הקואץ׳ מפנה להגדרה במקום להציע את המתגים האלה ככרטיס אישור.

לפני שמוסיפים מקור API מותאם

מקור API מותאם משתמש בפעולת קריאה בלבד מתוך חיבור API מותאם: ממשק תכנות שמאפשר ל־omotto לקבל מידע ממערכת העסק. במסך, הפעולה נקראת נקודת קצה ב־Custom API. בקשו ממי שמחבר את המערכת שלכם להכין אותה קודם.

הפעולה צריכה לעמוד בתנאים הבאים:

• הפעולה והחיבור שלה פעילים.
• הפעולה מחזירה מידע ולא מבצעת שינוי אמיתי. המתג מבצעת פעולה אמיתית צריך להיות כבוי.
• יש לה שדה זהות אחד בדיוק. בחרו ממולא מתוך ← ערך מ־omotto ואז טלפון או דוא״ל מאומתים של הלקוח. גם שורות קיימות של זהות מאומתת ← טלפון מאומת / אימייל מאומת ממשיכות לעבוד. פרטי קשר כפי שהוקלדו, שמות ומספרי הזמנות אינם קלטי חיפוש מתאימים.
• היא לא דורשת שדה חובה מתוך השיחה. אפשר להשתמש בערכים קבועים; שדות רשות מתוך השיחה לא נשלחים בחיפוש של מקור משתמשים.
• היא לא דורשת התאמה לחשבון משתמש כתנאי להפעלתה. אחרת, היא תזדקק מראש לתשובה שהיא אמורה למצוא.

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

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

מקורות מוצעים

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

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

1. קראו את שם נקודת הקצה ואת חיפוש לפי.
2. אם היא חסומה, בחרו סקירת ההגדרות ותקנו את הבעיה שמופיעה לפני שתחזרו. הקישור פותח את הגדרות החיבור כשפרטי הגישה חסרים או לא ניתנים לקריאה, או כשהחיבור כבוי. בבעיות אחרות הוא פותח את הגדרות נקודת הקצה.
3. בנקודת קצה מוכנה, בחרו להשתמש בזה. טופס ההוספה נפתח כשהיא כבר נבחרה; עדיין לא נשמר מקור.
4. בדקו את השם ואת מיפוי התשובה, ואז השלימו את השלבים בהמשך.

מבקשים מהסוכן המחובר

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

1. בקשו מהסוכן להכין מקור משתמשים למערכת העסק שלכם. אם צריך חיבור או נקודת קצה חדשים, השלימו קודם את צעדי ההפעלה שהסוכן מעביר אליכם. שניהם צריכים להיות פעילים לפני שהסוכן יכול להוסיף את המקור.
2. בדקו ב־omotto את שם המקור, מיפוי התשובה וההצהרה שפרט הקשר שייך לבעל החשבון. המקור החדש שהסוכן מכין מתחיל כבוי, וגם חיפוש לפי פרטים שאנשים מקלידים נשאר כבוי.
3. הפעילו את פעיל רק אחרי שבדקתם את ההגדרות.
4. הריצו בעצמכם את נסו בעצמכם עם דוגמה מוכרת.

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

הוספת מקור משתמשים מ־API מותאם

1. תחת מי המשתמשים שלכם, בחרו הוספת מקור.
2. הזינו שם המקור שתזהו בקלות, למשל ״חשבונות תלמידים״.
3. בחרו נקודת קצה ב־Custom API.
4. הגדירו את מיפוי התשובה (JSON) בהתאם לתשובה האמיתית מהמערכת שלכם. הסעיף המתקדם בהמשך מסביר את השדה הזה.
5. בחרו הוספת מקור.
6. בדקו את שלושת המתגים בכרטיס המקור החדש.
7. השתמשו בנסו בעצמכם כדי לבדוק דוגמה מוכרת.

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

נסו בעצמכם: בדיקת חיפוש בלי לאמת לקוח

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

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

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

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

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

הגדרות

שימוש בתפקיד מדווח כתגית

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

איך אנשים מוכיחים מי הם: השיטות שפעילות תמיד

תחת איך אנשים מוכיחים מי הם, שתי השיטות מסומנות פעיל תמיד. אלו שורות מידע, לא מתגים.

שיטה	מה המשמעות ב־omotto	ברירת מחדל
מספר WhatsApp	omotto יכולה להשתמש במספר מאומת שמגיע מערוץ וואטסאפ כהוכחה לשליטה במספר. מספר שרק הוקלד בהודעה אינו אותה הוכחה.	פעיל תמיד.
קוד לטלפון או לאימייל	השלמה מוצלחת של אימות בקוד מוכיחה שליטה בטלפון או באימייל שאליו נשלח הקוד.	פעיל תמיד.

פעיל תמיד אומר שהשיטה זמינה. זה לא אומר שכל אדם כבר אומת, או ש־omotto שולחת קוד אוטומטית לכל מי שפונה. אף אחת מהשיטות לא מוכיחה לבדה שייכות למערכת העסק שלכם.

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

הגדרות כניסה עם חשבון בחנות

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

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

הגדרות מקור משתמשים מ־API מותאם

הגדרה	מה היא עושה	ערך התחלתי למקור שנוסף במסך הזה
שם המקור	נותן למקור שם שיופיע בכרטיס ובאזור הבדיקה. שינוי שם לא הופך לקוח למשתמש רשום.	השם שתזינו; שדה חובה.
נקודת קצה ב־Custom API	בוחרת את הפעולה שבודקת את המערכת שלכם.	ללא בחירה; חובה לבחור בהוספה.
מיפוי התשובה (JSON)	מגדיר אילו שדות בתשובה נחשבים להתאמה, למזהה משתמש, לתפקידים ולפרט קשר אפשרי.	הטופס מתחיל עם records_path: "users", ‏id_path: "id" ו־role_paths: ["roles"]. זו נקודת התחלה, לא מיפוי שהותאם אוטומטית למערכת שלכם.
פעיל	מאפשר להפעיל את המקור ולהשתמש בהתאמות שלו שעומדות בדרישות. כיבויו הופך את ההתאמות ללא זמינות לבדיקות שדורשות אותו.	פעיל אחרי שהוספת המקור הצליחה.
לחפש גם פרטים שאנשים מקלידים (לא מאומתים)	מאפשר לקבל תוצאות חיפוש לפי פרטים לא מאומתים כהתאמות אפשריות לשייכות. לא מוכיח מי האדם שמשוחח.	כבוי.
הטלפון/האימייל שלפיו מחפשים הוא פרטי ההתחברות או הקשר של האדם עצמו	מצהיר שפרט החיפוש שייך לבעל החשבון, ולא רק לאדם שמוזכר ברשומה שלו. כשהמתג פעיל, התאמה לפרט קשר שהוכח יכולה לבסס שייכות של אותו אדם. כשהוא כבוי, ההתאמה נשארת קשר אפשרי בלבד, גם אם השליטה בפרט הקשר הוכחה.	פעיל. ודאו שזה באמת נכון במערכת שלכם.

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

הסיכון לחשיפת מידע בחיפוש לפי פרטים לא מאומתים

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

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

מתי לכבות את ההצהרה שפרט הקשר שייך לבעל החשבון

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

הגדרה מתקדמת: מיפוי התשובה (JSON)

הסעיף הזה מיועד למי שמחבר את מערכת העסק. JSON הוא המבנה המסודר שבו החיבור מחזיר תשובה. לא צריך לכתוב אותו כדי להבין את ההגדרות היומיומיות. אם עוד לא הכנתם חיבור, התחילו בחיבורי API מותאם.

סוג הבקשה של נקודת הקצה לא קובע אם היא לקריאה בלבד; חיפוש ב־POST מותר כשהמתג מבצעת פעולה אמיתית כבוי והפעולה רק קוראת מידע.

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

אפשרות 1: רשימת רשומות משתמשים

לתשובה במבנה הבא:

{
  "users": [
    { "id": "member-123", "roles": ["student"], "email": "person@example.com" }
  ]
}

השתמשו במיפוי הזה:

{
  "records_path": "users",
  "id_path": "id",
  "role_paths": ["roles"],
  "contact_path": "email",
  "contact_kind": "email"
}

• records_path מצביע לרשימה. בתשובה עם כמה שכבות הוא יכול להיות, למשל, data.users.
• id_path מצביע למזהה המשתמש בתוך כל רשומה. הוא חובה כשמשתמשים ב־records_path.
• רשומה אחת בדיוק, עם מזהה תקין ולא ריק מסוג טקסט או מספר שלם, מחזירה התאמה.
• רשימה ריקה מחזירה אין התאמה. גם רשומה בודדת ללא מזהה תקין מחזירה אין התאמה.
• יותר מרשומה אחת מחזירה התאמה לא חד־משמעית. omotto לא בוחרת אחת בשבילכם.
• רשימה חסרה, או ערך שאינו רשימה, מחזירים לא זמין.

אפשרות 2: ערך מפורש שמציין שייכות

אם המערכת מחזירה תשובה ישירה, השתמשו ב־predicate במקום ב־records_path:

{
  "predicate": { "path": "membership.active", "equals": true },
  "id_path": "user.id",
  "role_paths": ["user.roles"]
}

הערך צריך להתאים בדיוק, כולל הסוג שלו. הערך הלוגי true אינו הטקסט "true". ערכי ההשוואה המותרים הם true, טקסט לא ריק או מספר שלם; לא false, רשימה או אובייקט. ערך שונה, כולל שדה חסר, מחזיר אין התאמה.

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

שדות המיפוי הנוספים

שדה	משמעות	ברירת מחדל אם לא מגדירים
role_paths	רשימת נתיבים לערכי תפקידים. כל נתיב יכול להחזיר ערך אחד או רשימה. טקסט שמתקבל שומר על אותיות גדולות וקטנות ועל תווים בעברית; מספרים שלמים הופכים לטקסט. omotto לא ממירה את הערכים לתפקידים משלה. ראו את המגבלות בהמשך.	לא מדווחים תפקידים.
contact_path	נתיב רשות לפרט הקשר ששמור במערכת שלכם. בנסו בעצמכם הוא מוצג מוסתר חלקית. הוא לא מוכיח שליטה בפרט הקשר.	ללא פרט קשר.
contact_kind	חובה עם contact_path: הזינו phone או email. אין להגדיר אותו בלי נתיב לפרט קשר.	ללא סוג פרט קשר.

השתמשו בדיוק באחד מהשדות records_path ו־predicate. נקודות מפרידות בין שדות בשכבות שונות; אפשר לציין מיקום מסוים ברשימה, למשל users[0].id, אבל לא להשתמש בתו כללי כמו [*]. שדות מיפוי לא מוכרים נדחים.

התשובה צריכה להיות JSON תקין והבקשה צריכה להצליח. בקשה שנכשלה או תשובה שלא ניתן לקרוא מחזירות לא זמין, ולא מוכיחות שאדם אינו משתמש רשום.

ערכי תפקידים צריכים להיות טקסט לא ריק או מספרים שלמים. טקסט ריק, ערכים לוגיים, אובייקטים וסוגי ערכים אחרים לא מתקבלים. גם טקסט ארוך מ־100 תווים או טקסט שמכיל תו אפס (\u0000) לא מתקבל. המגבלות האלה חלות גם כשהחיפוש מחזיר התאמה.

ערכי תפקידים שנצפו

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

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

בחירה למי מותר להשתמש בפעולה

במדריך, פתחו את הכלל של היכולת תחת מה [שם העוזר] עושה כש…, ואז למי זה מיועד. בדקו את שורת אימות נדרש. יכולות כבויות נשארות ברשימה, אבל בקרות האימות שלהן הן לקריאה בלבד. עבור פגישות, לחצו על מעבר לקביעת תורים כדי לערוך את מאשרי החריגות; הכלל של היכולת מציג את הקבוצה אך אינו עורך אותה.

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

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

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

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

פרטים שהלקוח מציע בשיחה וקוד לפרט קשר שמור

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

פרופילים תואמים בדף הלקוח

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

מה קורה כש…

לקוח יוצא מהחשבון או שאדם אחר נכנס באותו מכשיר

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

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

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

שיניתם ב-Shopify את הנתיב של ה-App Proxy

ה־App Proxy הוא הנתיב שדרכו Shopify מעבירה את הבדיקה הזאת ל־omotto. שינוי שם הנתיב אינו נתמך ב־omotto. החזירו את הנתיב המקורי בעזרת מי שמתחזק את החנות, או פנו לתמיכה. אימות בקוד נשאר זמין, אך לא מחזיר שיחה של חשבון קודם אחרי שהצ׳אט עבר לזהות חדשה. אל תכבו את דרישת האימות של הפעולה כדי לעקוף בדיקה חסרה.

לקוח משלים אימות

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

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

לקוח מאומת עדיין לא מקושר לחשבון בחנות

אם פעולה דורשת התאמה למשתמש Shopify אבל הלקוח המאומת עדיין לא מקושר לחשבון בחנות, omotto מבצעת בדיקה אוטומטית אחת ברקע לפי הטלפון או האימייל המאומתים שלו. הפעולה ממתינה לבדיקה ואז מוצעת שוב. אם לא ניתן לקשר חשבון, הלקוח עדיין לא עומד בדרישה; עצם הבדיקה לא מעניקה הרשאה. בדיקה שנכשלה לא אומרת שצריך להמשיך לאמת שוב ושוב את אותו פרט.

ללקוח בוואטסאפ אין מספר טלפון זמין

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

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

מוסיפים מקור כשכבר יש לקוחות

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

מכבים, עורכים או מוחקים מקור API מותאם

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

פתרון בעיות

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

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

ראו גם

• למי זה מיועד: קהל ואימות

• רמות אימות, התאמות ובחירת שם הלקוח

• פרופילים של לקוחות

• קישור פרופילים של לקוחות

• חיבור Shopify

• חיבורי API מותאם

• קלטים ובטיחות של נקודת קצה

• הרשאות