שילוב A1 SMS (בלארוס) עם Bitrix24
חברות בלארוסיות המשתמשות ב-Bitrix24 נתקלות באופן קבוע באותה בעיה: ה-CRM חי ב-Bitrix24, אך קמפיינים של SMS נשארים בחשבון האישי של A1. מנהל מעתיק מספר מכרטיס עסקה, עובר לממשק ה-SMS של A1, מדביק את המספר, מקליד את הטקסט ושולח. סטטוסי המסירה נשארים בחשבון A1—ה-CRM אינו יודע עליהם דבר. עם 50+ הודעות ביום, זה הופך לפס ייצור ידני. הצוות שלנו מציע אינטגרציה שמבטלת לחלוטין את המעבר הידני: SMS נשלחים מכרטיס ה-CRM, סטטוסים חוזרים בחזרה, ורובוטים הופכים תרחישים טיפוסיים לאוטומטיים. אנו מבטיחים טיפול נכון במספרים בפורמט הבלארוסי והגדרת כל סטטוסי המסירה. ניסיון יישום על למעלה מ-10 פרויקטים לשוק הבלארוסי מאשר את אמינות הפתרון. האינטגרציה דרך ה-API של A1 מהירה פי עשרה מהתהליך הידני. על סמך הניסיון שלנו, עסקים חוסכים עד 500$ לחודש בפעולות SMS, והאינטגרציה עולה בדרך כלל בין 300$ ל-1,500$ בהתאם למורכבות.
תכונות מפתח של A1 SMS שיש לקחת בחשבון
A1 (לשעבר Velcom) היא המפעילה הגדולה ביותר בבלארוס. על פי תיעוד ה-API של A1 SMS, שירות ה-SMS של A1 פועל דרך HTTP API ופרוטוקול SMPP. לצורך אינטגרציה עם Bitrix24, אנו משתמשים ב-HTTP API—זה פשוט יותר ליישום ואינו דורש חיבור קבוע.
תכונות מפתח של ה-API של A1 SMS:
- אימות – באמצעות שם משתמש וסיסמה הניתנים בעת הפעלת שירות "שידור SMS" מ-A1. פרטי הכניסה נשלחים עם כל בקשה.
- פורמט מספר – בינלאומי: +375XXXXXXXXX (12 תווים). ה-API של A1 אינו מקבל מספרים בפורמט 80XXXXXXXXX—ה-handler חייב לנרמל מספרים מ-Bitrix24 לפני השליחה.
- מזהה שולח – שם אלפביתי עד 11 תווים. נרשם באמצעות בקשה ל-A1 עם מסמכים משפטיים. האישור אורך 3–10 ימי עסקים. ללא שם רשום, SMS נשלחים עם מספר ספרתי.
- קידוד – קירילית מועברת ב-UTF-8. SMS אחד בקירילית הוא 70 תווים, בלטינית—160 תווים. אם חורגים, ההודעה מחולקת למקטעים (67 / 153 תווים בהתאמה).
כיצד לרשום את ספק ה-A1 SMS ב-Bitrix24
Bitrix24 מחבר ספקי SMS חיצוניים דרך מודול messageservice. עבור A1 SMS, אנו רושמים handler על ידי קריאה למתודת messageservice.sender.add({ CODE: "a1sms_by", TYPE: "SMS", HANDLER: "https://your-domain.com/handler/a1sms.php" }) עם הפרמטרים המתאימים, כולל כתובת URL של handler שאתם מארחים על השרת שלכם. הלוגיקה של ה-handler:
- מקבל POST מ-Bitrix24 עם השדות: message_to (מספר), message_body (טקסט), message_id (מזהה הודעה ב-Bitrix24).
- מנרמל את המספר: מסיר מקפים, רווחים, ממיר 80XX ל-+375XX.
- יוצר בקשה ל-API של A1 SMS עם פרטי אימות, מספר נמען, טקסט ומזהה שולח.
- מקבל את מזהה ההודעה (msg_id) וקוד סטטוס מ-A1.
- שומר את המיפוי של message_id (Bitrix24) → msg_id (A1) למעקב מסירה.
- מחזיר אישור ל-Bitrix24.
לאחר הרישום, ספק ה-A1 SMS מופיע ברשימת הספקים הזמינים בעת שליחת SMS מכרטיס איש קשר, ברובוטים של CRM ובשיווק CRM.
כיצד פועל משוב סטטוס מסירה
ה-API של A1 SMS תומך בשני מנגנונים לקבלת סטטוסים:
- Callback (DLR) – A1 שולחת בקשת HTTP לכתובת URL מוגדרת בעת שינוי סטטוס. מוגדר בעת הפעלת השירות.
- Polling – ה-handler עצמו מבקש את הסטטוס לפי msg_id דרך ה-API.
סטטוסים עיקריים (לפי מפרט דוח מסירת SMS של A1):
| קוד | משמעות | תצוגה ב-Bitrix24 |
|---|---|---|
| DELIVERED | נמסר | נמסר |
| EXPIRED | פסק זמן למסירה | לא נמסר |
| UNDELIVERABLE | לא ניתן להשגה | לא נמסר |
| REJECTED | נדחה על ידי המפעילה | שגיאה |
| ENROUTE | במעבר | נשלח |
ללא עיבוד callbacks, כל ה-SMS ב-CRM נשארים תקועים בסטטוס "נשלח", גם אם המנוי היה מחוץ לכיסוי במשך שלושה ימים. הגדרה מומלצת: callback כערוץ ראשי, polling כל 60 שניות כגיבוי למקרים שבהם ה-callback לא הגיע (פסק זמן, שגיאת רשת).
אוטומציה דרך רובוטים של CRM
תרחישים טיפוסיים לשוק הבלארוסי: משפך מכירות:
- ליד חדש → SMS "שלום, {NAME}. בקשתך התקבלה, מנהל יתקשר אליך תוך 15 דקות."
- עסקה בשלב "ממתין לתשלום" → SMS עם קישור לתשלום דרך ERIP (הכנס #DEAL_UF_ERIP_LINK#)
- עסקה נסגרה בהצלחה → SMS תודה
הודעות שירות:
- הזמנת פגישה (תהליך חכם) → SMS תזכורת יום ושעה לפני
- שיחה שלא נענתה → SMS "שמנו לב לשיחתך, נחזור אליך בקרוב."
בטקסט הרובוט, שדות CRM זמינים: #CONTACT_NAME#, #DEAL_TITLE#, #DEAL_OPPORTUNITY#, שדות מותאמים אישית דרך #DEAL_UF_XXX#.
SMS שיווקי וטרנזקציוני
הפרדה היא קריטית לעבודה עם A1:
| פרמטר | טרנזקציוני | שיווקי |
|---|---|---|
| יוזם | פעולת לקוח | חברה |
| הסכמה | בעת ביצוע הזמנה | הסכמה מפורשת חובה |
| הגדרה ב-Bitrix24 | רובוטים של CRM | סעיף שיווק CRM |
| דרישות A1 | מזהה שולח | מזהה שולח + הסכמת מנוי |
SMS שיווקי דרך A1 דורש הוכחת הסכמת מנוי. A1 עשויה לבקש ראיות במקרה של תלונות. ב-Bitrix24, ההסכמה מתועדת בשדה מותאם אישית של איש הקשר—הרובוט בודק אותה לפני השליחה.
נרמול מספרים בלארוסיים
בסיס אנשי הקשר ב-Bitrix24 מכיל מספרים בפורמטים שונים: +375291234567, 80291234567, 375 29 123-45-67, 29 1234567. ה-handler ממיר את כולם ל-+375XXXXXXXXX לפני שליחה ל-API של A1. עבור מספרים ללא קוד מדינה, מתווסף +375. מספרים שאינם תואמים לפורמט הבלארוסי (לא מתחילים ב-+375 או 80) מסומנים כלא תקינים—SMS לא נשלחים אליהם. לפני שליחה המונית, אנו ממליצים להעביר את הבסיס דרך נרמול וניקוי מספרים לא תקינים—זה מפחית עלויות ומוריד את שיעור השגיאות.
לוחות זמנים משוערים
| היקף | מה כלול | זמן |
|---|---|---|
| בסיסי | חיבור A1 SMS, שליחה ידנית מכרטיס, רובוט אחד | 3–5 ימים |
| סטנדרטי | 3–5 רובוטים, callback סטטוס, נרמול מספרים | שבוע |
| מורחב | שיווק CRM, polling, בדיקת הסכמה, אנליטיקה | 1.5–2 שבועות |
מה כלול בהגדרת האינטגרציה
- רישום A1 SMS כספק דרך messageservice.sender.add
- פיתוח ופריסה של ה-handler לבקשות (Bitrix24 → A1 SMS API)
- נרמול מספרים בלארוסיים (80XX → +375XX)
- הגדרת handler ל-callback של סטטוסי מסירה (DLR)
- סיוע בהכנת הבקשה למזהה שולח ל-A1
- יצירת רובוטים של CRM ל-SMS טרנזקציוני לפי שלבי משפך
- הגדרת קמפיינים המוניים דרך שיווק CRM עם בדיקת הסכמה
- הכנת תבניות SMS עם החלפת שדות CRM
- בדיקות: שליחה מכרטיס, הפעלת רובוט, קבלת callback, קמפיין המוני על פלח בדיקה
- תיעוד תפעולי והדרכת צוות
לקבלת ייעוץ על אינטגרציית A1 SMS עם Bitrix24, השאירו בקשה באתר שלנו. המומחים המוסמכים שלנו מבטיחים הגדרה נכונה ותמיכה לאחר ההשקה.