Виджет «Позвонить в поддержку»
Кнопка звонка из браузера на сайте. Звонок идёт через сервер webrtc.alexcr.ru; нужен только микрофон и HTTPS.
Как это работает
- Пользователь нажимает «Позвонить», браузер просит доступ к микрофону.
- Виджет обращается к бэкенду вашего сайта. Бэкенд с секретным ключом запрашивает у сервера звонков одноразовую сессию.
- Виджет открывает защищённое соединение с
wss://webrtc.alexcr.ru/wsи звонит. После завершения соединение закрывается, сессия удаляется.
Установка
- Получите доступ. Сообщите администратору сервера звонков адрес сайта (например,
https://alexcr.ru): без этого сервер отклонит соединение. Получите API-ключ. - Сделайте эндпоинт на бэкенде
POST /support/call-session. Он берёт ID и имя авторизованного пользователя, вызывает API и отдаёт ответ браузеру. Ключ нельзя отдавать в браузер. - Подключите скрипты и повесьте вызовы на кнопки.
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;
// Express, Node 18+
app.post('/support/call-session', requireLogin, async (req, res) => {
try {
const r = await fetch('https://webrtc.alexcr.ru/api/webrtc/session', {
method: 'POST',
headers: { 'Content-Type': 'application/json', 'X-Api-Key': process.env.WEBRTC_API_KEY },
body: JSON.stringify({ user_id: Number(req.user.id), display_name: String(req.user.name) }),
signal: AbortSignal.timeout(5000),
});
res.status(r.status).type('application/json').send(await r.text());
} catch { res.status(502).json({ error: 'upstream' }); }
});
# Flask
@app.post("/support/call-session")
def call_session():
user_id = session.get("user_id")
if not user_id:
return jsonify(error="login required"), 401
r = requests.post("https://webrtc.alexcr.ru/api/webrtc/session",
headers={"X-Api-Key": os.environ["WEBRTC_API_KEY"]},
json={"user_id": int(user_id), "display_name": session.get("user_name", "Клиент")},
timeout=5)
return Response(r.content, status=r.status_code, mimetype="application/json")
curl -s https://webrtc.alexcr.ru/api/webrtc/session \
-H "X-Api-Key: $WEBRTC_API_KEY" -H 'Content-Type: application/json' \
-d '{"user_id": 12345, "display_name": "Иван Петров"}'
# 200 {"wss","domain","user","password","exten":"support","iceServers","expires_at"}
# 409 у пользователя уже есть сессия или идёт звонок
# 429 больше 5 сессий в минуту на пользователя
# 401 неверный ключ, 422 неверные данные
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 готовая фраза на русском.
Требования
- Сайт по HTTPS — иначе браузер не даст микрофон.
- Если есть Content-Security-Policy:
connect-src wss://webrtc.alexcr.ruи, при загрузке скриптов отсюда,script-src https://webrtc.alexcr.ru. - Если страница во
<iframe>:<iframe allow="microphone">. - Браузеры: актуальные Chrome, Edge, Firefox, Safari (включая iOS).
Сейчас вместо операторов включён эхо-тест: после приветствия вы слышите свой голос 2 минуты.
В архиве: widget.js, jssip.min.js (JsSIP 3.11.1, MIT), example.html, примеры бэкенда на PHP / Node.js / Python, README.