Demego Meeting Recording Bot — Quản Trị Trực Tuyến

Bot Đang Hoạt Động

0 / 10

Trình duyệt thật & Ghi âm

Định Danh Của Bot

Demego Bot Recorder

⚪ Khách ẩn danh

Dự Án Kết Nối (Keys)

Multi-Tenant API Key

Bản Ghi Âm Hoàn Tất

RAM: -- MB

👤 Định Danh & Tài Khoản Google Bot

⚪ Chế độ Khách ẩn danh

Mặc định Bot hoạt động ở Chế độ Khách (tự điền tên và xin vào phòng). Nếu muốn Bot vào thẳng (Join now) qua Google Calendar không cần duyệt, hãy đăng nhập tài khoản Google.

🚀 Nhập Link Google Meet & Gọi Bot Vào Phòng

Bot mở trình duyệt thật, tự động gõ tên và xin vào phòng họp. Chủ trì (Host) trong Meet sẽ nhận thông báo để bấm Chấp nhận (Admit).

Đường dẫn phòng họp Google Meet *

Tên hiển thị của Bot khi xin vào

Tiêu đề (Tùy chọn)

👑 Chủ trì (Host Name & Email - Tùy chọn)

👥 Đồng chủ trì (Co-hosts Emails - Phân cách bằng dấu phẩy)

🎙️ Phiên âm Tiếng Việt sau khi họp xong (Qwen3-ASR ONNX)

⏱️ Tự rời phòng khi chỉ còn Bot (sau 60s) ⚡ Tiết kiệm RAM

📡 Trạng Thái Thực Tế Trong Phòng Họp & Màn Hình Quan Sát Bot

Mọi trạng thái dưới đây được đọc trực tiếp 100% từ màn hình Google Meet thực tế (tự động cập nhật mỗi 3 giây).

Tổng Bản Ghi Âm

0 bản ghi

0 tệp (.wav / .txt)

Tổng Dung Lượng

0 KB

Audio: 0 • TXT: 0

Tự Động Xóa Bật

Sau: ngày

Quét mỗi 6 giờ

Dọn Dẹp Thủ Công

Chưa có lượt dọn nào

🎧 Kho Bản Ghi Âm Cuộc Họp

Hiển thị theo giờ địa phương (Local Time). Bấm "▶️ Nghe lại" để phát thanh cố định ở đáy màn hình.

🕒 Giờ địa phương

📨 Nhật Ký Bắn Webhook Tự Động Về Hệ Thống Đích

Hiển thị theo giờ địa phương (Local Time)

➕ Cấp Phát API Key Cho Dự Án Kết Nối Mới

Tên Dự Án / Hệ Thống *

Webhook URL Mặc Định (Nhận file Audio)

Mô tả ngắn

🔑 Danh Sách Các Dự Án & API Keys Đang Hoạt Động

🌾

Hướng Dẫn Tích Hợp API Cho Dự Án "Thần Nông - BO" & Bên Thứ 3

Bộ tài liệu REST API & Webhook Gateway chuẩn hóa giúp hệ thống Thần Nông - BO điều động Bot ghi âm và nhận tệp tự động.

🛡️ Nguyên tắc Bảo mật Cô lập Dữ liệu (Multi-Tenant Isolation):

Mỗi dự án kết nối (như Thần Nông - BO) được cấp riêng một cặp API Key (mrb_live_...) và Webhook Secret (whsec_...).

Tất cả tệp ghi âm thuộc dự án Thần Nông - BO chỉ có thể được tải bằng API Key của Thần Nông. Hệ thống sẽ từ chối với lỗi 403 Forbidden nếu bất kỳ bên thứ 3 nào khác cố tình truy cập chéo.

1 Điều động Bot vào phòng họp Google Meet

POST /api/v1/sessions/start

Hệ thống Thần Nông - BO gọi API này khi người dùng nhấn "Ghi âm cuộc họp". Bot sẽ mở Chromium, tắt Mic/Cam, tự động điền tên và bấm "Ask to join".

Mẫu Request Payload (JSON):

curl -X POST "http://localhost:3056/api/v1/sessions/start" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: <API_KEY_THẦN_NÔNG_BO>" \
  -d '{
    "meetingUrl": "https://meet.google.com/ssp-skjm-dqz",
    "meetingTitle": "Họp Giao Ban Thần Nông BO #12",
    "botName": "Trợ lý ghi âm Thần Nông",
    "externalMeetingId": "tn_meet_1029",
    "host": {
      "name": "Nguyễn Văn A",
      "email": "a.nguyen@demego.vn"
    },
    "coHosts": [
      "b.tran@demego.vn",
      "c.le@demego.vn"
    ],
    "webhookUrl": "https://than-nong-bo.demego.vn/api/v1/webhooks/bot-recording"
  }'

