שילוב 1C-Bitrix עם amoCRM למשפך מכירות אחיד

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

למה אינטגרציה מותאמת אישית של 1C-Bitrix ו-amoCRM אמינה יותר ממודולים מוכנים?

אינטגרציה מותאמת אישית דרך API אמינה פי 5 ממודולים מוכנים בזכות שליטה מלאה בטיפול בשגיאות. נבחן את הארכיטקטורה, פרוטוקול OAuth 2.0, זרימות נתונים אופייניות ומלכודות. הזנת נתונים ידנית עולה כ-$1,200 בחודש לכל מנהל מכירות; אינטגרציה מבטלת את זה.

זרימות נתונים

הזרימה העיקרית היא הזמנות ולידים מ-Bitrix ל-amoCRM. הזרימה ההפוכה (סטטוסים) נחוצה אם האתר כולל אזור אישי עם מעקב אחר עיבוד הזמנות.

כיצד בנוי ה-API של amoCRM v4?

amoCRM משתמש ב-OAuth 2.0 עם refresh token ארוך טווח. לאחר הרשאת גישה (הגדרות → אינטגרציות ב-amoCRM) מקבלים client_id, client_secret, redirect_uri. החלפת הקוד הראשונית ל-token היא זרימת OAuth סטנדרטית. ה-refresh token מתחדש בכל רענון של access token (אורך חיי ה-access token הוא 20 דקות).

אחסון ה-token ב-Bitrix: טבלת מודול b_option או טבלה נפרדת. יש להצפין או לאחסן מחוץ לספרייה הציבורית. שמרו את ה-access token במטמון בזמן ריצה, וקראו ל-refresh רק על 401.

כתובת API בסיסית: https://{subdomain}.amocrm.ru/api/v4/. נקודות קצה מרכזיות:

• POST /leads — יצירת עסקה (ליד).
• POST /contacts — יצירת איש קשר.
• POST /leads/complex — יצירת עסקה עם איש קשר וחברה בבקשה אחת. שיטה מומלצת — פעולה אטומית.
• GET /leads/{id} — קבלת עסקה.
• PATCH /leads/{id} — עדכון עסקה (שינוי שלב, הוספת שדה).
• POST /catalogs/{catalog_id}/elements — מוצרים בקטלוג amoCRM.

מגבלות: 7 בקשות בשנייה לחשבון. בחריגה — HTTP 429 עם כותרת Retry-After.

איך לסנכרן הזמנות מ-Bitrix ל-amoCRM?

יצירת עסקה בעת ביצוע הזמנה

Handler לאירוע OnSaleOrderSaved (מודול sale):

use Bitrix\Main\EventManager; EventManager::getInstance()->addEventHandler( 'sale', 'OnSaleOrderSaved', ['AmoCrmIntegration', 'onOrderSaved'] ); 

המתודה use Bitrix\Main\EventManager; EventManager::getInstance()->addEventHandler( 'sale', 'OnSaleOrderSaved', ['AmoCrmIntegration', 'onOrderSaved'] ); מחלצת את נתוני ההזמנה ומרכיבה בקשה ל-amoCRM:

1. חיפוש איש קשר — onOrderSaved. אם נמצא — השתמשו ב-ID שלו. אם לא — צרו חדש.
2. יצירת עסקה — GET /contacts?query={phone_or_email} עם קישור איש קשר, כותרת 'הזמנה #{ORDER_ID}', סכום, תגי UTM בשדות מותאמים אישית.

טבלת מיפוי שדות הזמנה:

תגי UTM — משימה נפרדת. Bitrix לא שומר UTM בהזמנה כברירת מחדל. יש ללכוד אותם בצד הלקוח (JavaScript), לשמור בעוגייה או ב-contacts[0].custom_fields, ובעת ההזמנה לכתוב למאפיינים ($_SESSION, PROPERTY_UTM_SOURCE וכו'). משם לשדות מותאמים אישית של עסקת amoCRM.

סנכרון סטטוסים הפוך

amoCRM תומך ב-webhooks — בשינוי שלב עסקה הוא שולח POST לכתובת שצוינה. צרו handler PROPERTY_UTM_MEDIUM:

1. קבלת POST מ-amoCRM (מערך /local/tools/amocrm_webhook.php).
2. חילוץ העסקה leads[status][0] ו-id (מזהה שלב במשפך).
3. איתור הזמנת Bitrix לפי מזהה עסקה (דרך שדה הזמנה מותאם אישית status_id או טבלת מיפוי).
4. עדכון סטטוס הזמנה דרך id → PROPERTY_AMO_LEAD_ID → \Bitrix\Sale\Order::load($orderId).

מיפוי סטטוסי משפך amoCRM לסטטוסי הזמנת Bitrix נשמר בתצורה: מערך setField('STATUS_ID', $mappedStatus). אבטחת webhook: amoCRM לא חותם על בקשות. בדקו את כתובת ה-IP של השולח (רשימת IP של amoCRM במסמכים) או השתמשו בפרמטר סודי בכתובת ה-URL.

טיפול בטפסי אתר

טפסי יצירת קשר, callback, פניות — כולם לידים. שתי גישות:

1. דרך טפסי Bitrix — handler save() של מודול [amo_status_id => bitrix_status_id] או OnAfterResultAdd יוצר עסקה ב-amoCRM.
2. דרך טפסי amoCRM — ווידג'ט JS באתר, נתונים עוברים ישירות ל-CRM, עוקפים את Bitrix. פשוט יותר אבל מאבד את הקשר עם Bitrix.

המלצה — האפשרות הראשונה. נתונים נשמרים תחילה ב-Bitrix (אחסון אמין), ואז נשלחים אסינכרונית ל-amoCRM.

מה עושים בשגיאות API? תור וטיפול בשגיאות

ה-API של amoCRM עלול להיות לא זמין (HTTP 500, 429, שגיאת רשת). תור לשליחת הזמנות ולידים:

טבלה form עם שדות OnAfterFormResultAdd, amocrm_queue (ליד/הזמנה/סטטוס), id (JSON), type, payload, attempts, status.

Agent או סקריפט cron מעבדים את התור כל דקה. בשגיאה — הגדלת last_error, כש-created_at — הגדרת attempts, שליחת התראה.

מה כלול בעבודת האינטגרציה

• בדיקת תהליכים עסקיים ונתונים קיימים.
• הגדרת אינטגרציית OAuth ואחסון מאובטח של tokens.
• פיתוח העברת הזמנות, לידים ואנשי קשר.
• איסוף והעברת תגי UTM.
• Webhook לסנכרון סטטוסים הפוך.
• תור בקשות עם ניסיונות חוזרים.
• תיעוד ארכיטקטורת האינטגרציה והלוגיקה.
• הדרכת עובדים לעבודה עם המשפך האחיד.
• תמיכה לאחר ההשקה (חודש אחד של ניהול תקלות).

לוחות זמנים ועלות

העלות הממוצעת של פרויקט נעה בין $3,000 ל-$7,000 בהתאם למורכבות. אינטגרציה מוצלחת מפחיתה את זמן טיפול בלידים ב-40% ושיעור השגיאות יורד מ-15% ל-0.5%.

שאלות נפוצות

אנחנו צוות של מומחים מוסמכים עם ניסיון של 10+ שנים ב-Bitrix ו-amoCRM. יש לנו למעלה מ-50 אינטגרציות מוצלחות מאחורינו. אנו מבטיחים פעולה יציבה ומספקים תמיכה לאחר ההשקה. צרו קשר כדי לדון בפרויקט שלכם. קבלו ייעוץ כבר עכשיו.