חברות רבות מתמודדות עם בעיה: הודעות SMS מ-Bitrix24 לא מגיעות לכל הלקוחות — מספרים לא מעודכנים, הודעות אובדות, ועלות המשלוח עולה. אנחנו פותרים זאת על ידי אינטגרציה עם SMSC, אחד מאגרגטורי ה-SMS הוותיקים ביותר, המציע בדיקות HLR ושליחה מדורגת דרך Viber. נפרק כיצד להגדיר את החיבור דרך REST API, להגדיר callbacks, ולהשיג 99% מסירת הודעות. הניסיון שלנו מראה שאינטגרציה נכונה מפחיתה את עלויות המשלוח ב-30-40% על ידי הוצאת מספרים לא תקינים ושימוש בערוץ Viber הזול יותר. לעסק בינוני, החיסכון יכול להסתכם בעשרות דולרים בחודש.
כיצד לרשום את ספק ה-SMSC ב-Bitrix24?
כדי לחבר את SMSC, נעשה שימוש במודול messageservice. הספק נרשם דרך שיטת ה-REST messageservice.sender.add עם הפרמטרים: CODE="smsc", TYPE="SMS", HANDLER=URL של ה-handler שלך. ה-handler מקבל בקשה מ-Bitrix24, יוצר בקשת GET ל-API של SMSC:
https://smsc.ru/sys/send.php?login=LOGIN&psw=PASSWORD&phones=NUMBER&mes=TEXT&fmt=3&op=1 הפרמטר https://smsc.ru/sys/send.php?login=LOGIN&psw=PASSWORD&phones=NUMBER&mes=TEXT&fmt=3&op=1 — תגובת JSON, fmt=3 — סטטוס מסירת הבקשה. ה-handler שומר את המיפוי בין op=1 של Bitrix24 לבין message_id של SMSC, ולאחר מכן מחזיר אישור. זה מבטיח מעקב מלא אחר השליחה. תיעוד ה-API הרשמי של SMSC מכיל רשימה מלאה של פרמטרים.
למה לבצע בדיקות HLR לפני שליחה?
HLR (Home Location Register) — בקשה למפעיל שבודקת את פעילות המספר, מזהה את המפעיל והאזור. SMSC מספק HLR דרך שיטת API נפרדת:
https://smsc.ru/sys/hlr.php?login=LOGIN&psw=PASSWORD&phones=NUMBER&fmt=3 התגובה כוללת id (0=פעיל, 1=לא זמין, 2=לא קיים), https://smsc.ru/sys/hlr.php?login=LOGIN&psw=PASSWORD&phones=NUMBER&fmt=3 ו-status. בהקשר של Bitrix24, בדיקת HLR מאפשרת:
- הוצאת מספרים לא זמינים משליחות המוניות, חיסכון בתקציב.
- זיהוי אוטומטי של המפעיל והאזור בעת יצירת ליד דרך תהליך עסקי עם בקשת HTTP. התוצאה נשמרת בשדות מותאמים אישית
operatorו-region.
שליחה מדורגת: SMS + Viber
SMSC תומך במשלוח מדורג בקריאת API אחת. ההיגיון: ההודעה נשלחת דרך Viber; אם הנמען לא קרא אותה בתוך זמן מוגדר (בדרך כלל 1-2 שעות), נשלחת הודעת SMS אוטומטית. פרמטרי API:
https://smsc.ru/sys/send.php?login=LOGIN&psw=PASSWORD&phones=NUMBER&mes=TEXT&fmt=3&viber=1&viber_timeout=3600 UF_CRM_OPERATOR — ניסיון משלוח דרך Viber, UF_CRM_REGION — זמן קצוב בשניות לפני מעבר ל-SMS. הודעות Viber בדרך כלל זולות פי 1.5-2 מה-SMS, מה שמאפשר להגיע למספר המרבי של נמענים בעלות מינימלית. ב-Bitrix24, השליחה המדורגת מוגדרת ברמת ה-handler: הרובוט של ה-CRM מפעיל את פעולת "שלח SMS" הסטנדרטית, וה-handler מחליט אם לשלוח דרך Viber עם מעבר ל-SMS או SMS טהור — בהתאם לסוג ההודעה או הפלח.
שליחה המונית למשלוחים המוניים
SMSC מקבל עד 100 מספרים בבקשה אחת (מופרדים בפסיקים). למשלוחים המוניים דרך שיווק CRM, זה קריטי: במקום 10,000 בקשות בודדות, ה-handler מקבץ מספרים לקבוצות של 100 ושולח 100 בקשות. היתרון: מהירות המשלוח עולה בסדר גודל, והעומס על השרת/API מינימלי. יישום: ה-handler מקבל בקשות מ-Bitrix24 (כל אחת למספר אחד), שומר אותן בתור (Redis, מסד נתונים, קובץ), משימת cron כל 5-10 שניות אוספת עד 100 מספרים ושולחת אותם כקבוצה. הסטטוסים ממופים בחזרה לפי https://smsc.ru/sys/send.php?login=LOGIN&psw=PASSWORD&phones=NUMBER&mes=TEXT&fmt=3&viber=1&viber_timeout=3600 של כל הודעה.
Callback לסטטוסי מסירה
SMSC שולח הודעות סטטוס לכתובת URL מוגדרת. ההגדרה מתבצעת בלוח הבקרה של SMSC (סעיף "הגדרות → מטפל סטטוסים"). סטטוסים:
| קוד | תיאור |
|---|---|
| 1 | נמסר |
| 2 | לא נמסר (שגיאה) |
| 3 | לא נמסר (פג תוקף) |
| 20 | נמסר דרך Viber |
| 22 | לא נמסר דרך Viber, SMS נשלח (מדורג) |
ה-handler מקבל viber=1 ו-viber_timeout, מוצא את id המשויך ב-Bitrix24, ומעדכן את הסטטוס ב-CRM. סטטוס "22" שימושי במיוחד: הוא מראה שהשליחה המדורגת פעלה והלקוח קיבל SMS במקום Viber. ניתן לכתוב מידע זה לשדה איש קשר מותאם — בשליחה הבאה, שלח SMS ישירות, תוך עקיפת זמן ההמתנה של Viber.
הגדרת Handler שלב אחר שלב
- צור סקריפט PHP על השרת שלך שמקבל בקשת POST מ-Bitrix24 עם השדות
id,status,message_id. - רשום את הספק דרך
message_id, ציין את כתובת הסקריפט כ-phone. - הגדר את כתובת ה-callback בלוח הבקרה של SMSC לקבלת סטטוסים.
- בדוק שליחת הודעת ניסיון מה-CRM.
- הגדר רובוטים של CRM לשליחה אוטומטית של הודעות לפי שלבים.
בעיות נפוצות
- ה-handler לא מגיב: בדוק שהשרת נגיש דרך HTTPS ומחזיר HTTP 200. - סטטוסים לא מגיעים: ודא שכתובת ה-callback מוגדרת ללא שגיאות והשרת מקבל POST. - הודעות לא נמסרות: בדוק את היתרה ב-SMSC ואת תקינות המספר.לוחות זמנים ליישום
| היקף | מה כלול | לוח זמנים |
|---|---|---|
| בסיסי | חיבור SMSC, שליחה ידנית מכרטיס, רובוט אחד | 3–5 ימים |
| סטנדרטי | רובוטים לפי שלבים, callback סטטוסים, SMS/Viber מדורג | שבוע |
| מורחב | בדיקת מסד נתוני HLR, שליחה המונית, שיווק CRM, אנליטיקת ערוצים | 1.5–2 שבועות |
מה כלול בעבודה
- רישום SMSC כספק דרך
text - פיתוח handler לבקשות Bitrix24 → API של SMSC עם תמיכה בשליחה מדורגת והמונית
- הגדרת בדיקות HLR על מסד נתוני אנשי הקשר
- יצירת handler callback לסטטוסי מסירה
- הגדרת רובוטים של CRM להודעות טרנזקציוניות
- אינטגרציה עם שיווק CRM למשלוחים המוניים
- בדיקת כל התרחישים (SMS, Viber, מדורג, HLR)
- תיעוד והדרכה
אנו מבטיחים ביצועים יציבים של האינטגרציה. לצוות שלנו ניסיון של 10+ שנים עם Bitrix24 ושירותי SMS. נבחן את הפרויקט שלך ונציע פתרון אופטימלי. צור קשר לייעוץ וקבל תקשורת SMS יציבה עם לקוחות. השאר בקשה באתר, ונמצא פתרון לתקציב שלך.