פיתוח אפליקציות 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) ומוטמעת (עבור פורטל בודד). עבור משימות ארגוניות, לרוב בוחרים במוטמעות — הן פשוטות יותר אך אינן מתרחבות על פני מספר פורטלים.

נעזור לכם להחליט על הארכיטקטורה, תוך התחשבות בתהליכים העסקיים שלכם ובצורך באינטגרציה עם 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. רישום מיקום (placement) דרך ה-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 עם כתובת ה-URL של האפליקציה שלך, ומעביר 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?

איך מתנהל תהליך העבודה?

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

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