במדריך הזה מוסבר איך לספק את המידע הדרוש לפתרון בעיות ב-RBM.
לא ניתן לשלוח הודעות RBM
כדי שנוכל לפתור את הבעיה מהר יותר, כדאי לשתף כמה שיותר מהפרטים הבאים:
- דוגמאות למזהי הודעות עם חותמות זמן
- מספר השותף (צילום מסך)
- מספר הנציגים שהושפעו
- מזהי סוכנים (מופרדים בפסיקים)
- מספר ההודעות המשוער שהושפעו או שייתכן שהושפעו
- שיטות ה-API שבהן נתקלת בבעיות (לדוגמה: העלאת קבצים, יצירת הודעה לנציג מהמשתמש, יצירת אירוע לנציג מהמשתמש, מחיקה של הודעה לנציג מהמשתמש, אחזור יכולות, אחזור באצווה)
- דוגמה למטען ייעודי (payload) של JSON של בקשות שנכשלו
- לבעיות שקשורות ללקוח: דוח באגים של לקוח
יומני שגיאות (שגיאות שמוצגות במסוף כשקוראים לממשקי ה-API של RBM), כולל קוד השגיאה והודעת השגיאה. לדוגמה:
"error": { "code": 403, "message": "There was an error looking up the RBM agent (ID: my-test-agent@rbm.goog) that corresponds to the Google Cloud Platform (GCP) project you're authenticating with.", "status": "PERMISSION_DENIED", }
זמן האחזור לביצוע פעולות של RBM
חשוב לזכור לבדוק קודם את הדברים הבאים:
| שאלה | המלצה |
|---|---|
האם זמן האחזור הוא <5s? |
אם כן, הנתון הזה נמצא בטווח הקביל. |
| האם הייתה נסיגה בזמן האחזור? | אם כן, מתי זה התחיל? מה הייתה זמן האחזור הממוצע בעבר בהשוואה לזמן האחזור הנוכחי? |
| האם אתם משתמשים ב-API להעלאת קבצים? | כדאי לנסות להשתמש במזהי קבצים במקום לשלוח כתובות URL ישירות. עיבוד כתובות URL חדשות של מדיה כולל הורדה, עיבוד, תמונות ממוזערות, הגנה מפני ניצול לרעה והגנה מפני וירוסים – והשלב האחרון נמשך כ-50% מהזמן. |
| האם העליתם מראש את המדיה של ההודעה? | כדי לזרז את העיבוד, מומלץ לעשות זאת באמצעות קריאת ה-API הבאה: https://developers.google.com/business-communications/rcs-business-messaging/reference/rest/v1/files/create |
| האם הרצת בדיקות יכולות? | כדי לצמצם את זמן האחזור בשליחת הודעות למשתמשים שלא ניתן להגיע אליהם באמצעות RCS, מומלץ להריץ קודם בדיקות יכולות. |
אם הבעיה נמשכת, עליך לספק כמה שיותר פרטים נוספים כדי שנוכל לפתור אותה מהר יותר:
- מספר ההודעות שהושפעו
- מקור זמן האחזור (לדוגמה: העלאת קבצים, יצירת הודעה מנציג למשתמש, יצירת אירוע מנציג למשתמש, מחיקה של הודעה מנציג למשתמש, אחזור יכולות, אחזור באצווה)
- נקודת קצה של שירות
- התפלגות זמני האחזור (p50, p95, p99)
- שינוי זמן האחזור ומסגרת הזמן
- מזהה השותף
- מזהי הנציגים המושפעים
- מזהי הודעות עם חותמות זמן
- מטען ייעודי (payload) של JSON
לא מתקבלים אירועים או הודעות ב-webhook
כדי לוודא שההודעות מועברות בצורה חלקה, צריך לוודא שכל ה-webhooks של הנציג בחשבון השותף פועלים בצורה תקינה ויכולים לעבד הודעות מ-Google. כל הנציגים בחשבון שותף משתפים ערוץ אחד להודעות ולאירועים נכנסים, ולכן קוד webhook שפגום עלול לשבש את השליחה לכל הנציגים.
אם הבעיה נמשכת, עליך לשתף את הפרטים הבאים כדי שנוכל לפתור אותה מהר יותר:
- מתי הבעיה התחילה? האם קיבלת הודעות ואירועים לפני כן?
- מזהה השותף
- מזהי סוכנים
- כתובת URL של Webhook
- מזהי הודעות עם חותמות זמן
בעיות ברינדור של קרוסלה וכרטיסים מתקדמים
דוגמאות לבעיה הזו כוללות כשל טעינה, הצגת מסך שחור, חיתוך וחוסר הצגה של הצעות לפעולות.
כדי שנוכל לפתור את הבעיה מהר יותר, כדאי לשתף כמה שיותר מהפרטים הבאים:
- מזהי הודעות עם חותמות זמן
- מטען ייעודי (payload) של JSON
- השלבים לשחזור הבעיה במכשיר, אם הם ידועים
- דוח איתור באגים מהמכשיר שמקבל את ההודעות
- פרטים על המכשיר ועל גרסת אפליקציית ההודעות שבה נעשה שימוש
- צילום מסך או הקלטת וידאו של הבעיה
הודעות RBM שנשלחות כ-JSON או מועברות ל-SMS
כדי שנוכל לפתור את הבעיה מהר יותר, כדאי לשתף כמה שיותר מהפרטים הבאים:
- מזהי הודעות עם חותמות זמן
- מטען ייעודי (payload) של JSON
- השלבים לשחזור הבעיה במכשיר, אם הם ידועים
- דוח איתור באגים מהמכשיר שמקבל את ההודעות
- פרטים על המכשיר ועל גרסת אפליקציית ההודעות שבה נעשה שימוש
- צילום מסך או הקלטת וידאו של הבעיה
יצירת כתובת URL או קוד QR של P2A נכשלה
כדי שנוכל לפתור את הבעיה מהר יותר, כדאי לשתף כמה שיותר מהפרטים הבאים:
- מזהה הנציג
- פרטים על שגיאת ה-JavaScript שמוצגת ב-Business Communications Developer Console
לא ניתן לפתוח קישור עומק של RBM
כדי שנוכל לפתור את הבעיה מהר יותר, כדאי לשתף כמה שיותר מהפרטים הבאים:
- מזהה הנציג
- מספר טלפון
- השלבים לשחזור הבעיה (אם הם ידועים)
- דוח על באג (מהמכשיר שבו הקישור נפתח)
- צילום מסך או הקלטת וידאו של הבעיה
אי אפשר לקבל הודעות במכשיר עם תמיכה ב-RCS
כדי שנוכל לפתור את הבעיה מהר יותר, כדאי לשתף כמה שיותר מהפרטים הבאים:
- דוח על באג מהמכשיר שלא קיבל את הודעות ה-RBM
- מספר טלפון
- פרטים על המכשיר ועל מערכת ההפעלה
- גרסת האפליקציה להעברת הודעות שבה נעשה שימוש
- השלבים לשחזור הבעיה (אם הם ידועים)
- צילום מסך שבו מוצג סטטוס השימוש ב-RCS
- צילום מסך או הקלטת וידאו של הבעיה
- שם הספק והמדינה
לא ניתן להוסיף בודק
פועלים לפי השלבים המפורטים במאמר הגדרת מכשיר בדיקה.
אם הבעיה נמשכת, עליך לשתף את הפרטים הבאים כדי שנוכל לפתור אותה מהר יותר:
- מזהה הנציג
- מספר טלפון
- שם הספק והמדינה
המכשיר לבדיקה לא מקבל הודעות או הזמנות מבדיקים
פועלים לפי השלבים המפורטים במאמר הגדרת מכשיר בדיקה.
אם הבעיה נמשכת, אפשר לשתף את הפרטים הבאים כדי שנוכל לפתור אותה מהר יותר:
- מזהה הנציג
- מספר טלפון
- מזהה הודעה עם חותמת זמן
- דיווח על באג תוך 5 דקות ממועד שליחת ההזמנה לבדיקה
בעיות בבדיקות היכולות
כדי שנוכל לפתור את הבעיה מהר יותר, עליך לשתף את הפרטים הבאים:
- רשימה של מספרי טלפון עם קודי מדינות בקובץ CSV
- מזהי סוכנים
- יומני שגיאות
- סטטוס ה-RCS במכשיר
מידע חסר בדוחות של אירועי חיוב
כדי שנוכל לפתור את הבעיה מהר יותר, עליך לשתף את הפרטים הבאים:
- התאריכים שבהם הקבצים חסרים
- מזהי סוכנים
הספק לא יכול לאשר השקות של סוכנים
מדווחים על הבעיה דרך מסוף הניהול של RBM (ראו צילום מסך).
להשקות דחופות, יש לציין את הפרטים הבאים:
- שם הספק והמדינה
- מזהה הנציג שרוצים להפעיל
- הרשאה מהספק להשקת המוצר
שליחת בקשה לעדכון פרטי הנציג
כדי לקבל עדכונים מהר יותר, עליך לשתף את הפרטים הבאים:
- מזהה הנציג
- פרטי המטא-נתונים שרוצים לעדכן (לדוגמה: שם, לוגו, באנר, תיאור, פרטים ליצירת קשר, קישור למדיניות הפרטיות או קישור לתנאים ולהגבלות)
שליחת בקשה להעברת סוכנים לחשבון שותף אחר
כדי לקבל עדכונים מהר יותר, עליך לשתף את הפרטים הבאים:
- רשימת מזהי סוכנים
- מזהה השותף הישן
- מזהה שותף חדש