Skip to content

Developer documentation

One integration. Identity and chat.

Bloonio Relay is the shared integration layer of the Bloonio platform. Provision a tenant, sign your requests once, and plug strong authentication (Auth Relay) and multi-tenant chat (Chat Relay) into any backend.

Both relays share one tenants collection, one HMAC scheme, and the same provisioning lifecycle. Learn the model once, reuse it on both sides.

Auth Relay

Delegated strong authentication: device pairing, approval push, QR login, “sudo” step-up, and passkeys (WebAuthn) — without storing credentials on your side.

Auth Relay overview →

Chat Relay

Multi-tenant chat and tickets: web widget and in-app SDK, human operators with per-store queues, signed webhook callbacks, and a self-service console.

Chat Relay overview →

Multi-tenant model

relay_user_id is the universal validator (the “Stripe Connect” model): one user, many tenants and backends, with no cross-tenant leakage.

Tenancy & relay_user_id →

HMAC authentication

Every backend → relay call is signed with X-Bloonio-Signature. One signing recipe, valid for both relays.

Authentication (HMAC) →

Lokotroo and Lisoloo have their own documentation. This hub does not duplicate them — it links out.