פתרון בעיות באינטגרציה

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

התחילו בבדיקות האלה

1. בדקו היכן הכשל מתרחש. האם ה-Agent אינו יכול להשתמש בשירות ב-Chat, או שהתכונה נכשלת רק באפליקציה שלכם? חיבור שירות עבור Chat אינו מאשר בפני עצמו שהאפליקציה שלכם מוגדרת כראוי. לכשלים שמתרחשים רק באפליקציה, ראו חיבור וניהול אינטגרציות.
2. פתחו את האינטגרציה. ב-Chat של הפרויקט שלכם, פתחו את תפריט האפשרויות לצד שדה הזנת ההודעה, ואז בחרו Connectors → Add connectors. חפשו ובחרו את השירות. בדקו אם הוא מחובר או שעדיין מוצגת האפשרות התחבר. חלק מהשירותים פותחים מסך ניהול משלהם.
3. בדקו את הגישה בתוך השירות עצמו. אשרו שהחשבון שהתכוונתם לחבר יכול לפתוח את הקובץ, המאגר, היומן, הנכס או משאב אחר המעורב בתהליך.
4. שמרו את השגיאה לפני שאתם משנים משהו. תעדו את ההודעה המדויקת, השעה ואזור הזמן, הפרויקט או ה-Chat שהושפעו, ואת הניסיון האחרון שהצליח. השחירו מידע פרטי מצילומי מסך.

פתחו את אפשרויות הקלט של Chat, בחרו Connectors (1), ואז Add connectors (2) כדי לעיין באינטגרציות הזמינות.

אפשר גם לנהל חיבורים זמינים ב- Settings → Connectors. בחרו את האינטגרציה שברצונכם לבדוק.

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

מצאו את הבעיה שלכם

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

אינכם יכולים למצוא או להתחיל אינטגרציה

1. השתמשו ב- Add connectors כדי לחפש בקטלוג. הרשימה הקצרה יותר בתפריט Chat אינה הקטלוג המלא.
2. אם Atoms מציין שהתכונה זמינה רק בתוך פרויקט, פתחו את הפרויקט המיועד ונסו שם.
3. אם פקד מושבת, קראו את ההסבר שלו. אם נדרש תפקיד או הרשאה אחרים, בקשו מבעל הפרויקט או סביבת העבודה לעזור. אל תנתקו שירות אחר רק כדי לעקוף הגבלה.

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

ההרשאה אינה מסתיימת

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

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

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

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

החשבון הלא נכון מחובר

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

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

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

האינטגרציה מחוברת, אבל ה-Agent לא יכול למצוא את הנתונים שלכם

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

לדוגמה, אם המחבר תומך בקריאת מסמכים: "השתמשו ב- [service] כדי לקרוא את [document name or link] ותגידו לי מה הכותרת שלו. אל תשנו אותו."

בדקו את התוצאה: ה-Agent מחזיר את המשאב המיועד. אם גישה ישירה עובדת אבל ה-Agent עדיין לא יכול לקרוא אותו, בדקו את היכולות הנתמכות של המחבר ואת הגישה שניתנה. התחברו מחדש רק אם יש ראיה לבעיית הרשאה.

ה-Agent יכול לקרוא נתונים, אבל לא יכול לשנות אותם

קריאה מוצלחת אינה מאשרת שהמחבר תומך בשינוי המבוקש או שיש לו הרשאה לבצע אותו.

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

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

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

חיבור שעבד קודם הפסיק לעבוד

בדקו מה השתנה מאז הבקשה האחרונה שהצליחה: החשבון, הגישה שלו למשאב, מדיניות האפליקציות של הארגון או ההרשאה של החיבור.

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

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

התוצאות אינן מעודכנות או שבקשה ממשיכה להיכשל

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

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

התחברו מחדש בבטחה

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

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

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

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

ודאו שהבעיה נפתרה

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

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

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

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

קבלו עזרה

אם הבעיה נמשכת, השתמשו ב- קבלו תמיכה וכוללו:

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

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