פיתוח יישומי REST מותאמים אישית עבור Bitrix24

מפיץ חלקי חילוף בילה 30 שניות בנדידה בין 1C ל-Bitrix24, עד שהטמענו ווידג'ט REST. מנהל מכירות פותח עסקה, ולמולו מוצגים רק השדות שהוא מילא ידנית.

מערכת הנהלת החשבונות מכילה שלוש שנות היסטוריה, מסגרת אשראי, תביעות, ארכיון הזמנות. כדי לצפות בהם, יש לעבור בין לשוניות, להעתיק את המזהה, לבזבז זמן. הנתונים מתפצלים — ב-CRM סכום אחד, ב-1C אחר.

יישום REST עבור Bitrix24 פותר בעיה זו: הוא מטמיע מידע חיצוני ישירות בממשק הפורטל, דרך ווידג'טים וממשק ה-REST API. אנחנו, מפתחי Bitrix מוסמכים עם עשר שנות ניסיון, הטמענו יותר מ-50 אינטגרציות כאלה.

החיסכון הממוצע בהזנה ידנית — עלות מחושבת לאחר ביקורת. בשנה. כל יישום הוא ארכיטקטורה מחושבת היטב: מתהליך OAuth ועד לטיפול במגבלות קצב של ה-API. קבלו ייעוץ — נעריך את המשימה שלכם.

כיצד בנויה אפליקציית REST ב-Bitrix24?

