Waitlist Docs
Connector

Bridge cloud paging requests to local V8 hardware

Connector runs at the location, synchronizes authorized V8 transmitters, discovers the local paging device, and forwards paging requests from LRS Waitlist to the hardware.

1. Overview

Where Connector fits

Dashboard owns Service Plans, API keys, locations, areas, and transmitter records. Waitlist creates paging requests during daily operation. Connector is the local bridge that receives an authorized request and writes it to a supported V8 transmitter on the location network.

2. Eligibility

Confirm access before installation

RequirementWhat to confirm
Authorized userSign in with a verified Dashboard account that can manage the target organization or location. Staff-only accounts are not eligible for Connector administration.
Active locationThe location must be active and have a current billed Service Plan with API Access enabled.
API key bindingThe location must be associated with an active API key. The Connector receives scoped configuration, never the API key secret.
V8 transmitterThe transmitter must use the canonical V8 identity and be reachable on the same local network as the Connector runtime.
A stored location-to-key association does not grant access by itself. Connector eligibility follows the active charged plan; a future scheduled plan does not activate API Access early.

3. Runtime

Use a supported packaged origin

Choose the packaged runtime approved for the location workstation. Production API access uses an exact origin allowlist, so changing the local host or port can prevent sign-in and synchronization.

RuntimeProduction origin
Bun / Bun WindowUses http://127.0.0.1:4000. Keep the default host and port in production.
ElectrobunUses http://127.0.0.1:4100. Keep the default host and port in production.
NeutralinoUses http://127.0.0.1:4300. Keep the default host and port in production.
TauriUses the packaged Tauri origin and native commands instead of a local HTTP server.
Do not replace 127.0.0.1 with localhost or override the production port unless the API allowlist is updated and deployed at the same time.

4. Sign in and sync

Prepare the local paging connection

  1. Connect the workstation to the same local network as the V8 transmitter.
  2. Start the approved Connector runtime and sign in with a verified manager account.
  3. Select the eligible account, organization, and location shown by Connector.
  4. Run local discovery and confirm the expected transmitter appears.
  5. Synchronize the transmitter and review the area assignments returned by the cloud configuration.
  6. Send a controlled test page and verify both Connector status and the physical pager before live use.
  7. Keep Connector running while the location expects V8 paging requests.

5. V8 identity

Use the canonical transmitter serial

The canonical V8 serial format is T7470-#####, where the final five characters are digits. Connector also accepts the bare five digits and expands them to this format. Legacy T747X values are not converted and will be rejected by V8 synchronization and paging.

InputResult
T7470-12345Canonical V8 identity; accepted.
12345Expanded by Connector to T7470-12345.
T747X-12345Legacy alias; rejected.
T7471-12345Not a V8 identity; use the workflow for its actual hardware model.

6. Paging status

Interpret local delivery status correctly

StatusMeaning
ReceivedThe cloud request reached Connector and is waiting for local processing.
AcceptedThe local transmitter returned PageRequestStatus. This confirms local acceptance; it does not prove physical pager reception.
ExpiredThe request passed its allowed delivery window before local transmission completed.
UnavailableNo eligible synchronized transmitter was available for the request.
Always verify a new installation with real hardware. A successful local protocol response is not confirmation that a guest's physical pager vibrated, lit, or sounded.

7. Troubleshooting

Resolve common Connector problems

Location is missing after sign-in

Confirm the location is active, its current charged plan includes API Access, and an active API key remains bound to it.

V8 serial is rejected

Use T7470 followed by a hyphen and five digits. T747X is no longer an alias. Entering only five digits in Connector expands to the canonical T7470 form.

Packaged runtime cannot reach the API

Use the runtime's default 127.0.0.1 port. Production accepts only the packaged origins listed in this guide; custom ports require a coordinated API change.

Request is accepted but the pager does not react

Accepted means the transmitter returned a local PageRequestStatus. Recheck pager number, pager type, transmitter configuration, signal coverage, and the physical pager.

Local history disappears after restart

Connector rebuilds its synchronized state after sign-in. Confirm the location and transmitter resynchronize before sending another test page.