Un botón, muchos celulares

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

Una actividad pertenece al primer celular que la abre. Los demás celulares reciben un error. Con reuse: true, cada celular 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 póster, un volante 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 toca el botón.

Mira quién se unió

Cada copia tiene su propio activityId. Llega en el active webhook cuando un celular 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 celular. Las actualizaciones de grupo también actualizan la plantilla, así que los celulares 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 celulares nuevos, quita el botón y el código QR.
Un celular 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.