JOIN_QUEUE

Triggered when one or more players join a queue.

Example Payload

{
  "action": "JOIN_QUEUE",
  "queue": "valorant",
  "channel": "1234567890123456789",
  "guild": "9876543210987654321",
  "players": [
    {
      "name": "Player1#1234",
      "id": "111222333444555666",
      "mmr": 1500,
      "role": "Duelist",
      "team_num": -1,
      "top_role_index": 0,
      "ign": "PlayerIGN1",
      "timestamp": 1707523200.0,
      "pulled_from": null
    },
    {
      "name": "Player2#5678",
      "id": "222333444555666777",
      "mmr": 1450,
      "role": "Controller",
      "team_num": -1,
      "top_role_index": 1,
      "ign": "PlayerIGN2",
      "timestamp": 1707523250.0,
      "pulled_from": null
    }
  ],
  "new_players": [
    {
      "name": "Player2#5678",
      "id": "222333444555666777",
      "mmr": 1450,
      "role": "Controller",
      "team_num": -1,
      "top_role_index": 1,
      "ign": "PlayerIGN2",
      "timestamp": 1707523250.0,
      "pulled_from": null
    }
  ]
}

Payload Fields

Field	Type	Description
action	string	Always "JOIN_QUEUE"
queue	string	The name/identifier of the queue
channel	string	Discord channel ID where the event occurred
guild	string	Discord guild (server) ID
players	Player[]	All players currently in the queue
new_players	Player[]	The player(s) who just joined

When This Event Fires

This webhook is sent when:

• A player uses the join queue command or button
• A player is automatically added to the queue
• Multiple players join simultaneously (e.g., from a party)

Use Cases

• Track queue activity and player engagement
• Send custom notifications when friends join
• Monitor queue fill rates
• Update external dashboards with real-time queue status
• Log player activity for analytics

Implementation Example

def handle_join_queue(data):
    queue_name = data['queue']
    new_players = data['new_players']
    total_players = len(data['players'])
    
    for player in new_players:
        print(f"{player['name']} joined {queue_name}")
        print(f"Queue now has {total_players} players")
        
        # Example: Notify when queue is almost full
        if total_players >= 8:  # Assuming 10 player queue
            send_notification("Queue almost full!")

Related Events

• LEAVE_QUEUE - Player leaves a queue
• MATCH_STARTED - Queue fills and match begins