使い方

-- ServerScriptService に置く（クライアントからは見えない場所）
local HttpService = game:GetService("HttpService")

local BASE = "https://www.vespo.app"
-- ⚠️ 直接書かず、Creator Dashboard の Secrets か
--    ServerStorage の非公開の値から読むのが安全
local API_KEY = "ここに自分のキー"

local function call(method, path, body)
	local ok, res = pcall(function()
		return HttpService:RequestAsync({
			Url = BASE .. path,
			Method = method,
			Headers = {
				["Authorization"] = "Bearer " .. API_KEY,
				["Content-Type"] = "application/json",
			},
			Body = body and HttpService:JSONEncode(body) or nil,
		})
	end)
	if not ok then
		warn("[Vespo] 通信に失敗:", res)
		return nil
	end
	-- ⚠️ 200番台以外は中身に error が入っている。開発者サイトの「失敗」タブにも残る
	if res.StatusCode >= 400 then
		warn("[Vespo] " .. res.StatusCode .. " " .. tostring(res.Body))
		return nil
	end
	return HttpService:JSONDecode(res.Body)
end

-- roomId は自分で決める文字列。ゲーム側でも同じIDを覚えておく
local res = call("POST", "/v1/rooms", {
	roomId = "myGame:lobby",
	name = "ロビー",
	members = { 12345678, 87654321 },  -- RobloxのUserId
	-- アイコンは任意。Robloxのカタログの物を使える
	icon = { id = 123456789, thumb = "Asset" },  -- "Asset" か "Bundle"
	iconBg = "#ffd9a0",
})

-- res.created が true なら、この呼び出しで新しく出来た
print(res and res.created)

-- ⚠️ presentRobloxIds ＝ いま同じサーバーに居る人。
--    その人はゲーム内でもう見えているので、スマホには鳴らさない
local present = {}
for _, p in Players:GetPlayers() do
	table.insert(present, p.UserId)
end

call("POST", "/v1/messages", {
	roomId = "myGame:lobby",
	senderUserId = player.UserId,
	senderName = player.DisplayName,
	content = message,                  -- ⚠️ 2000文字まで
	clientMsgId = HttpService:GenerateGUID(false),
	experienceId = game.GameId,
	presentRobloxIds = present,
})

local Players = game:GetService("Players")

local function report()
	local ids = {}
	for _, p in Players:GetPlayers() do
		table.insert(ids, p.UserId)
	end
	call("POST", "/v1/presence", {
		experienceId = game.GameId,
		experienceName = "自分のゲーム名",
		placeId = game.PlaceId,
		serverId = game.JobId,
		robloxUserIds = ids,
	})
end

task.spawn(function()
	while task.wait(30) do
		report()
	end
end)

-- ⚠️ サーバーが閉じる時は空で送る＝その部屋の人が全員消える
game:BindToClose(function()
	call("POST", "/v1/presence", {
		experienceId = game.GameId,
		serverId = game.JobId,
		robloxUserIds = {},
	})
end)

-- ゲームの中に「遊んでいることを見せる」のスイッチを置いて、押された時に呼ぶ
call("POST", "/v1/presence-settings", {
	robloxUserId = player.UserId,
	show = true,                   -- false にすると誰にも出なくなる
	name = "自分のゲーム名",        -- 出す時の呼び名（省くとゲーム名）
})

-- ⚠️ 見せる先は「同じトークの人・友だち」まで。誰にでも見えるわけではありません。
-- ⚠️ スイッチは**ゲーム側に置いてください**。RobVerse側には出す場所がありません。
-- ⚠️ 押していない人にも毎回呼ばないこと（本人の選択を上書きすることになります）。

call("POST", "/v1/rooms/leave", {
	roomId = "myGame:lobby",
	robloxUserId = player.UserId,
})

-- 入室時などに1回。届いた操作は実行したら ack を返す
local ops = call("GET", "/v1/room-ops?robloxUserId=" .. player.UserId)
for _, op in (ops and ops.ops or {}) do
	-- op.kind は "leave" / "rename" / "icon_bg" など
	-- ここで自分のゲーム側のデータを直す

	call("POST", "/v1/room-ops/ack", { ids = { op.id } })
end