# Webhooks
Utilice Webhooks para recibir eventos de tareas y facturación sin sondeo. Tripo envía cargas útiles de JSON a su punto final HTTPS cuando ocurren eventos de suscripción.
## Configuración
1. Abra Configuración, luego Webhooks.
2. Agregue un punto final HTTPS, como `https://api.yourapp.com/tripo-webhook`.
3. Seleccione los tipos de eventos que desea recibir.
4. Guarde el punto final.
5. Copie el secreto de firma y guárdelo de forma segura. Se muestra sólo una vez.
## Tipos de eventos
| Evento | Descripción |
| --- | --- |
| `task.completed` | Una tarea finalizó exitosamente. |
| `task.failed` | Una tarea falló o fue cancelada. |
| `balance.low` | El saldo de la cuenta cayó por debajo del umbral de alerta de crédito configurado. |
## Encabezados de solicitud
| encabezado | Descripción |
| --- | --- |
| `Tripo-Webhook-Id` | Punto final Webhook ID. |
| `Tripo-Webhook-Delivery` | Entrega única ID. Úselo para la idempotencia. |
| `Tripo-Webhook-Event` | Tipo de evento, como `task.completed`. |
| `Tripo-Webhook-Signature` | Firma HMAC-SHA256 sobre `{timestamp}.{raw_body}`. |
| `Content-Type` | Siempre `application/json`. |
## Verificación
1. Analice `t` y `v1` de `Tripo-Webhook-Signature`.
2. Calcule HMAC-SHA256 con el secreto de firma sobre `t + "." + rawBody`.
3. Compare el resumen hexadecimal calculado con `v1` mediante una comparación de tiempo constante.
4. Opcionalmente, rechace las marcas de tiempo de más de cinco minutos.
## Mejores prácticas
- Devuelva una respuesta `2xx` rápidamente y luego procese el trabajo pesado de forma asincrónica.
- Verifique cada carga útil antes de cambiar el estado de la aplicación.
- Deduplicar eventos usando `Tripo-Webhook-Delivery`.
- Utilice `balance.low` para alertar a los usuarios antes de que falle la creación de tareas debido a créditos insuficientes.
Webhooks
Utilice Webhooks para recibir eventos de tareas y facturación sin sondeo. Tripo envía cargas útiles de JSON a su punto final HTTPS cuando ocurren eventos de suscripción.
Configuración
Abra Configuración, luego Webhooks.
Agregue un punto final HTTPS, como https://api.yourapp.com/tripo-webhook.
Seleccione los tipos de eventos que desea recibir.
Guarde el punto final.
Copie el secreto de firma y guárdelo de forma segura. Se muestra sólo una vez.
Tipos de eventos
Evento
Descripción
task.completed
Una tarea finalizó exitosamente.
task.failed
Una tarea falló o fue cancelada.
balance.low
El saldo de la cuenta cayó por debajo del umbral de alerta de crédito configurado.
Encabezados de solicitud
encabezado
Descripción
Tripo-Webhook-Id
Punto final Webhook ID.
Tripo-Webhook-Delivery
Entrega única ID. Úselo para la idempotencia.
Tripo-Webhook-Event
Tipo de evento, como task.completed.
Tripo-Webhook-Signature
Firma HMAC-SHA256 sobre {timestamp}.{raw_body}.
Content-Type
Siempre application/json.
Verificación
Analice t y v1 de Tripo-Webhook-Signature.
Calcule HMAC-SHA256 con el secreto de firma sobre t + "." + rawBody.
Compare el resumen hexadecimal calculado con v1 mediante una comparación de tiempo constante.
Opcionalmente, rechace las marcas de tiempo de más de cinco minutos.
Mejores prácticas
Devuelva una respuesta 2xx rápidamente y luego procese el trabajo pesado de forma asincrónica.
Verifique cada carga útil antes de cambiar el estado de la aplicación.
Deduplicar eventos usando Tripo-Webhook-Delivery.
Utilice balance.low para alertar a los usuarios antes de que falle la creación de tareas debido a créditos insuficientes.
