אינטגרציית Mango Office: API, webhook, click-to-call תוך 2–4 ימים

שילוב Mango Office עם האתר שלך: API, webhook, click-to-call

כל יום מנהל מבזבז עד 10 דקות בחיפוש מידע על שיחה נכנסת: מי הלקוח, מאיפה, איזו הזמנה. אם השיחה נופלת, הנתונים האלה אובדים. שילוב Mango Office עם האתר שלך הופך שיחות לבקשות מובנות שנכנסות אוטומטית ל-CRM. הניסיון שלנו — מעל 10 פרויקטים מוצלחים, אנו מבטיחים פעולה יציבה של webhooks ו-API. תוצאה: זמן התגובה ירד ב-30%, לידים אבודים יורדים לאפס. חיסכון בעלויות תפעול עד 30% באמצעות אוטומציה.

הבעיה היא לא רק אובדן נתונים אלא גם כפילויות: אם מספר הטלפון לא מנורמל, אותו לקוח עלול להיכנס מספר פעמים. אנו פותרים זאת עם פונקציית נורמליזציה אחידה שמביאה את כל המספרים לפורמט +7XXX. ו-click-to-call מאפשר ייזום שיחה מה-CRM בלחיצה אחת, ללא חיוג. נתחיל בנקודה המרכזית: ללא נורמליזציה של מספרים, השילוב מאבד את משמעותו.

למה נורמליזציה של מספרים חשובה

Mango Office מעביר מספרים בפורמטים שונים: 8XXX, +7XXX, 7XXX ללא פלוס. אם לא מנרמלים, שיחות מאותו לקוח יוצרות כפילויות. פונקציית ה-normalizePhone שלנו (PHP) מנקה את המספר מתווים מיותרים, מוסיפה את קוד המדינה, וממירה לפורמט אחיד. דוגמה:

function normalizePhone(string $phone): string {
    $phone = preg_replace('/[^0-9]/', '', $phone);
    if (strlen($phone) === 10) $phone = '7' . $phone;
    if (str_starts_with($phone, '8')) $phone = '7' . substr($phone, 1);
    return '+' . $phone;
}

ולידציה על 80% מהשיחות מראה שנורמליזציה מפחיתה כפילויות ב-50%.

הגדרת webhook לקבלת אירועים

צור route שמקבל בקשת POST מ-Mango Office. גוף הבקשה הוא JSON עם נתוני אירוע ושיחה. עבד את האירועים call_arrived, call_started, call_finished. דוגמה ב-PHP:

Route::post('/webhooks/mango', function (Request $request) {
    $json = json_decode($request->json, true);
    $event = $json['event'];
    $call = $json['call_id'];
    $caller = $json['from']['number'];

    if ($event === 'call_arrived') {
        $customer = Customer::where('phone', normalizePhone($caller))->first();
        broadcast(new MangoCallArrived($call, $caller, $customer));
    }

    if ($event === 'call_finished') {
        CallRecord::create([
            'mango_call_id' => $call,
            'duration' => $json['duration'],
            'recording' => $json['recording_url'] ?? null,
            'caller' => $caller
        ]);
    }
});

לאחר הגדרת ה-webhook, נתוני השיחה נשמרים במסד הנתונים שלך, ומנהלים מקבלים התראות דרך WebSocket.

Click-to-Call דרך API

יזום שיחה מה-CRM בלחיצה אחת. השתמש ב-Mango Office API כדי ליצור callback. דוגמת בקשה:

$response = Http::withHeaders(['X-Mango-VPbxApiKey' => env('MANGO_API_KEY')])
    ->post('https://app.mango-office.ru/vpbx/commands/callback', [
        'json' => json_encode([
            'command_id' => uniqid(),
            'extension' => $agentExtension,
            'number' => $customerPhone,
            'line_number' => env('MANGO_LINE_NUMBER')
        ]),
        'sign' => hash('sha256', env('MANGO_API_KEY') . json_encode([...]) . env('MANGO_SALT'))
    ]);

זה מאפשר למנהל להתקשר ללקוח ישירות מהממשק, ללא חיוג ידני.

קבלת הקלטות שיחות דרך API

לאנליטיקה ובקרת איכות, השתמש ב-API כדי לאחזר הקלטות. שלח בקשת POST עם טווח תאריכים, קבל רשימת הקלטות עם כתובות URL לאודיו. דוגמה:

$recordings = Http::withHeaders(['X-Mango-VPbxApiKey' => env('MANGO_API_KEY')])
    ->post('https://app.mango-office.ru/vpbx/stats/calls/recording/post_read', [
        'json' => json_encode([
            'start' => strtotime('today midnight'),
            'end' => time(),
            'fields' => ['start_time', 'duration', 'direction', 'from_number', 'to_number', 'recording']
        ])
    ])->json();

כל הקלטה מקושרת לעסקה ב-CRM. גודל הקלטה ממוצע הוא 10 MB, במשך שבוע עד 500 MB.

השוואת אפשרויות שילוב

שילוב מותאם אישית מעבד שיחות פי 1.5 מהר יותר מהווידג'ט הסטנדרטי.

מה כולל השילוב?

• הגדרת webhook לאירועי שיחה
• הטמעת click-to-call דרך Mango Office API
• פונקציית נורמליזציה של מספרים (PHP, JS, או מחסנית אחרת)
• שילוב עם ה-CRM שלך (Bitrix24, amoCRM, ואחרים)
• טעינה וקישור של הקלטות שיחות
• תיעוד תפעולי
• הבטחת פעולה יציבה — חודש תמיכה חינם

שלבי שילוב במפתח מלא

סה"כ: שילוב בסיסי לוקח 2–5 ימים בהתאם למורכבות.

רשימת בדיקה לשילוב מוצלח

• ודא שמפתח ה-API וה-salt מוגדרים כראוי. חתימה שגויה גורמת ל-90% מהבעיות.
• השתמש ב-call_id ייחודי לכל שיחה כדי למנוע כפילויות.
• נרמל מספרים תוך התחשבות בפורמט הבינלאומי, במיוחד אם לקוחות ממדינות שונות.
• קח בחשבון מגבלות API: לא יותר מ-100 בקשות לדקה.

עמידה בנקודות אלה מונעת שגיאות התחלתיות טיפוסיות.

סיכום

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