פיתוח בוט צ'אט פנימי ל-Bitrix24

פיתוח בוט צ'אט פנימי ל-Bitrix24

תארו לעצמכם צוות מכירות של 12 מנהלים שמבזבז בממוצע 20 דקות ביום על חיפוש משימות ואנשי קשר ב-Bitrix24. בוט צ'אט פנימי יכול להפוך את השאילתות הללו לאוטומטיות, ולהגיב לפקודות כמו /сделки או /клиент תוך שניות. אנו מפתחים בוטים לצ'אט הפנימי של Bitrix24 מאפס: מהרישום במודול im ועד לארכיטקטורה אסינכרונית והרשאת OAuth.

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

מה בוט פנימי מציע בהשוואה לבוט מול לקוחות

בוט מול לקוחות פועל בערוצים פתוחים ומוגבל: אין לו גישה ל-CRM או למשימות. בוט פנימי, לעומת זאת, מקבל גישה מלאה לנתוני הפורטל דרך REST API, יכול להשתמש בהרשאות של משתמש ספציפי ולשלוח הודעות עשירות לצ'אטים קבוצתיים. הרישום מתבצע דרך /отпуск 15.07-28.07 ללא דגל /отчёт продажи июнь. זה הופך אותו ליעיל פי שלושה לאוטומציה של תהליכים פנימיים.

תרחישים אופייניים והיישום שלהם

בוט משאבי אנוש

עובד מקליד /тикет 1234 → הבוט יוצר בקשת חופשה דרך POST /rest/imbot.register { "CODE": "internal_helper", "EVENT_MESSAGE_ADD": "https://your-server.com/internal-bot/message", "EVENT_COMMAND_ADD": "https://your-server.com/internal-bot/command", "OPENLINE": "N" } , מודיע למנהל ומסמן ימים בלוח השנה דרך { "BOT_ID": 456, "COMMAND": "отчёт", "COMMON": "Y", "HIDDEN": "N", "EXTRANET_SUPPORT": "N", "LANG": [{"LANGUAGE_ID": "ru", "TITLE": "Отчёт по продажам", "PARAMS": "период"}] } . אין צורך לנווט בין סעיפי Bitrix24.

בוט דוחות

מנהל מקליד / → הבוט מבצע בקשת /сделки עם מסננים לפי תאריך ואחראי → יוצר סיכום ישירות בצ'אט: מספר עסקאות, סכום כולל, המרה לפי שלבים.

בוט תורנות

מנטר מערכות חיצוניות (שרת, אתר, תור משימות) → כאשר חריגה מספים, שולח התראה למהנדס התורן עם כפתורים "אושר", "הסלמה".

בוט helpdesk IT

עובד מתאר בעיה → הבוט יוצר משימה בפרויקט התמיכה הטכנית דרך /клиент [название], משייך מבצע לפי רוטציה ושולח את מספר הפנייה. ניתן לבדוק את סטטוס הפנייה עם /задачи.

רישום וטיפול בפקודות

הבוט נרשם עם מטפל פקודות:

POST /rest/imbot.register {
  "CODE": "internal_helper",
  "EVENT_MESSAGE_ADD": "https://your-server.com/internal-bot/message",
  "EVENT_COMMAND_ADD": "https://your-server.com/internal-bot/command",
  "OPENLINE": "N"
}

פקודות נרשמות דרך /звонок [телефон]:

{
  "BOT_ID": 456,
  "COMMAND": "отчёт",
  "COMMON": "Y",
  "HIDDEN": "N",
  "EXTRANET_SUPPORT": "N",
  "LANG": [
    {
      "LANGUAGE_ID": "ru",
      "TITLE": "Отчёт по продажам",
      "PARAMS": "период"
    }
  ]
}

לאחר הרישום, הפקודה מופיעה בהשלמה אוטומטית בצ'אט בעת הקלדת /. פרטים נוספים על REST API ניתן למצוא בתיעוד הרשמי.

מדריך רישום שלב אחר שלב

1. צרו אפליקציה ב-Bitrix24 (סעיף מפתחים).
2. קבלו את קוד האפליקציה והגדירו מטפלי אירועים.
3. בצעו imbot.register עם מטפל השרת שלכם.
4. רשמו פקודות דרך imbot.command.register עם פרמטרים.
5. הגדירו עיבוד webhook והחזירו 200 OK.

מקרה בוחן: בוט למחלקת מכירות

משימה: 12 מנהלים שואלים לעתים קרובות "כמה עסקאות פתוחות יש לי", "מתי היה הקשר האחרון עם לקוח X", "מה המשימות של היום". הלקוח — חברה עם למעלה מ-500 עסקאות בחודש.

יישום: Python (FastAPI) + REST API של Bitrix24. פקודות:

• /deals → רשימת עסקאות פתוחות של מנהל עם סכומים ושלבים.
• /client [name] → חיפוש איש קשר עם פעילות אחרונה.
• /tasks → משימות היום עם מועדים.
• /call [phone] → ייזום שיחה יוצאת.

הרשאה: הבוט משתמש בטוקן של המשתמש המתקבל דרך OAuth במגע ראשון. טוקנים נשמרים ב-Redis עם TTL של 30 יום.

חיסכון: 15–20 דקות למנהל ביום, מה שמתורגם בשכר ממוצע להפחתה של 30% בעלויות שגרתיות. העומס מינימלי — 3–5 בקשות API לפקודה. תקופת החזר: פחות מחודש.

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

מדוע עיבוד אסינכרוני הוא חובה

שירות הבוט חייב להגיב ל-webhook של Bitrix24 תוך 3 שניות. אחרת, Bitrix24 מחשיב את הבקשה כלא מוצלחת וחוזר עליה, מה שמוביל להודעות כפולות. עיבוד אסינכרוני מפחית כפילויות פי 10 בהשוואה לגישה סינכרונית.

ארכיטקטורה נכונה:

1. ה-webhook מקבל את הבקשה ומחזיר מיד 200 OK.
2. המשימה מוכנסת לתור (Redis Queue, RabbitMQ).
3. עובד מעבד את המשימה באופן אסינכרוני ומשיב דרך imbot.message.add.

הערכת מאמץ

מה כלול בעבודה?

• מחזור מלא: ביקורת תרחישים, אב-טיפוס, פיתוח, בדיקות, פריסה.
• תיעוד לפקודות ולפעולות.
• הגדרת ניטור והתראות.
• הדרכת מנהלים.
• אחריות על הקוד למשך 6 חודשים.

קבלו ייעוץ על הארכיטקטורה של הבוט שלכם — המהנדסים שלנו מוסמכי 1C-Bitrix עם ניסיון של 5+ שנים בפיתוח בוטים. צרו קשר — נעריך את הפרויקט שלכם תוך יום אחד.