TALQENDocs

Talqen Docs

Build your own Talqen integration.

Connect Roblox staff systems to Talqen using a secure API for identity, activity tracking, profiles, minutes, and leaderboards.

Roblox server-sidelua
-- Server Script only (ServerScriptService). Enable HttpService.
local HttpService = game:GetService("HttpService")

local API_BASE = "https://api-staging.talqen.net/v1"
local API_KEY = "<TALQEN_TEST_API_KEY>" -- ServerStorage / secret store

local function startShift(player)
  local response = HttpService:RequestAsync({
    Url = API_BASE .. "/activity/shifts/start",
    Method = "POST",
    Headers = {
      ["Authorization"] = "Bearer " .. API_KEY,
      ["Content-Type"] = "application/json",
      ["Idempotency-Key"] = "start-" .. player.UserId .. "-" .. HttpService:GenerateGUID(false),
    },
    Body = HttpService:JSONEncode({
      robloxUserId = tostring(player.UserId),
      universeId = tostring(game.GameId),
      placeId = tostring(game.PlaceId),
      serverId = game.JobId,
    }),
  })

  if not response.Success then
    warn("Talqen start failed", response.StatusCode)
    return nil
  end

  local payload = HttpService:JSONDecode(response.Body)
  return payload.data.shift.id
end

What developers control

You own game logic. Decide when staff clock in, how teams map to shifts, how UI surfaces profile data, and how retries behave.

  • Custom clock-in flows and eligibility rules
  • Team change and disconnect handling
  • Server-side credential storage and request orchestration

What Talqen handles

Talqen authenticates your integration, validates allowed universes, maps Roblox identities, and tracks shift lifecycle, minutes, and leaderboards.

  • API key auth scoped to application and workspace
  • Idempotent shift mutations
  • Discord Connect staff and activity reads

Integration flow

  1. 01

    Request developer access and create a test credential

  2. 02

    Enable HttpService and call Talqen from server Scripts only

  3. 03

    Start, heartbeat, and stop shifts with Idempotency-Key

  4. 04

    Read summaries and leaderboards for dashboards or Discord

Available API capabilities

Planned items are labeled and are not live.

  • Secure API authenticationAvailable
  • Roblox identity mappingAvailable
  • Allowed-universe validationAvailable
  • Shift lifecycle trackingAvailable
  • Activity summariesAvailable
  • Staff profilesAvailable
  • LeaderboardsAvailable
  • Discord integrationAvailable
  • General event ingestionPlanned

Example Roblox integration

Use ServerScriptService with HttpService:RequestAsync. Map game.GameId, game.PlaceId, game.JobId, and player.UserId into shift payloads.

Developer access process

EnvironmentBase URLCredential prefix
Testhttps://api-staging.talqen.nettalqen_test_
Productionhttps://api.talqen.nettalqen_live_

Production access may be limited during private beta. Start on test credentials against staging, then request live access when ready.

Open developer portal