{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/es/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Webhooks","description":"Documentação oficial, guias e referência da API Auvo v2.","siteUrl":"https://developers.auvo.com.br","lang":"pt-BR","keywords":"auvo, api, documentação, developers, field service, workforce","meta":[{"name":"og:site_name","content":"Auvo Developers"},{"name":"og:locale","content":"pt_BR"},{"name":"og:locale:alternate","content":"es_ES"},{"name":"og:locale:alternate","content":"en_US"},{"name":"twitter:card","content":"summary_large_image"},{"name":"twitter:site","content":"@auvoapp"}],"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"webhooks","__idx":0},"children":["Webhooks"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["La API Auvo notifica eventos de tareas, tickets y órdenes de servicio mediante"," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HTTP POST autenticado"]}," a la URL registrada por el cliente."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"suscribirse-a-eventos","__idx":1},"children":["Suscribirse a eventos"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Usa el grupo ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["WebHooks"]}," en la referencia de la API para crear/listar/eliminar"," ","suscripciones. Cada suscripción incluye:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["url"]}," — endpoint del cliente (HTTPS obligatorio en producción)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["events"]}," — lista de eventos (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["task.created"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["task.updated"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ticket.closed"]},"...)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["secret"]}," — cadena opaca devuelta al crear; úsala para firmar payloads."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"formato-del-payload","__idx":2},"children":["Formato del payload"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"event\": \"task.created\",\n  \"occurredAt\": \"2026-04-24T13:45:00Z\",\n  \"deliveryId\": \"01J9F3T2...-\",\n  \"data\": { \"taskId\": 12345, \"customerId\": 98 }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"validación-de-origen","__idx":3},"children":["Validación de origen"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cada entrega incluye ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Auvo-Signature: t=<ts>,v1=<hexHmacSha256>"]}," calculado"," ","como ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["HMAC_SHA256(secret, \"${ts}.${body}\")"]},". Rechaza si:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["La diferencia entre ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ts"]}," y ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Date.now()"]}," supera ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["5 minutos"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v1"]}," no coincide (usa comparación time-safe)."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"reentrega","__idx":4},"children":["Reentrega"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Respuestas ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2xx"]}," en hasta ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["10 s"]}," marcan la entrega como exitosa."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Los fallos o timeouts disparan reintentos con backoff exponencial hasta ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["24 h"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Auvo-Delivery-Attempt"]}," indica el intento actual (1..n)."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"idempotencia","__idx":5},"children":["Idempotencia"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Usa ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deliveryId"]}," para deduplicar entregas de tu lado: las reentregas llegan con"," ","el mismo ID."]}]},"headings":[{"value":"Webhooks","id":"webhooks","depth":1},{"value":"Suscribirse a eventos","id":"suscribirse-a-eventos","depth":2},{"value":"Formato del payload","id":"formato-del-payload","depth":2},{"value":"Validación de origen","id":"validación-de-origen","depth":2},{"value":"Reentrega","id":"reentrega","depth":2},{"value":"Idempotencia","id":"idempotencia","depth":2}],"frontmatter":{"title":"Webhooks","description":"Suscripción, payloads, reentrega y validación de origen de Webhooks.","seo":{"title":"Webhooks"}},"lastModified":"2026-04-24T13:01:34.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/es/guides/webhooks","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}