⚽ Convocados Docs GitHub

Tutorial

Walk through the complete flow — from creating a game to viewing history.

Step 1: Create an event

Go to the home page and fill in the form:

Optionally expand Advanced options to set:

Click Create game. You'll be redirected to the event page with a unique URL.

Step 2: Share the link

The event page shows a Share button. On mobile, it uses the native share sheet. On desktop, it copies the URL to your clipboard. Send this link to your group chat.

No accounts are needed — anyone with the link can join.

Step 3: Players join

Players can join in two ways:

Players are added in order. Once the max is reached, additional players go to the bench. If an active player leaves, the first bench player is automatically promoted.

Step 4: Randomize teams

When you have at least 2 active players, click Randomize teams. The app splits players into two balanced teams randomly.

After randomizing, you can:

Step 5: Get notified

Click Get notified to receive push notifications when players join or leave. This uses browser push notifications — no app install needed.

Step 6: Recurring games

If you enabled recurrence, the player list automatically resets 1 hour after the game time. The event URL stays the same — just share it once and reuse it every week.

Past games are saved in History, where you can record scores and mark games as played or cancelled.

Step 7: Integrate (optional)

Expand the Integrations section at the bottom of the event header to find the webhook API URL. Use this to connect external systems. See the Webhooks API and OpenClaw guide for details.