Інтеграція IP-телефонії Zadarma на сайт

Інтеграція IP-телефонії Zadarma на сайт

Zadarma — міжнародний постачальник IP-телефонії з віртуальною АТС (ZCRM), номерами в 100+ країнах та WebRTC-клієнтом для браузера. Хороший варіант для компаній з міжнародними клієнтами.

Webhook сповіщення

Route::post('/webhooks/zadarma', function (Request $request) {
    // Перевірка підпису
    $data  = $request->except('sign');
    ksort($data);
    $sign  = md5(http_build_query($data) . env('ZADARMA_SECRET'));
    if ($request->sign !== $sign) return response('Invalid sign', 403);

    $event = $data['event'];

    switch ($event) {
        case 'NOTIFY_START':
            // Вхідний дзвінок
            $caller = $data['caller_id'];
            $this->handleIncomingCall($caller);
            break;

        case 'NOTIFY_END':
            // Дзвінок завершений
            CallLog::create([
                'zadarma_callid'  => $data['call_id_with_rec'],
                'caller'          => $data['caller_id'],
                'duration'        => $data['duration'],
                'disposition'     => $data['disposition']  // answered | noanswer | busy
            ]);
            break;

        case 'NOTIFY_RECORD':
            // Запис готовий
            $recordingUrl = $data['link'];
            CallLog::where('zadarma_callid', $data['call_id_with_rec'])
                   ->update(['recording_url' => $recordingUrl]);
            break;
    }
});

API — Ініціація зворотного дзвінка

// Zadarma REST API v1
$params = [
    'from'      => $agentPhone,  // номер у системі Zadarma
    'to'        => $customerPhone,
    'sip_id'    => env('ZADARMA_SIP_ID')
];
ksort($params);
$sign = base64_encode(hash_hmac(
    'sha1',
    env('ZADARMA_KEY') . urldecode(http_build_query($params)) . md5(serialize($params)),
    env('ZADARMA_SECRET')
));

Http::withHeaders([
    'Authorization' => env('ZADARMA_KEY') . ':' . $sign
])->get('https://api.zadarma.com/v1/request/callback/', $params);

WebRTC дзвінок з браузера

Zadarma надає WebRTC-бібліотеку для дзвінків прямо з браузера:

<script src="https://my.zadarma.com/webphoneApi/v3/js/zadarmawebrtc.js"></script>
<script>
var webrtcPhone = new ZadarmaWebRTC({
    sipId:    '{{ $sipId }}',
    sipPass:  '{{ $sipPassword }}',
    onCallStateChange: function(state, data) {
        console.log('Call state:', state);
    }
});
webrtcPhone.dial('79001234567');
</script>

Отримання записів

// Завантажити запис розмови
$response = Http::get('https://api.zadarma.com/v1/pbx/record/request/', [
    'call_id'    => $zadarmaCallId,
    'pbx_call_id'=> $pbxCallId
]);
$downloadUrl = $response->json()['link'];

Строк інтеграції: 2–3 дні для повної інтеграції з webhooks та click-to-call.