2 Kiểm tra trạng thái trực tiếp của Bot trong phòng họp

GET /api/v1/sessions/:id

Thần Nông - BO có thể thăm dò trạng thái trực tiếp của phiên. Các trạng thái gồm: LAUNCHING (đang mở trình duyệt) → WAITING_ADMIT (đang ở phòng chờ, nhắc Host bấm Admit) → RECORDING (đã vào phòng, đang ghi âm) → COMPLETED (kết thúc và đã xuất file WAV).

Mẫu Request cURL:

curl -X GET "http://localhost:3056/api/v1/sessions/rec_e1373696ebeb" \
  -H "X-API-Key: <API_KEY_THẦN_NÔNG_BO>"

3 Chủ động dừng phiên họp & xuất file âm thanh

POST /api/v1/sessions/:id/stop

Khi cuộc họp kết thúc hoặc người dùng nhấn "Dừng ghi âm", Thần Nông - BO gọi API này để yêu cầu Bot rời cuộc gọi, hoàn tất file WAV và kích hoạt Webhook trả về.

Mẫu Request cURL:

curl -X POST "http://localhost:3056/api/v1/sessions/rec_e1373696ebeb/stop" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: <API_KEY_THẦN_NÔNG_BO>" \
  -d '{"reason": "Người dùng kết thúc cuộc họp trên Thần Nông BO"}'

4 Tiếp nhận Webhook Callback & Xác thực Chữ Ký HMAC-SHA256

X-MRB-Signature

Khi file ghi âm sẵn sàng, Bot gửi HTTP POST tới webhookUrl của Thần Nông - BO kèm chữ ký mã hóa để chứng minh gói tin xuất phát từ server Bot tin cậy.

Mã nguồn xác thực Webhook trong Node.js / NestJS (Thần Nông BO):

import crypto from 'crypto';

function verifyMeetingBotWebhook(rawBody: string, signatureHeader: string, webhookSecret: string): boolean {
  if (!signatureHeader || !signatureHeader.startsWith('sha256=')) return false;
  const signature = signatureHeader.slice(7);
  const expectedSignature = crypto.createHmac('sha256', webhookSecret).update(rawBody).digest('hex');
  return crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expectedSignature));
}

5 Tải file âm thanh WAV chất lượng cao (PCM 16-bit 16kHz)

GET /api/v1/sessions/:id/audio

Tải tệp âm thanh trực tiếp về hệ thống Thần Nông - BO để lưu trữ MinIO. Bắt buộc truyền X-API-Key trong Header hoặc Query parameter ?api_key=....

Mẫu tải file bằng cURL hoặc nhúng trình phát âm thanh:

# Cách 1: Tải file qua Header X-API-Key
curl -O -H "X-API-Key: <API_KEY_THẦN_NÔNG_BO>" "http://localhost:3056/api/v1/sessions/rec_e1373696ebeb/audio"

# Cách 2: Nhúng vào thẻ HTML5 Audio trên trang Frontend Thần Nông BO
<audio controls src="http://localhost:3056/api/v1/sessions/rec_e1373696ebeb/audio?api_key=<API_KEY_THẦN_NÔNG_BO>"></audio>

6 Tự động nhận diện STT (Qwen3-ASR 0.6B) & Lấy văn bản cuộc họp (JSON / TXT)

GET /api/v1/sessions/:id/transcript

Nếu ở Bước 1 truyền cờ "enableStt": true, sau khi ghi âm xong Bot sẽ tự động chạy mô hình mã nguồn mở Qwen3-ASR 0.6B ONNX CPU để chuyển đổi thành văn bản Tiếng Việt chuẩn xác (kèm mốc thời gian từng câu) và bắn Webhook session.transcription_completed. Bạn cũng có thể kích hoạt dịch thủ công bất kỳ lúc nào qua POST /api/v1/sessions/:id/transcribe.

Mẫu lấy toàn văn bản cuộc họp (TXT) hoặc phân đoạn (JSON):

# Lấy kết quả dạng JSON (fullText + segments có mốc thời gian)
curl -H "X-API-Key: <API_KEY_THẦN_NÔNG_BO>" "http://localhost:3056/api/v1/sessions/rec_e1373696ebeb/transcript"

# Tải thẳng file văn bản thuần túy (.txt)
curl -H "X-API-Key: <API_KEY_THẦN_NÔNG_BO>" "http://localhost:3056/api/v1/sessions/rec_e1373696ebeb/transcript?format=txt" -o cuoc_hop.txt

Đăng Nhập Quản Trị Viên

MEETING-RECORDING-BOT