התיעוד שלכם חי ב-Confluence, אבל העבודה מתבצעת ב-Bitrix24. מנהל יוצר משימה ומעתיק קישור למאמר ב-Confluence לתיאור. שבוע לאחר מכן, המאמר מתעדכן, העמוד משנה שם או מועבר, והקישור נשבר. המפתח פותח את המשימה ורואה כתובת URL מתה. אנחנו פותרים זאת עם אינטגרציה אוטומטית: קישור עמודי Confluence למשימות Bitrix24, סנכרון מטא-דאטה, והודעות לצוות על שינויים. לצוות שלנו יש ניסיון של 5+ שנים בפיתוח Bitrix24 ומעל 50 אינטגרציות מוצלחות — אנחנו מבטיחים פתרון יציב ומוסמך. אנחנו מספקים חיבור סוהר שמפחית עבודה ידנית ב-80% בהשוואה להעתקת קישורים. אינטגרציה טיפוסית חוסכת $15,000 בשנה לצוות של עשרה אנשים על ידי ביטול ניהול קישורים ידני. הקישור האוטומטי שלנו מהיר פי 10 מהעתקה ידנית של כתובות URL. זה חיסכון של מעל $1,250 בחודש.
ארכיטקטורת האינטגרציה
הגשר בנוי על Confluence REST API v2 (או v1 עבור Server/Data Center) ועל Bitrix24 REST API. תוכנת ביניים מטפלת בהחלפת נתונים: עוקבת אחר שינויים ב-Confluence ומתרגמת אותם ל-Bitrix24, ומסנכרנת קישורים ומטא-דאטה. תוכנת הביניים של האינטגרציה פועלת כמוקד מרכזי.
Confluence (webhook) → Middleware → Б24 REST API → Задачи/Чат/Лента Б24 (задача/CRM) → Middleware → Confluence API → Поиск/Получение страниц Confluence Cloud תומך ב-webhooks דרך Connect apps או Forge. עבור Server/Data Center, השתמשו בתוספים או ב-webhooks מובנים (התקנה לפי תיעוד Confluence Server). תוכנת הביניים נרשמת לאירועים: Confluence (webhook) → Middleware → Б24 REST API → Задачи/Чат/Лента Б24 (задача/CRM) → Middleware → Confluence API → Поиск/Получение страниц , page_created, page_updated, page_removed. הודעות אוטומטיות נשלחות לצ'אטים של Bitrix24 בהתבסס על אירועים אלה. Confluence webhooks הם הטריגר המרכזי לעדכונים בזמן אמת.
אוטומציה של קישור תיעוד למשימות
תוכנת הביניים מבצעת אוטומציה של קישור תיעוד למשימות. שדה מותאם אישית comment_created במשימות Bitrix24 מאחסן את כתובת ה-URL של עמוד Confluence. תוכנת הביניים מחלצת UF_CONFLUENCE_URL מה-URL ומביאה מטא-דאטה (כותרת, מחבר, תאריך עדכון אחרון) דרך API. מיקום בכרטיס המשימה (אפליקציה מקומית של Bitrix24 content_id) מציג לשונית "תיעוד" עם רשימת עמודים מקושרים כולל כותרות עדכניות, סטטוסים ותצוגות מקדימות.
כאשר עמוד Confluence משתנה (webhook TASK_VIEW_TAB), תוכנת הביניים מוצאת את כל משימות Bitrix24 המקושרות לאותו עמוד ומוסיפה תגובה: "העמוד "{title}" עודכן על ידי {author} בתאריך {date}. קישור: {url}". זה מבטיח שסנכרון תיעוד המשימות נשאר מעודכן.
חיפוש Confluence מ-Bitrix24
תוכנת הביניים מספקת ממשק חיפוש ישירות ב-Bitrix24:
- המשתמש פותח ווידג'ט (או פקודת slash בצ'אט) ומזין שאילתת חיפוש.
- תוכנת הביניים קוראת ל-Confluence REST API לחיפוש Bitrix24 דרך
page_updated— חיפוש CQL (Confluence Query Language). - התוצאות מציגות כותרות, מרחבים ותאריכי עדכון.
- המשתמש לוחץ — הקישור נפתח ב-Confluence או מצורף למשימה הנוכחית.
עבור צ'אטבוטים של Bitrix24 — פקודה GET /wiki/rest/api/content/search?cql=text~"{query}", מחזירה 5 תוצאות חיפוש מובילות בפורמט הודעה.
אילו מצבי סנכרון תוכן זמינים?
שני מצבי סנכרון:
| מצב | תיאור | מקרה שימוש |
|---|---|---|
| ייחוס | רק קישור ומטא-דאטה מאוחסנים ב-Bitrix24. התוכן נקרא מ-Confluence. | תרחיש סטנדרטי |
| שיקוף | התוכן המלא מועתק למאגר הידע של Bitrix24 (סעיף "Knowledge"). | צוותים שעובדים בעיקר ב-Bitrix24 |
מצב שיקוף: בעדכון עמוד Confluence, תוכנת הביניים מבקשת תוכן דרך /wiki {запрос}, ממירה את Confluence Storage Format (דמוי XHTML) לפורמט Bitrix24, ויוצרת/מעדכנת מאמר במאגר הידע של Bitrix24 דרך Bitrix24 API. שיקוף מאגר הידע הזה מבטיח שכל התוכן נגיש בתוך Bitrix24.
שלבי העברת תוכן
להעברה מ-Confluence למאגר הידע של Bitrix24 (או להיפך), תוכנת הביניים תומכת בהעברה המונית להעברת תוכן מ-Confluence ל-Bitrix24:
- ייצוא עץ העמודים ממרחב Confluence דרך
GET /wiki/rest/api/content/{id}?expand=body.storageעם פגינציה. - המרת תוכן מ-Confluence Storage Format: טבלאות, מאקרו, קבצים מצורפים, תמונות.
- יצירת עמודים במאגר הידע של Bitrix24 תוך שמירה על היררכיה (הורה-ילד).
- העברת קבצים מצורפים: הורדה דרך
GET /wiki/rest/api/content?spaceKey={key}&type=page&limit=100, העלאה לדיסק Bitrix24.
מאקרו של Confluence (בלוקי קוד, פאנלי מידע, expand) מומרים למקבילות הקרובות ביותר ב-Bitrix24 או מוחלפים בבלוקי HTML.
הודעות שינוי
תוכנת הביניים מתרגמת אירועי Confluence לצ'אטים של Bitrix24:
- עמוד חדש במרחב הפרויקט → הודעה בצ'אט הפרויקט של Bitrix24.
- עדכון עמוד → הודעה למשתמשים רשומים (מיפוי צופים של Confluence → משתמשי Bitrix24).
- תגובה חדשה → הודעה למחבר המשימה המקושרת.
אימות
- Confluence Cloud: OAuth 2.0 דרך Atlassian Connect או API token (
GET /wiki/rest/api/content/{id}/child/attachmentב-Basic Auth). - Confluence Server/Data Center: Personal Access Token או Basic Auth.
- Bitrix24: OAuth 2.0 עם scope
email:token. - תוכנת הביניים מאחסנת אישורים מוצפנים. עבור Cloud, refresh token מתחדש אוטומטית.
| שיטת אימות | מערכת |
|---|---|
| OAuth 2.0 (Atlassian Connect) | Confluence Cloud |
| API Token (Basic Auth) | Confluence Cloud |
| Personal Access Token | Confluence Server/DC |
| OAuth 2.0 | Bitrix24 |
מה כלול
- פיתוח ופריסה של תוכנת ביניים לאינטגרציית Confluence–Bitrix24.
- הגדרת שדות מותאמים אישית ומיקומים במשימות Bitrix24.
- התקנת Webhook ועיבוד אירועים.
- יישום חיפוש ושיקוף תוכן.
- בדיקות ואופטימיזציה של ביצועים.
- תיעוד תפעולי והדרכת צוות.
- תמיכה לאחר פריסה.
עלות אינטגרציה טיפוסית: $1,500 – $3,000 בהתאם למורכבות. אינטגרציית Bitrix24 Confluence הטובה ביותר שלנו לקישור אוטומטי של תיעוד למשימות חוסכת לצוותים עד 10 שעות בשבוע.
צרו קשר להערכת פרויקט — נאמוד עלות ולוח זמנים תוך 1-2 ימים. הזמינו אינטגרציה סוהרת וחסלו העתקת קישורים ידנית.