במדריך הזה מוסבר איך לספק את המידע הדרוש לפתרון בעיות ב-RBM.
בעיות בשליחת הודעות ובפורמט שלהן
אלה בעיות שקשורות לשידור ולקבלה של הודעות בפועל, כולל בעיות בפורמט של ההודעות.
אי אפשר לשלוח הודעות RBM
כדי שנוכל לפתור את הבעיה מהר יותר, מומלץ לשתף כמה שיותר מהפרטים הבאים:
- דוגמאות למזהי הודעות עם חותמות זמן
- מספר השותף (ראו צילום מסך)
- מספר הנציגים שהושפעו
- מזהי סוכנים (מופרדים בפסיקים)
- מספר משוער של הודעות שהושפעו או עשויות להיות מושפעות
- שיטות API שנתקלת בהן בבעיות (לדוגמה: העלאת קבצים, יצירת הודעה מסוכן למשתמש, יצירת אירוע מסוכן למשתמש, מחיקת הודעה מסוכן למשתמש, קבלת יכולות, קבלת נתונים בכמות גדולה)
- דוגמה למטען ייעודי (payload) של JSON של בקשות שנכשלו
- לבעיות בלקוח: דוח באגים בלקוח
יומני שגיאות (שגיאות שמופיעות במסוף כשמתקשרים אל ממשקי ה-API של RBM), כולל קוד השגיאה והודעת השגיאה. לדוגמה:
"error": { "code": 403, "message": "There was an error looking up the RBM agent (ID: [email protected]) that corresponds to the Google Cloud Platform (GCP) project you're authenticating with.", "status": "PERMISSION_DENIED", }לא מתקבלים אירועים או הודעות ב-webhook
כדי שההודעות יועברו בצורה חלקה, צריך לוודא שכל ה-webhook של הנציגים בחשבון השותף פועלים בצורה תקינה ויכולים לעבד הודעות מ-Google. כל הנציגים בחשבון שותף חולקים ערוץ אחד להודעות ולאירועים נכנסים, ולכן webhook שלא פועל יכול לשבש את המסירה של כל הנציגים.
אם הבעיה נמשכת, כדאי לשתף את הפרטים הבאים כדי שנוכל לפתור אותה מהר יותר:
- מתי הבעיה התחילה? האם קיבלתם הודעות ואירועים בהצלחה לפני כן?
- מזהה השותף
- מזהי סוכנים
- כתובת URL של Webhook
- מזהי הודעות עם חותמות זמן
הודעות RBM שנשלחות כ-JSON או מומרות ל-SMS
כדי שנוכל לפתור את הבעיה מהר יותר, מומלץ לשתף כמה שיותר מהפרטים הבאים:
- מזהי הודעות עם חותמות זמן
- מטען ייעודי (payload) של JSON
- שלבים לשחזור הבעיה במכשיר, אם ידועים
- דוח איתור באגים מהמכשיר שמקבל את ההודעות
- פרטים על המכשיר ועל גרסת אפליקציית ההודעות שבה נעשה שימוש
- צילום מסך או הקלטת מסך של הבעיה
לא ניתן לקבל הודעות במכשיר עם RCS
כדי שנוכל לפתור את הבעיה מהר יותר, מומלץ לשתף כמה שיותר מהפרטים הבאים:
- דוח איתור באגים מהמכשיר שלא מצליח לקבל את ההודעות של RBM
- מספר טלפון
- פרטים על המכשיר ומערכת ההפעלה
- הגרסה של האפליקציה להעברת הודעות שבה נעשה שימוש
- השלבים לשחזור הבעיה (אם הם ידועים)
- צילום מסך שבו מוצג סטטוס השימוש ב-RCS
- צילום מסך או הקלטת מסך של הבעיה
- שם הספק והמדינה
בעיות בהגדרה או בקישוריות של לקוחות ומכשירים
הבעיות האלה כוללות בעיות בהגדרה, בחיבור ובפלטפורמה הספציפית בצד הלקוח.
יצירת כתובת URL או קוד QR של P2A נכשלה
כדי שנוכל לפתור את הבעיה מהר יותר, מומלץ לשתף כמה שיותר מהפרטים הבאים:
- מזהה הנציג
- פרטים על שגיאת JavaScript שמופיעה ב-Business Communications Developer Console
אי אפשר לפתוח קישור עמוק ב-RBM
כדי שנוכל לפתור את הבעיה מהר יותר, מומלץ לשתף כמה שיותר מהפרטים הבאים:
- מזהה הנציג
- מספר טלפון
- השלבים לשחזור הבעיה (אם הם ידועים)
- דוח איתור באגים מהמכשיר שבו נפתח הקישור
- צילום מסך או הקלטת מסך של הבעיה
בעיות בבדיקות היכולות
כדי לפתור את הבעיה מהר יותר, כדאי לשתף את הפרטים הבאים:
- רשימה של מספרי טלפון עם קידומות מדינה בקובץ CSV
- מזהי סוכנים
- יומני שגיאות
- סטטוס RCS של המכשיר
- התאריך והשעה של הבדיקה שבוצעה
מכשיר הבדיקה לא מקבל הזמנה לבדיקה או הודעות
פועלים לפי השלבים שמפורטים במאמר בנושא הגדרת מכשיר בדיקה.
אם הבעיה נמשכת, כדאי לשתף את הפרטים הבאים כדי שנוכל לפתור אותה מהר יותר:
- מזהה הנציג
- מספר טלפון
- מזהה ההודעה עם חותמת הזמן
- דיווח על באג תוך 5 דקות משליחת ההזמנה לבדיקה
בעיות ב-RCS/RBM במכשירי iOS
אפל אמנם אימצה את התקן של שירותי תקשורת מגוונים (RCS) להעברת הודעות, אבל בחרה לפתח הטמעה ייחודית משלה. זה כולל תכונות כמו RCS Business Messaging (RBM).
אם נתקלתם בבעיות ב-RBM במכשיר iOS, מומלץ לדווח עליהן ישירות ל-Apple באמצעות אפליקציית Feedback Assistant. כך תוכלו לעזור ל-Apple לזהות ולפתור בעיות שספציפיות להטמעה שלה.
- פותחים את אפליקציית Feedback Assistant במכשיר iOS.
- בוחרים נושא התחלתי מתאים שקשור לבעיות באפליקציית הודעות.
- כותבים את המשוב ושולחים אותו.
- כדי שצוות התמיכה של RBM יהיה מעודכן, חשוב גם לשתף איתנו את הממצאים. אנחנו מעריכים את העזרה שלכם בשיפור חוויית השימוש ב-RCS לכולם.
הזמינות של RCS/RBM במכשירי iOS
ל-Apple יש בחירה משלה של ספקי סלולר להשקת RCS/RBM ב-iOS. כדי לברר לגבי הזמינות הגלובלית או התוכניות העתידיות של Apple, צריך לפנות ישירות אל Apple. אפשר גם לפנות לספק הסלולר שמעניין אתכם כדי לברר מה סטטוס ההשקה של RCS/RBM ב-iOS.
מידע על תמיכה בתכונות של אייפון על ידי ספקי סלולר במדינות שונות זמין בדף התמיכה של Apple.
בעיות בביצועים ובתצוגה
אלה בעיות בביצועים ובתצוגה של RBM.
זמן אחזור בביצוע פעולות ב-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
בעיות בעיבוד של קרוסלה וכרטיס מתקדם
דוגמאות לבעיה הזו כוללות טעינה שנכשלה, הצגת מסך שחור, חיתוך והצעות לפעולות שלא מופיעות.
כדי שנוכל לפתור את הבעיה מהר יותר, מומלץ לשתף כמה שיותר מהפרטים הבאים:
- מזהי הודעות עם חותמות זמן
- מטען ייעודי (payload) של JSON
- שלבים לשחזור הבעיה במכשיר, אם ידועים
- דוח איתור באגים מהמכשיר שמקבל את ההודעות
- פרטים על המכשיר ועל גרסת אפליקציית ההודעות שבה נעשה שימוש
- צילום מסך או הקלטת מסך של הבעיה
בעיות בניהול חשבונות, סוכנים וספקים
אלה בעיות שקשורות לניהול החשבון ולדיווח, כולל שאלות לגבי חיובים.
אי אפשר להוסיף בודק
פועלים לפי השלבים שמפורטים במאמר בנושא הגדרת מכשיר בדיקה.
אם הבעיה נמשכת, כדאי לשתף את הפרטים הבאים כדי שנוכל לפתור אותה מהר יותר:
- מזהה הנציג
- מספר טלפון
- שם הספק והמדינה
הספק לא יכול לאשר הפעלה של סוכנים
מדווחים על הבעיה ממסוף הניהול של RBM (ראו צילום מסך).
במקרים דחופים, צריך לספק את הפרטים הבאים:
- שם הספק והמדינה
- מזהה הנציג להפעלת השיחה
- אישור של הספק להפעלת השירות
בקשה לעדכן את פרטי הנציג
כדי לקבל עדכונים מהירים יותר, צריך לשתף את הפרטים הבאים:
- מזהי סוכנים
- הפרטים שרוצים לשנות
- האישור שלכם לביטול ההשקה של הסוכן
צוות התמיכה של RBM יבטל את ההשקה של הנציג בשדות הבאים. אחרי כן תוכלו לבצע שינויים בנציג ולשלוח אותו מחדש להשקה.
- השם המוצג
- תיאור
- צבע
- תמונות של לוגו ובאנר
- פרטים ליצירת קשר עם הסוכן, כמו מספר טלפון, אתר וכתובת אימייל
- פרטיות ותנאים והגבלות
במקרה של השדות הבאים, צוות התמיכה של RBM יבטל את ההשקה של הנציג וישנה את השדות (שותפי RBM לא יכולים לשנות את השדות האלה ישירות):
- קטגוריית חיוב
- תרחיש לדוגמה
- שם המותג
- השם של איש הקשר בחברה
- מזהה האימייל של איש הקשר בחברה
- כתובת האתר של החברה
- שם איש הקשר של שותף הצ'אט
- כתובת האימייל ליצירת קשר עם שותף הצ'אט
אם רוצים לשנות את פרטי הנציג בלי להפסיק את הפעלת הנציגים, צריך לקבל אישור באימייל מאנשי קשר ברשתות שמנוהלות על ידי הספק שבהן הנציג מופעל כרגע. אחרי שאוספים את כל האימיילים לאישור, משתפים אותם עם צוות התמיכה של RBM, יחד עם הפרטים של השינויים הנדרשים.
צוות התמיכה של RBM יאמת את האישורים, ואם הכול תקין, יבצע את השינויים ויאשר אותם מולכם ומול הספקים הרלוונטיים. הערה: התהליך הזה עשוי להשתנות בהתאם לנהלים של ספקי סלולר שונים במדינות שונות.
בקשת שינויים בחשבון שותף ב-RBM
אם לשותף RBM יש נציגים שהופעלו ברשתות שמנוהלות על ידי ספקי סלולר, צריך לבצע את השלבים הבאים:
- לקבל אישורי אימייל מאנשי קשר ברשתות שמנוהלות על ידי ספקי תקשורת, שבהן סוכנים שלכם מופעלים.
- צריך לשתף את הפרטים הבאים עם התמיכה של RBM:
- מזהה שותף RBM
- הפרטים שרוצים לשנות
אחרי שצוות התמיכה של RBM יאמת את האישורים והפרטים, הוא יודיע לחברות הסלולר על השינויים שממתינים לאישור. השינויים האלה יוטמעו ויאושרו תוך 24 שעות ממועד קבלת ההודעה מחברת התובלה.
בקשה להעברת נציג משותף RBM א' לשותף ב'
אם הנציג כבר הופעל ברשתות שמנוהלות על ידי הספק, פועלים לפי השלבים הבאים:
- קבלת אישורים באימייל מאנשי הקשר של המותג ומאנשי קשר ברשתות שמנוהלות על ידי הספק.
- חשוב לוודא ששותף ה-RBM החדש יקבל עותק של הודעות האישור האלה.
- צריך לשתף את הפרטים הבאים עם התמיכה של RBM:
- מזהי סוכנים
- אישורים באימייל מאנשי הקשר בחברה ומספקי הסלולר
- מזהה שותף חדש
אחרי שצוות התמיכה של RBM יאמת את האישורים והפרטים, הוא יודיע לחברות הסלולר על השינויים שממתינים לאישור. השינויים האלה יוטמעו ויאושרו תוך 24 שעות ממועד קבלת ההודעה מחברת התובלה.
בקשה להעברת סוכנים לחשבון שותף אחר
כדי לקבל עדכונים מהירים יותר, צריך לשתף את הפרטים הבאים:
- רשימת מזהי סוכנים
- מזהה השותף הישן
- מזהה שותף חדש
חסר מידע בדוחות על אירועים שקשורים לחיוב
כדי לפתור את הבעיה מהר יותר, כדאי לשתף את הפרטים הבאים:
- תאריכים שבהם חסרים קבצים
- מזהי סוכנים