Un botón, muchos móviles

Da un botón de lanzamiento a muchas personas: un estadio, una clase, una recaudación de fondos.

Una actividad pertenece al primer teléfono que la abre. Los demás teléfonos reciben un error. Con reuse: true, cada teléfono que abre el botón recibe su propia copia de la actividad.

Inicia con reutilización

Envía reuse: true y un group. El grupo es la forma en que una sola llamada llega a cada copia.

curl -X POST https://api.webliveactivity.com/api/start \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: wla_your_key' \
  -d '{
  "widgetContainerId": "lincoln-vs-central-2026-10-23",
  "group": "lincoln-vs-central",
  "reuse": true,
  "brand": {
    "title": "Lincoln vs Central",
    "name": "Lincoln High"
  },
  "state": {
    "layout": "versus",
    "primaryText": "Kickoff at 7 PM",
    "secondaryText": "Lincoln vs Central",
    "versus": {
      "leftName": "Lincoln",
      "rightName": "Central",
      "leftScore": "0",
      "rightScore": "0"
    }
  }
}'

Pon el botón donde está la gente

Pon links.iframe en una página web. Para un cartel, un folleto o la entrada de un estadio, imprime un código QR con la dirección de esa página. La gente escanea el código y luego pulsa el botón.

Mira quién se ha unido

Cada copia tiene su propio activityId. Llega en el active webhook cuando un teléfono se une.

Actualiza para todos

Envía el group y el widgetContainerId. Todas las copias cambian.

curl -X POST https://api.webliveactivity.com/api/update \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: wla_your_key' \
  -d '{
  "group": "lincoln-vs-central",
  "widgetContainerId": "lincoln-vs-central-2026-10-23",
  "state": {
    "primaryText": "Lincoln scores!",
    "secondaryText": "Lincoln 7, Central 0",
    "versus": {
      "leftScore": "7"
    }
  }
}'

Finaliza para todos

curl -X POST https://api.webliveactivity.com/api/end \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: wla_your_key' \
  -d '{
  "group": "lincoln-vs-central",
  "widgetContainerId": "lincoln-vs-central-2026-10-23"
}'

Reglas

El activityId que devuelve start es una plantilla. Nunca llega a un teléfono. Las actualizaciones de grupo también actualizan la plantilla, así que los teléfonos que se unen después empiezan con el estado más reciente.
Un botón con reutilización no se puede desactivar. Finalizar las copias no lo detiene. Para que no se unan teléfonos nuevos, quita el botón y el código QR.
Un teléfono conserva una actividad por contenedor. Si ya tiene una del mismo contenedor, la app le pregunta al usuario si quiere conservarla o reemplazarla. Para un evento que se repite, como un partido cada semana, usa un widgetContainerId nuevo para cada evento.