Webhooks e Integración de Eventos
Nuestros Webhooks permiten a tu infraestructura reaccionar a eventos físicos de tus tags en tiempo real.
Flujo de Integración
Para recibir cada posición en tiempo real, registra un webhook con tu URL. Tagora firma cada entrega con Ed25519 y tú la verificas con la publicKey que te da el registro.
Registrar un Webhook
La respuesta trae webhookId y la publicKey (Ed25519) con la que verificarás cada entrega. Para cambiar la URL o pausarlo usa PATCH /integration/v1/webhook/{id}: las llaves no cambian.
Verificación de la firma (Ed25519)
Cada entrega va firmada con la llave privada de tu webhook, y la firma viaja en el encabezado X-Tagora-Signature.
Nota:
Se firma t + "." + el cuerpo crudo (Raw Body), nunca el cuerpo solo. El requestId se repite en cada reintento: úsalo para no procesar dos veces la misma entrega. Un 3xx o un 4xx (salvo 408 y 429) descarta el mensaje.