אינטגרציה של 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 (ראו ב-helpdesk של Bitrix24).
טבלת אירועים נתמכים:
| אירוע | טריגר |
|---|---|
call.start |
שיחה נכנסת נרשמה |
call.answer |
העובד ענה |
call.end |
השיחה הסתיימה |
call.record_ready |
ההקלטה מוכנה להורדה |
לאחר הרישום, קראו ל-telephony.externalCall.attachRecord כדי לצרף את האודיו. תקופת שמירת ההקלטות בענן של Beeline נעה בין 7 ימים לשנה, בהתאם לתעריף.
כיצד להגדיר את ה-handler לאירועים?
- צרו סקריפט PHP שמקבל בקשות POST מ-Beeline.
- אמתו את חתימת ה-HMAC בכותרת
X-Beeline-Signature. - פרסו את ה-JSON ורשמו את השיחה באמצעות
telephony.externalCall.register. - באירוע
call.record_ready, הורידו את ההקלטה וצרפו אותה באמצעותtelephony.externalCall.attachRecord. - הגדירו תיעוד שגיאות וניטור.
מה לעשות אם משתמשים בכרטיסי SIM ארגוניים ללא מרכזייה?
ללא מרכזייה וירטואלית, אירועי שיחות אינם זמינים ישירות. קיימים שלושה פתרונות:
- מעבר ל-Virtual Office — מספרי נייד הופכים לפנימיים, אינטגרציה דרך API.
- שער GSM — ממיר חומרה מ-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 של השרת שלכם.
- Timeouts: ה-handler חייב להשיב בתוך 5 שניות, אחרת Beeline מנסה שוב.
- אובדן אירועים: הגדירו תור ב-Redis או RabbitMQ.
מה כלול בעבודה
באינטגרציה אנו מבצעים מחזור מלא: מביקורת התוכנית הנוכחית ועד למסירה. באופן ספציפי:
- תיעוד זרימת השיחות והקצאת המספרים.
- הגדרת ה-handler לאירועים בשרת שלכם (PHP, מבוסס על המודול שלנו).
- מיפוי מספרים למשתמשי Bitrix24.
- בדיקת כל התרחישים: נכנס, יוצא, העברה, הקלטה.
- הדרכת מנהלים ומענה לשאלות במהלך השבוע הראשון לאחר המסירה.
- תמיכה לאחר שחרור והתאמות בהתבסס על משוב.
עם השלמת העבודה, תקבלו מדריך תחזוקה ותרשים טיפול בשגיאות.
מהניסיון שלנו: חברת מסחר ב-6 ערים
רשת מסחר פדרלית החזיקה משרדים ב-6 ערים, כל אחד עם חשבון Beeline Virtual Office משלו. כל משרד טיפל בלמעלה מ-200 שיחות ביום. הם היו צריכים לראות את כל השיחות ב-Bitrix24 אחד, אך מנהלים בכל עיר צריכים לראות רק את שלהם.
בנינו את הארכיטקטורה: שישה webhooks על שרת אחד, ה-handler מזהה את העיר לפי ה-URL ומגדיר את ה-LINE_NUMBER הנכון. הרשאות גישה הוגדרו דרך ה-CRM. דרישה לא סטנדרטית: כאשר שיחה הועברה ממוסקבה לסנקט פטרבורג, היא הייתה צריכה להגיע למנהל בסנקט פטרבורג.
פתרנו זאת דרך אירוע ההעברה במרכזייה — ה-handler יצר שיחה חדשה עם המשרד הנכון. תוצאות: שיחות שלא נענו פחתו ב-30%, ועלויות טיפול בשיחות נכנסות פחתו בעד 40% לחודש. הפרויקט ארך 8 ימי עסקים, כולל תיאום עם Beeline עבור כל חשבון.
צרו קשר לקבלת הערכה של התרחיש שלכם. קבלו ייעוץ ממהנדס אינטגרציות. עלות אינטגרציה אופיינית למשרד בודד מחושבת לאחר ביקורת.
לוח זמנים וכיצד להזמין
האינטגרציה של משרד בודד אורכת בין 3 ל-7 ימים. עבור הגדרות מורכבות (כמו המקרה לעיל) — עד 10 ימי עסקים. אנו מעריכים את התרחיש שלכם. אנו עובדים באופן רשמי עם אחריות. קבלו הערכת לוח זמנים מדויקת לתרחיש שלכם. עם למעלה מ-50 הטמעות, יש לנו גישות מוסמכות.