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.
-- 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
endWhat 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
- 01
Request developer access and create a test credential
- 02
Enable HttpService and call Talqen from server Scripts only
- 03
Start, heartbeat, and stop shifts with Idempotency-Key
- 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
| Environment | Base URL | Credential prefix |
|---|---|---|
| Test | https://api-staging.talqen.net | talqen_test_ |
| Production | https://api.talqen.net | talqen_live_ |
Production access may be limited during private beta. Start on test credentials against staging, then request live access when ready.
Open developer portal
