Webhooks e Integración de Eventos
Recibe en tu servidor cada posición de tus tags en tiempo real, firmada para que sepas que viene de Tagora.
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.