Виджет «Позвонить в поддержку»

Кнопка звонка из браузера на сайте. Звонок идёт через сервер webrtc.alexcr.ru; нужен только микрофон и HTTPS.

Скачать архив (.zip) Попробовать демо widget.js

Как это работает

  1. Пользователь нажимает «Позвонить», браузер просит доступ к микрофону.
  2. Виджет обращается к бэкенду вашего сайта. Бэкенд с секретным ключом запрашивает у сервера звонков одноразовую сессию.
  3. Виджет открывает защищённое соединение с wss://webrtc.alexcr.ru/ws и звонит. После завершения соединение закрывается, сессия удаляется.

Установка

  1. Получите доступ. Сообщите администратору сервера звонков адрес сайта (например, https://alexcr.ru): без этого сервер отклонит соединение. Получите API-ключ.
  2. Сделайте эндпоинт на бэкенде POST /support/call-session. Он берёт ID и имя авторизованного пользователя, вызывает API и отдаёт ответ браузеру. Ключ нельзя отдавать в браузер.
  3. Подключите скрипты и повесьте вызовы на кнопки.

1. Бэкенд: выдача сессии

<?php
session_start();
header('Content-Type: application/json; charset=utf-8');
$userId = $_SESSION['user_id'] ?? null;          // ваш авторизованный пользователь
if (!$userId) { http_response_code(401); exit('{"error":"login required"}'); }

$ch = curl_init('https://webrtc.alexcr.ru/api/webrtc/session');
curl_setopt_array($ch, [
  CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 5,
  CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'X-Api-Key: ' . getenv('WEBRTC_API_KEY')],
  CURLOPT_POSTFIELDS => json_encode(['user_id' => (int)$userId,
                                    'display_name' => $_SESSION['user_name'] ?? 'Клиент'], JSON_UNESCAPED_UNICODE),
]);
$body = curl_exec($ch);
http_response_code($body === false ? 502 : curl_getinfo($ch, CURLINFO_RESPONSE_CODE));
echo $body === false ? '{"error":"upstream"}' : $body;

2. Страница: кнопки

<button id="support-call">Позвонить в поддержку</button>
<button id="support-hangup" disabled>Завершить</button>
<span id="support-status"></span>

<script src="https://webrtc.alexcr.ru/jssip.min.js"></script>
<script src="https://webrtc.alexcr.ru/widget.js"></script>
<script>
  const btnCall = document.getElementById('support-call');
  const btnHang = document.getElementById('support-hangup');
  const FINAL = ['ended', 'failed', 'busy', 'mic-denied'];

  const call = new SupportCall({
    getSession: () => fetch('/support/call-session', { method: 'POST', credentials: 'include' })
                        .then(r => { if (!r.ok) throw new Error(r.status); return r.json(); }),
    onStatus: (code, text) => {
      document.getElementById('support-status').textContent = text;
      const done = FINAL.includes(code);
      btnCall.disabled = !done;
      btnHang.disabled = done;
    }
  });
  btnCall.onclick = () => { btnCall.disabled = true; btnHang.disabled = false; call.start(); };
  btnHang.onclick = () => call.hangup();
  addEventListener('beforeunload', () => call.hangup());
</script>

Скрипты можно загружать с webrtc.alexcr.ru (обновления приходят сами) или положить файлы из архива на свой сайт.

API виджета

Метод / параметрНазначение
new SupportCall({ getSession, onStatus, audioElement })getSession — обязателен, возвращает Promise с JSON сессии от вашего бэкенда. onStatus(code, text) — статус для интерфейса. audioElement — свой <audio> (иначе создаётся скрытый).
call.start()Запросить микрофон, получить сессию, позвонить.
call.hangup()Завершить звонок.
call.isActive()Идёт ли звонок.

Коды статуса: mic, session, calling, ringing, in-call — промежуточные; ended, busy, failed, mic-denied — финальные. В text готовая фраза на русском.

Требования

Сейчас вместо операторов включён эхо-тест: после приветствия вы слышите свой голос 2 минуты.

В архиве: widget.js, jssip.min.js (JsSIP 3.11.1, MIT), example.html, примеры бэкенда на PHP / Node.js / Python, README.