createBettingMateChatSession

Initializes a new BettingMate AI chat session for one or more sport games. Called once when the user opens the AI chat — returns a session ID required for all subsequent messages, along with initial game-specific predefined questions and betting recommendations.

This command requires the logged in session

Documentation

Try it now

Request parameters:

Name	Description	Type	Values	Default

gameIds	Game ids are Swarm sport game IDs that tell the AI assistant which specific matches to focus the conversation on.	array	-	-

Call example:
JavaScriptReact HookFlutter

createBettingMateChatSession({
  command: 'process_ai_assistant',
  params: {
    command_name: 'create_chat_session',
    params: {
      game_ids: [1, 2]
    }
  }
})

Response examples:
SuccessError

{
  error: '',
  isLoading: false,
  data: {
    result: 0,
    details: {
      session_id: '4b9f80b0-cc19-480c-ad84-deba140b36cf',
      user_id: 285523160,
      language: 'en',
      created_at: '2026-06-01T12:47:16.371267',
      last_activity: '2026-06-01T12:47:16.371267',
      messages: [],
      predefined_messages: [
        'How many corners does team Turkiye take on average at home?',
        'What do analysts say about the outcome of this match?',
        'How likely is it that there will be a red card (sending-off) in the match?'
      ],
      recommendations: [{
        sport: 1,
        sport_alias: 'Football',
        region: 10001,
        region_alias: 'World',
        competition: 3042,
        competition_name: 'International Friendlies',
        game: 29873543,
        home_team_name: 'Turkiye',
        away_team_name: 'North Macedonia',
        start_time: '2026-06-01T17:30:00Z',
        market: 0,
        market_type: 'P1XP2',
        tag: 999,
        selections: [],
        recsys_game_rank: null,
        recsys_market_score: null,
        recsys_top_market_score: null
      }],
      express_ods_count: null
    }
  }
}

Response parameters:

Name	Description	Type	Values

session_id	ID of the current chat session	string	-
user_id	ID of the authenticated user	number	-
language	Session language (e.g. "en")	string	-
created_at	When the session was originally created (ISO 8601)	string	-
last_activity	Timestamp of the latest activity in the session (ISO 8601)	string	-
messages		array	-
predefined_messages	Suggested quick-reply messages (game-specific questions)	array	-
express_ods_count	Express odds count — null when not applicable	number	-
recommendations	AI-suggested bets for the games in this session	array	-
└─		object
└─ game	Game ID	number	-
└─ sport	Sport ID	number	-
└─ sport_alias	Sport alias	string	-
└─ region	Region ID	number	-
└─ region_alias	Region alias	string	-
└─ competition	Competition ID	number	-
└─ competition_name	Competition name	string	-
└─ home_team_name	Home team name	string	-
└─ away_team_name	Away team name	string	-
└─ start_time	Match start time in ISO 8601 UTC	string	-
└─ market	Market ID	number	-
└─ market_type	Market type key (e.g. "P1XP2", "OverUnder")	string	-
└─ tag	Internal AI tag	number	-
└─ selections	Swarm selection IDs (empty when market not yet resolved)	array	-
└─ recsys_game_rank	RecSys ranking score for the game	number	-
└─ recsys_market_score	RecSys score for the specific market	number	-
└─ recsys_top_market_score	RecSys top market score	number	-