אינטגרציה של Bitrix24 עם טלפוניה עסקית של Beeline
אנו רואים כל הזמן חברות שמאבדות נתוני שיחות בגלל שהאינטגרציה לא מוגדרת. טלפוניה עסקית ארגונית של Beeline פועלת либо через מרכזייה וירטואלית (Virtual Office) либо через SIM כרטיסים רגילים. שתי האפשרויות יכולות להיות מחוברות ל-Bitrix24, אבל הגישות שונות מהותית.
עם למעלה מ-50 אינטגרציות שהושלמו, צברנו פתרונות מוכנים לכל תרחיש. מאמר זה מסביר כיצד להגדיר את האינטגרציה כראוי כך שאף שיחה לא תאבד ותקבלו אנליטיקה מלאה.
כיצד לשלב את Beeline Virtual Office עם Bitrix24?
ה-Virtual Office (מרכזייה בענן) מספק API ו-webhooks לאירועי שיחות. ההגדרה מתחילה בבקשת גישה מתמיכת Beeline או דרך תוכנית שותפים. בלוח הבקרה של המרכזייה תחת Settings → Integrations → API, ציינו את כתובת ה-handler שלכם וסוד לחתימה.
Beeline שולח אירועים בפורמט JSON עם HMAC-SHA256 בכותרת X-Beeline-Signature. ה-handler חייב לרשום שיחות ב-Bitrix24 דרך שיטת ה-REST telephony.externalCall.register (ראו Bitrix24 helpdesk).
טבלת אירועים נתמכים:
| אירוע | טריגר |
|---|---|
call.start |
שיחה נכנסת נרשמה |
call.answer |
העובד ענה |
call.end |
השיחה הסתיימה |
call.record_ready |
ההקלטה מוכנה להורדה |
לאחר הרישום, קראו ל-telephony.externalCall.attachRecord כדי לצרף את האודיו. תקופת שמירת ההקלטות בענן של Beeline נעה בין 7 ימים לשנה, בהתאם לתעריף.
כיצד להגדיר את מטפל האירועים?
- צרו סקריפט PHP שמקבל בקשות POST מ-Beeline.
- אמתו את חתימת ה-HMAC בכותרת
X-Beeline-Signature. - פרסו את ה-JSON ורשמו את השיחה דרך
telephony.externalCall.register. - באירוע
call.record_ready, הורידו את ההקלטה וצרפו אותה דרךtelephony.externalCall.attachRecord. - הגדירו רישום שגיאות וניטור.
מה לעשות אם משתמשים בכרטיסי SIM ארגוניים ללא מרכזייה?
ללא מרכזייה וירטואלית, אירועי שיחות אינם זמינים ישירות. קיימים שלושה פתרונות:
- מעבר ל-Virtual Office — מספרים ניידים הופכים לפנימיים, אינטגרציה דרך API.
- GSM gateway — ממיר חומרה מ-SIM ל-SIP, מתחבר לכל מרכזייה, כולל Bitrix24 ישירות.
- מחברי SIM בענן — שירותים (למשל SimCom) עושים וירטואליזציה של SIM ומספקים ממשק SIP.
האפשרות השנייה לעתים עולה פחות מהגירה מלאה אבל דורשת תחזוקת חומרה.
הגדרה דרך אפליקציית Beeline הרשמית ב-Bitrix24
Beeline ו-Bitrix24 הם שותפים. בסעיף "Telephony" ב-Bitrix24, בחרו "Connect Telephony" → האפליקציה "Beeline Business". אשרו עם החשבון הארגוני שלכם ומפו מספרים פנימיים למשתמשים. שיטה זו מתאימה לחברות שכבר משתמשות ב-Virtual Office. ההגדרה אורכת כיום אחד.
השוואה בין אינטגרציית API לאפליקציה
| פרמטר | API דרך webhooks | אפליקציית Beeline |
|---|---|---|
| גמישות | שליטה מלאה ב-handler | מוגבל להגדרות האפליקציה |
| מהירות הטמעה | 2–5 ימי פיתוח | יום אחד |
| תמיכה בתרחישים לא סטנדרטיים | כן | לא |
| תלות בגישת שותף | כן | לא |
אנו ממליצים על אינטגרציית API אם אתם צריכים ניתוב מורכב או אנליטיקה בצד Bitrix24.
שגיאות אינטגרציה אופייניות
- חתימת HMAC שגויה: בדקו שוב את הסוד והאלגוריתם (SHA256).
- טווח כתובות IP של Beeline: הוסיפו אותן ל-whitelist של השרת.
- פסקי זמן: ה-handler חייב להגיב בתוך 5 שניות, אחרת Beeline מנסה שוב.
- אובדן אירועים: הגדירו תור על Redis או RabbitMQ.
מה כלול בעבודה
באינטגרציה, אנו מבצעים מחזור מלא: מביקורת הסכמה הנוכחית ועד למסירה. באופן ספציפי:
- תיעוד זרימת השיחות והקצאת המספרים.
- הגדרת מטפל האירועים בשרת שלכם (PHP, מבוסס על המודול שלנו).
- מיפוי מספרים למשתמשי Bitrix24.
- בדיקת כל התרחישים: נכנס, יוצא, העברה, הקלטה.
- הדרכת מנהלים ומענה לשאלות במהלך השבוע הראשון לאחר המסירה.
- תמיכה לאחר שחרור והתאמות בהתבסס על משוב.
עם השלמת העבודה, תקבלו מדריך תחזוקה ותרשים טיפול בשגיאות.
מהפרקטיקה שלנו: קונגלומרט מסחרי ב-6 ערים
לרשת מסחר פדרלית היו משרדים ב-6 ערים, כל אחד עם חשבון Beeline Virtual Office משלו. כל משרד טיפל ביותר מ-200 שיחות ביום. הם היו צריכים לראות את כל השיחות ב-Bitrix24 אחד, אבל מנהלים בכל עיר היו צריכים לראות רק את שלהם.
בנינו את הארכיטקטורה: שישה webhooks על שרת אחד, ה-handler מזהה את העיר לפי URL ומגדיר את LINE_NUMBER הנכון. הרשאות גישה הוגדרו דרך CRM. דרישה לא סטנדרטית: כששיחה הועברה ממוסקבה לסנקט פטרבורג, היא הייתה צריכה להגיע למנהל סנקט פטרבורג.
פתרנו זאת דרך אירוע ההעברה של המרכזייה — ה-handler יצר שיחה חדשה עם המשרד הנכון. תוצאות: שיחות שלא נענו ירדו ב-30%, ועלויות טיפול בשיחות נכנסות הופחתו בעד 40% לחודש. הפרויקט ארך 8 ימי עסקים, כולל תיאום עם Beeline עבור כל חשבון.
צרו קשר לקבלת הערכה של התרחיש שלכם. קבלו ייעוץ ממהנדס אינטגרציה. עלות אינטגרציה אופיינית למשרד בודד מתחילה ב-по индивидуальному расчёту.
לוח זמנים וכיצד להזמין
אינטגרציה של משרד בודד אורכת בין 3 ל-7 ימים. עבור הגדרות מורכבות (כמו המקרה לעיל) — עד 10 ימי עסקים. אנו מתחילים בהערכת התרחיש שלכם. אנו עובדים באופן רשמי עם אחריות. קבלו הערכת לוח זמנים מדויקת לתרחיש שלכם. עם למעלה מ-50 הטמעות, יש לנו גישות מוסמכות.