Build on the exact feed
Те же живые события, что использует дашборд, — пушатся в момент, когда происходят.
import { createClient } from "@supabase/supabase-js";
const supabase = createClient("https://api.busymate.net", PUBLISHABLE_KEY, {
global: { headers: { Authorization: `Bearer ${oauthToken}` } },
});
supabase
.channel("ws:<workspace_id>")
.on("broadcast", { event: "entry" }, ({ payload }) => {
console.log("new request", payload.method, payload.url, payload.status);
})
.subscribe();Push,
Пуш-модель от края до края. Подписывайтесь из своего кода на изменения трафика, состояния и аудита.
Файерхоз записей
Каждый захваченный запрос транслируется в момент прибытия — ровно в тот канал, который читает сам дашборд. Ваш монитор видит то же, что команда, в то же мгновение.
Изменения таблиц как потоки
Устройства, настройки, теги, сервисные группы, общая доска задач — всё приходит событиями postgres_changes. Изменилось в базе — вы узнаете. Никаких таймеров и циклов обновления.
Больше, чем трафик
Живой аудит-журнал, прогресс импорта памяти и события управления устройствами тоже доступны по подписке. Стройте ботов-оповещателей, настенные дашборды или автоматизации, реагирующие на саму платформу.
Подпишитесь из доков
WS-эксплорер в дашборде подключается к настоящим каналам с вашим токеном и красиво печатает события по мере прибытия. Посмотрите на поток до того, как напишете хоть строчку кода.
Subscribe once,
Realtime-not-polling is a standing engineering rule here — every feature is push-driven end to end, and the dashboard itself never polls.
- 01
Connect once
One WebSocket to api.busymate.net's Realtime service, authenticated with the same OAuth token as REST and MCP.
- 02
Join channels
Subscribe to topics — a workspace firehose, a single device, fleet-wide status — each authorized by the same row-level security as the tables themselves.
- 03
Events push to you
Database triggers broadcast changes the instant rows land. No polling loop, no missed window between polls — the push IS the source of truth arriving.
- 04
React — or publish back
Feed alerting, wall dashboards and bots — or drive control flows the other way, like continuing a paused breakpoint over the proxy-control channel.
// Raw table changes — the shared to-do board
supabase
.channel("todos:all")
.on(
"postgres_changes",
{ event: "*", schema: "public", table: "todos" },
(change) => console.log(change.eventType, change.new),
)
.subscribe();A map of the
The channels your code can join — the same canonical list the in-dashboard WS explorer documents and subscribes.
ws:<workspace_id>broadcastThe workspace entries firehose — every captured request from every device, the moment it lands. The exact channel the dashboard feed renders.
ws:<workspace_id>:<owner_user_id>broadcastThe same firehose narrowed to one owner's devices — what a non-operator account subscribes.
device:<uuid>broadcastPer-device control plane: settings pushes, VPN and unpair commands, browser and farm command round-trips, live-activity messages.
devices:alldbDevice renames, pairing and status changes, fleet-wide — the reason device lists everywhere update without a refresh.
proxy-controlbroadcastDashboard ↔ proxy control flow: continue a request paused at a breakpoint, or resend a captured request.
settings:global · settings_device:all · settings_user:alldbSettings pushes at every tier — capture engines refetch their effective settings the moment any layer changes.
service_groups:alldbService-group membership and rule changes, so grouped devices re-apply rules live.
breakpoint_events:alldbEvery request pausing and resuming at a breakpoint, as it happens — the read side of the continue flow.
audit:all · audit:<actor_uuid>dbThe live audit trail — every action by every human and agent, fleet-wide for operators or scoped to your own events.
todos:allpostgres_changesThe shared to-do board as raw table-change events — the simplest channel to start with.
React in
Alerting bots
Watch the firehose for error spikes on a production host and page your team the second they start — not on the next poll.
Wall dashboards
Render live traffic, device fleet state and the audit trail on a NOC screen — the same push the product dashboard consumes.
Reactive automation
React to a device going offline, a breakpoint pausing, or a settings change — then act back through MCP or the proxy-control channel.
Push is one of
Every capability aligns across the dashboard, MCP, REST, WebSockets and BusyBro — a standing rule, checked on every ship. Read over REST, subscribe over WS, act over MCP: one identity, one permission model.
Before you
What do I connect with?
supabase-js is the shortest path (it handles the Realtime protocol, auth and reconnection), but any client that speaks the Supabase Realtime protocol over WebSockets works. Authenticate with the same OAuth token as REST and MCP.
Broadcast vs postgres_changes — what's the difference?
Most channels are database-triggered broadcasts: a trigger fans a shaped payload to a named topic the instant a row lands — scalable and authorized per topic. A few simple tables (like the to-do board) stream raw postgres_changes events instead.
Can I publish, or only subscribe?
Both. Subscriptions cover the feeds; control flows publish back — the proxy-control channel carries breakpoint-continue and resend-request, and the confirm-gated MCP tools publish device commands on your behalf.
Will I see other people's traffic?
No — channel access is authorized by row-level security on the Realtime layer. Plain accounts get their own devices' feed; the fleet-wide firehose and audit stream require operator capabilities.
Why not just poll the REST API?
Realtime-not-polling is a standing engineering rule here: every feature is push-driven end to end, and the dashboard itself never polls. Push gives you lower latency, no missed events between polls, and no wasted queries.
Wire up the
Каналы и форматы полезной нагрузки — в документации; или подпишитесь из встроенного эксплорера.