Интеграция IP-телефонии Манго Офис на сайт

Интеграция IP-телефонии Манго Офис на сайт

Манго Офис — российская виртуальная АТС для бизнеса. Предоставляет облачную телефонию, запись разговоров, аналитику и API для интеграции с сайтом и CRM.

Что даёт интеграция

• Попап с данными клиента при входящем звонке (менеджер видит, кто звонит)
• Click-to-call: кнопка звонка прямо в карточке клиента или заказе
• История звонков привязана к заказу/клиенту
• Маршрутизация: в зависимости от страницы или товара — разный отдел

Webhook при звонке

Манго Офис отправляет POST-запросы при событиях звонка (входящий, ответ, завершение):

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();
        // Уведомить менеджера через WebSocket
        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
        ]);
    }
});

Click-to-Call через API

$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'))
    ]);

Получение записей разговоров

$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();

Нормализация номеров

Ключевой вопрос — нормализация телефонов для поиска клиента. Манго передаёт номера в разных форматах, в БД могут храниться по-разному. Единая функция нормализации:

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;
}

Срок интеграции: 2–4 дня для полной интеграции с попапом, click-to-call и историей звонков.