Receta de webhooks para Zapier y Make

1. Qué necesita

Una cuenta de QR Wait de la que sea propietario (los gestores y el personal no ven las integraciones), una cuenta de Zapier o Make y la pantalla Integraciones de la página de administración abierta en otra pestaña.

2. Zapier

1. En Zapier, cree un Zap con Webhooks by Zapier como disparador y Catch Hook como evento. Copie la URL del webhook que muestra Zapier.
2. En QR Wait, en Integraciones, péguela en Dirección del endpoint (https), marque los eventos que quiera y pulse Añadir webhook. Guarde el secreto de firma, que solo se muestra una vez.
3. Entre una vez en su fila desde un móvil, o añada a alguien en el panel del personal, para que llegue un evento ticket.joined real. Enviar evento de prueba solo envía un ping sin campos del ticket: sirve para ver que la dirección responde.
4. De vuelta en Zapier, pruebe el disparador y elija ese evento. Añada una acción, por ejemplo Google Sheets › Create Spreadsheet Row, y asigne los campos: type, queue.name, ticket.no, ticket.size, ticket.joined_at.
5. Publique el Zap. A partir de ahora, cada evento añade una fila.

3. Make

1. En Make, cree un escenario cuyo primer módulo sea Webhooks › Custom webhook. Añada un webhook y copie su dirección.
2. Péguela en Integraciones de QR Wait como arriba y pulse Añadir webhook.
3. Make espera para conocer la estructura de los datos: entre una vez en su fila o añada a alguien en el panel del personal.
4. Añada el siguiente módulo, por ejemplo Google Sheets › Add a Row o un mensaje a su chat, asigne los campos y active el escenario.

4. Qué llega

Cada evento es un cuerpo JSON como este. Marque en QR Wait solo los eventos que necesite, o filtre por type en Zapier o Make.

{
  "id": "d_3f9a1c0b7e2d4a61",
  "type": "ticket.joined",
  "created": "2026-10-10T09:12:30.010Z",
  "account": "antalyabb",
  "queue": { "id": "a1b2c3d4e5", "name": "Konyaaltı Beach", "slug": "konyaalti" },
  "ticket": { "no": 42, "size": 2, "source": "qr", "joined_at": "2026-10-10T09:12:30.004Z" }
}

Los nombres, las respuestas del formulario de entrada y los códigos de reserva solo se envían si marca Incluir nombres, respuestas del formulario de entrada y códigos de reserva para esa dirección. Si no, los eventos solo llevan números y horas.

Una entrega fallida se reintenta durante unas 9 horas con el mismo id. Compruébelo antes de añadir una fila (con un paso de búsqueda) si un duplicado le causaría problemas.

5. Al revés: añadir personas desde Zapier o Make

Para que otra herramienta ponga personas en una fila (un formulario de su web, una herramienta de reservas), cree en Claves de API una clave con acceso de Lectura y escritura y envíe una petición desde Webhooks by Zapier › POST o el módulo HTTP › Make a request de Make:

POST https://qrwait.app/api/v1/queues/<queue id>/tickets
Authorization: Bearer qrw_…
Content-Type: application/json

{ "size": 2, "note": "Website" }

La respuesta es el nuevo número, por ejemplo { "no": 43 }. Los ids de las filas se obtienen con GET /api/v1/queues. Llamar al siguiente grupo, marcar a alguien como atendido y todos los campos están en la referencia de la API (en inglés).

6. Manténgalo seguro

• La dirección que le da Zapier o Make basta para enviar datos a su Zap o escenario: no la comparta.
• Zapier y Make no comprueban por sí solos la firma de QR Wait. Si quien recibe debe estar seguro de que un evento viene de QR Wait, verifique la cabecera X-QRWait-Signature como muestra la referencia de la API, por ejemplo en un paso de código.
• Dé a cada clave solo el acceso que necesita y revóquela en la pantalla Integraciones cuando deje de usarse; allí se ve cuándo se usó cada clave por última vez.