אנו נתקלים באופן קבוע במצבים שבהם לאחר הטמעת Bitrix24, התראות דחיפה בנייד אינן עובדות. לקוחות מקבלים תלונות מעובדים: הודעות צ'אט חסרות, משימות מוחמצות, התראות לידים מגיעות באיחור.
לרוב, הבעיה טמונה במפתחות Firebase Cloud Messaging (FCM) שגויים עבור Android או בתעודות Apple Push Notification Service (APNs) עבור iOS. אנו מטפלים בהגדרה זו מקצה לקצה ופותרים תקלות בתוך 1–2 ימים.
השירות שלנו costs calculated after audit בהתאם למורכבות, וחוסך לעסקים עד 5% מההכנסה על ידי מניעת לידים מוחמצים.
כיצד פועלת מסירת התראות Push
Bitrix24 משתמש במודול mobile ובשירות push.bitrix24.com כמתווך Push ביניים. שרת ה-Bitrix24 שלך שולח אירוע אל push.bitrix24.com, אשר יוצר לאחר מכן בקשה אל FCM או APNs, ולבסוף ההתראה מגיעה אל המכשיר.
זה חשוב: אם ה-Bitrix24 שלך מותקן באופן מקומי (on-premise) ומאחורי חומת אש, המתווך חייב להיות מסוגל להגיע אל השרת שלך דרך API.
עבור Bitrix24 מותקן באופן מקומי (on-premise), השרשרת נראית כך:
- אירוע בפורטל (הודעה חדשה, משימה, ליד) → טריגר במודול
mobile - בקשה אל
https://push.bitrix24.com/pub/עם אסימון המכשיר ו-payload - מתווך → FCM/APNs → המכשיר של המשתמש
אסימוני מכשיר (device tokens) נשמרים בטבלת b_mobile_device. כאשר האפליקציה מותקנת מחדש, האסימון משתנה, והאסימון הישן מסומן כלא תקף לאחר התגובה הכושלת הראשונה מ-FCM/APNs.
מדוע התראות דחיפה (push) לא מגיעות: סיבות אופייניות
- אי-התאמה במפתח Firebase. Bitrix24 עד גרסה 22.x משתמש ב-Legacy API — מפתח כמו
AAAAxxxxxxx:APA91b.... החל מגרסאות חדשות יותר של המודולmobile, נתמך FCM HTTP v1 API באמצעות אסימון OAuth2 מחשבון שירות. אם שדרגתם אך השארתם את המפתח הישן, ה-push מפסיק לעבוד. אנו ממליצים להגדיר FCM v1 מיד — זה אמין יותר ולא ידרוש עדכוני מפתח בעתיד. - תעודות Apple APNs. Apple משתמשת בשני מנגנוני אימות: תעודות
.p12ומפתחות.p8(אימות מבוסס אסימון). תעודות פגות תוקף לאחר שנה — סיבה אופיינית לכשל פתאומי ב-push ב-iOS. למפתחות.p8אין תפוגה, ולכן אנו ממליצים עליהם. כדי ליצור מפתח.p8: Apple Developer Console → Certificates, Identifiers & Profiles → Keys → צרו מפתח עם הדגל Apple Push Notifications service (APNs). ניתן להוריד אותו רק פעם אחת.
השוואה בין Legacy ל-FCM v1 עבור Bitrix24
| היבט | FCM Legacy API | FCM HTTP v1 |
|---|---|---|
| תמיכה ב-Bitrix24 | עד גרסה 22.x | החל ממודול mobile 22.x |
| סוג מפתח | Static Server Key | אסימון OAuth2 מחשבון שירות |
| תוקף מפתח | ללא הגבלה | האסימון מתרענן אוטומטית |
| אבטחה | נמוכה (המפתח יכול להיות נחשף בקלות) | גבוהה (הרשאות מוגבלות) |
| המלצה | רק לגרסאות ישנות | לכל הפרויקטים החדשים |
FCM HTTP v1 טוב יותר מ-Legacy API מבחינת אבטחה ואינו דורש חידוש מפתח ידני. אנו מעבירים לקוחות ל-v1 כחלק מהגדרת ה-push.
כיצד לאבחן כשלים בהתראות דחיפה
אם הדחיפה אינה פועלת, יש לבדוק תחילה את הטבלה b_push_queue. אם מצטברים רשומות שלא עובדו, הסוכן \Bitrix\Push\QueueAgent אינו פועל. יש להגדיר cron עבור סוכנים. סיבה נפוצה נוספת היא כתובת פורטל חיצונית שהוגדרה באופן שגוי בהגדרות on-premise. יש לוודא ש-push.bitrix24.com יכול להגיע לשרת שלך.
פרטים טכניים להגדרת FCM v1
- יש ליצור פרויקט ב-Firebase Console.
- יש להוסיף חשבון שירות בהגדרות הפרויקט (IAM & Admin → Service Accounts).
- יש להוריד את מפתח ה-JSON.
- ב-Bitrix24: Administration → Mobile App → Push Notifications → יש לבחור FCM HTTP v1, ולהעלות את ה-JSON.
- יש לבדוק עם התראת בדיקה.
מה כלול בהגדרת התראות Push?
- הגדרה מלאה של FCM (Legacy או v1) עבור Android
- הגדרה מלאה של APNs (certificate או מפתח
.p8) עבור iOS - בדיקה והגדרה של push broker עבור on-premise
- פתרון בעיות אופייניות (כפילויות, היעדר push, עיכובים)
- הוראות למנהל לחידוש certificate
- חודש תמיכה לאחר המסירה
- תיעוד של כל ההגדרות לעיון עתידי
זמן משוער: מיום 1 עד 3 ימים בהתאם למורכבות התצורה. העלות מחושבת בנפרד לאחר ביקורת.
אבחון תקלות אופייניות
במהלך האבחון, אנו נתקלים לעתים קרובות במצבים הבאים. אם התראות Push אינן מגיעות רק ב-iOS, בדקו תחילה את תאריך התפוגה של האישור. פתחו את Keychain Access, מצאו את האישור Apple Push Services: com.your.bundleid — הסתכלו על תאריך התפוגה. אם פג תוקף — צרו מחדש דרך Apple Developer Portal והעלו מחדש ל-Bitrix24.
אם התראות Push אינן מגיעות גם ב-Android וגם ב-iOS לאחר העברת שרת, ייתכן שהפורטל שינה את הדומיין או כתובת ה-IP שלו, אך push.bitrix24.com עדיין אינו יודע את הכתובת החדשה. בהגדרות הרישום של on-premise, ודאו שכתובת הפורטל החיצונית נכונה ונגישה מבחוץ.
התראות כפולות מתרחשות כאשר משתמש מתחבר ממספר מכשירים — מספר טוקנים פעילים ב-b_mobile_device. זה תקין, אך אם הכפילויות מתרבות ללא הפסקה, ייתכן שהאפליקציה רושמת טוקן חדש בכל הפעלה במקום לעדכן את הקיים.
בדקו את תור השליחה: אם השורות ב-b_push_queue אינן מתמעטות, הסוכן \Bitrix\Push\QueueAgent אינו פועל. בדקו את cron.
הערה: התראות Push מגיעות למשתמשים מהר יותר עם FCM v1 בהשוואה ל-Legacy, במיוחד תחת עומס גבוה בצ'אטים ובמשימות.
לפרטים נוספים, ראו את התיעוד הרשמי: Push Notifications in Mobile App.
השוואה בין שיטות אימות APNs
| אימות | תוקף | מורכבות ההגדרה | המלצה |
|---|---|---|---|
| תעודת .p12 | שנה אחת | בינונית | רק אם כבר בשימוש |
| מפתח .p8 (טוקן) | ללא הגבלה | נמוכה | מומלץ לכל הפרויקטים |
הגדרנו התראות פוש ביותר מ-200 פורטלים של Bitrix24 במהלך 5 שנים. אנחנו שותף מוסמך של Bitrix24 עם איכות מובטחת. התראות שאינן פועלות עלולות לעלות לעסק עד 5% מההכנסות בגלל לידים שהוחמצו ותקשורת מעוכבת. הגדרת התראות פוש מחזירה את ההשקעה בתוך שבוע על ידי האצת תגובת העובדים. אבחון בזמן מונע הפסדים כספיים מלידים שהוחמצו.
צרו קשר לאבחון של תצורת הפוש הנוכחית שלכם. נעריך את הפרויקט שלכם ונציע את הפתרון האופטימלי. הזמינו הגדרת התראות פוש והבטיחו פעולה יציבה. קבלו ייעוץ — כתבו לנו ב-Telegram או בדוא"ל.