אפליקציית REST היא שירות אינטרנט חיצוני שמקיים אינטראקציה עם הפורטל באמצעות OAuth 2.0 ו-REST API (https://domain.bitrix24.ru/rest/). האפליקציה יכולה להטמיע ווידג'טים בכרטיסי CRM, להירשם לאירועים, ולקרוא ולכתוב נתונים.

קיימים שני סוגים: Marketplace (מפורסם ב-Marketplace) ו-מוטמע (עבור פורטל בודד). עבור משימות ארגוניות, לרוב בוחרים במוטמעים — הם פשוטים יותר, אך אינם מתרחבים למספר פורטלים.

אנו נעזור לך לקבוע את הארכיטקטורה, תוך התחשבות בתהליכים העסקיים שלך ובצורך באינטגרציה עם 1C דרך CommerceML. ל-Bitrix24 REST API יש יותר מ-700 מתודות, מה שמכסה את כל ישויות ה-CRM, משימות, שיחות ותהליכים עסקיים.

אילו נתונים ניתן לקבל דרך ה-REST API?

דרך ה-REST API, כל הישויות המרכזיות זמינות: עסקאות, אנשי קשר, חברות, לידים, חשבוניות, הצעות מחיר, משימות, יומנים, שיחות, תהליכים עסקיים (Bizproc). השיטות מאפשרות לא רק קריאה אלא גם יצירה, עדכון ומחיקה של רשומות.

קיימת גם גישה לשדות מותאמים אישית ולאירועים. הדבר מאפשר לבנות אינטגרציות גמישות עם כל מערכת חיצונית — מניהול מלאי ועד CRM.

מדוע אפליקציית REST מהירה יותר מסקריפטים מותאמים אישית?

סקריפט מותאם אישית ללא מטמון ובקשות מרוכזות יכול להיות איטי פי 10. אפליקציית REST משתמשת במטמון מתויג, מה שמפחית את העומס על השרת ואת זמן התגובה של הווידג'ט ל-1–2 שניות.

על פי התיעוד הרשמי של REST API, תמיכה בבקשות מרוכזות מפחיתה את מספר הקריאות. ה-API הרשמי תומך באירועים, מה שמאפשר להגיב לשינויים בנתונים בזמן אמת.

יישמנו אפליקציה עבור מפיץ חלקים: ווידג'ט בכרטיס העסקה טוען יתרות מלאי מ-1C והיסטוריית אשראי. זמן הטעינה צומצם מ-30 שניות ל-0.5 שניות הודות למטמון Redis.

חיסכון של 30% מהזמן שווה ערך לעלות המחושבת לאחר ביקורת לחודש. פתרון כזה מחזיר את ההשקעה תוך 3–6 חודשים בממוצע בזכות הפחתת הקלט הידני.

בפירוט: ווידג'ט בכרטיס העסקה

התרחיש הנפוץ ביותר הוא הטמעת נתונים חיצוניים ישירות ב-CRM. רישום מיקום דרך ה-REST API:

// Called when the application is installed
$client->call('placement.bind', [
    'PLACEMENT' => 'CRM_DEAL_DETAIL_TAB',
    'HANDLER' => 'https://myapp.example.com/widget/deal/',
    'TITLE' => 'Customer history',
    'OPTIONS' => ['extraData' => 'ENTITY_ID'],
]);

כאשר מנהל פותח עסקה, Bitrix24 טוען iframe עם כתובת האפליקציה שלך, ומעביר ENTITY_ID?

האפליקציה:

1. מקבלת ENTITY_ID מ-placement.info()
2. מבצעת בקשת REST crm.deal.get כדי לשלוף את מזהה איש הקשר/החברה
3. משתמשת במזהה איש הקשר כדי לגשת למערכת הנהלת החשבונות הפנימית
4. מציגה היסטוריית רכישות, מסגרת אשראי, משימות פתוחות

לאמינות, אנו מוסיפים טיפול בשגיאות וניסיון חוזר במקרי כשל.

OAuth 2.0: הרשאה ואחסון טוקנים

בעת רישום אפליקציה, הפורטל מנפיק client_id ו-client_secret. המשתמש מאשר את האפליקציה, ואנחנו מקבלים access_token (TTL של שעה אחת) ו-refresh_token (TTL של 30 יום). אנחנו שומרים את הטוקנים בצורה מוצפנת (AES-256) ומרעננים אותם באופן אוטומטי לפני כל בקשה:

class Bitrix24OAuth {
    public function refreshToken(string $refreshToken): array
    {
        $response = Http::post('https://domain.bitrix24.ru/oauth/token/', [
            'grant_type' => 'refresh_token',
            'client_id' => config('b24.client_id'),
            'client_secret' => config('b24.client_secret'),
            'refresh_token' => $refreshToken,
        ]);

        TokenStorage::save($response['access_token'], $response['refresh_token']);

        return $response;
    }
}

טעויות אופייניות בפיתוח אפליקציות REST

• אחסון טוקנים לא מאובטח: טוקנים בטקסט גלוי או במסד נתונים ללא הצפנה. יש להשתמש ב-AES-256.
• התעלמות ממגבלות API: ללא תור בקשות וניסיונות חוזרים, האפליקציה תחסם. יש להגדיר rate limiter על Redis.
• היעדר טיפול באירועים: polling מתמיד במקום מנוי לאירועים יוצר עומס מיותר.

מה כלול בפיתוח אפליקציית REST?

כיצד בנוי תהליך העבודה?

• אנליטיקה: אנו לומדים את הלוגיקה העסקית שלך, התהליכים הנוכחיים ומערכות הנהלת החשבונות.
• עיצוב: אנו מסכמים על הארכיטקטורה, ה-stack וה-API.
• פיתוח: אנו בונים אפליקציית REST על PHP 8.1+ עם בלוקי מידע v2.0 ו-ORM.
• בדיקות: אנו בודקים את הווידג'טים בפורטל בדיקות, בדיקות עומס.
• פריסה ותמיכה: אנו מתקינים בפורטל הייצור, מוסרים תיעוד.

צרו קשר כדי לדון בפרויקט שלכם — אנו נעריך את המשימה ונציע ארכיטקטורה. אנו מוכנים לקחת על עצמנו אינטגרציה בכל רמת מורכבות: מווידג'ט פשוט ועד לפתרון מקיף עם 1C, amoCRM ומערכות נוספות. הזמינו פיתוח אפליקציית REST — אנו נבחר את הפתרון האופטימלי למשימה שלכם.