Usa la API y los webhooks

La API y los webhooks están disponibles en los planes de pago. En el plan gratuito, la página muestra Ver planes.

Crea una clave de API

1. Abre API y webhooks en la barra lateral.
2. En Claves de API, escribe para qué es la clave en ¿Para qué es esta clave?.
3. Haz clic en Crear clave.
4. Copia la clave ahora: no se vuelve a mostrar. Haz clic en Listo.

Envíala como token bearer: Authorization: Bearer vws_live_…. Una clave lee este espacio (eventos, listas de invitados, el registro de la puerta, el libro de invitados) y puede emitir o revocar invitaciones. No puede registrar la entrada de nadie, y nunca devuelve códigos QR.

Una clave nueva tiene api:read y api:write. Las claves creadas antes de que existieran las escrituras son solo de lectura; crea una nueva si se rechaza una escritura. Cada clave permite 600 solicitudes por minuto.

Para desactivar una clave, haz clic en Revocar clave. Todo lo que la use deja de funcionar al instante.

Añade un webhook

1. En Webhooks, pega la URL de tu endpoint (debe ser https).
2. Elige los tipos de evento que te interesan, o no elijas ninguno para recibirlos todos.
3. Haz clic en Añadir.
4. Copia el Secreto de firma de este endpoint: se muestra una sola vez.
5. Haz clic en Enviar un evento de prueba para recibir un ejemplo antes de abrir la puerta.

Tipos de evento: checkin.granted, checkin.refused, invitation.created, invitation.revoked, registration.created, registration.approved, rsvp.updated, online.joined (un invitado en línea abrió su enlace personal), online.attended (el informe de Zoom confirma que asistió, con sus minutos).

Verifica y responde las entregas

• Cada solicitud lleva el encabezado X-VenueWS-Signature: un HMAC-SHA256 de la marca de tiempo y el cuerpo sin procesar, hecho con el secreto de firma. Verifícalo con el cuerpo sin procesar y rechaza marcas de tiempo antiguas.
• Responde con un 2xx en menos de 10 segundos. Si no, se reintenta a los 30 segundos, 2 minutos, 10 minutos, 1 hora y 6 horas, y luego se marca como fallida.
• Una entrega puede llegar más de una vez; usa el id del evento para descartar duplicados.

Cada endpoint muestra su último intento y cuántas entregas fallaron. Usa el interruptor Activado para pausarlo, o Eliminar endpoint para borrarlo.

¿Prefieres no programar? Zapier y Make funcionan con la misma clave y los mismos webhooks.