> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Aprende a configurar un flujo de registros mediante un webhook personalizado para transmitir eventos de registro a la URL que elijas.

# Crear flujos de registros personalizados con webhooks

Los webhooks permiten enviar eventos a un servidor web externo. Auth0 ofrece varias integraciones que envían automáticamente eventos a sistemas de administración y análisis de registros de terceros. Sin embargo, si tu sistema de terceros no es compatible, puedes configurar una integración de webhook personalizada.

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Solo puedes suscribir una URL de carga útil por cada configuración de webhook, pero puedes usar la misma URL para varios flujos. La carga útil se enviará en formato JSON Lines. Tenlo en cuenta al procesar los registros con tu configuración de webhook.
</Callout>

<div id="configure-api-endpoint">
  ## Configurar el endpoint de la API
</div>

Debe crear una API que exponga una única ruta (como `/api/logs`) que acepte solicitudes `HTTP POST`.

<Warning>
  No se admiten certificados HTTP autofirmados.
</Warning>

<div id="configure-log-stream">
  ## Configurar el flujo de registros
</div>

1. Vaya a [Dashboard > Monitoring > Streams](https://manage.auth0.com/#/log-streams) y haga clic en **Create Stream**.

   <Frame>
     <img src="https://mintcdn.com/translations/MV7tE-x71x8RWRES/docs/images/cdy7uua7fh8z/5ZY6sT68DabXNL9Dr4bhss/ff0f7306fcf9d64247a61a48b12a39a9/log_stream.png?fit=max&auto=format&n=MV7tE-x71x8RWRES&q=85&s=d758c12e1c9314e6cbddb3457bdf088e" alt="Dashboard Monitoring Streams" width="1924" height="1336" data-path="docs/images/cdy7uua7fh8z/5ZY6sT68DabXNL9Dr4bhss/ff0f7306fcf9d64247a61a48b12a39a9/log_stream.png" />
   </Frame>
2. Seleccione **Custom Webhook** e introduzca un nombre único para el nuevo flujo.
3. Configure los siguientes ajustes:

   <Frame>
     <img src="https://mintcdn.com/translations/6GE5Z24GDCZehiJ9/docs/images/cdy7uua7fh8z/5vJVD09aqSF0xEZZFk6wh2/e6469041b2dd1e4f1b142961ca0a12ab/custom-webhook-settings.png?fit=max&auto=format&n=6GE5Z24GDCZehiJ9&q=85&s=7e02467792efac2a21bd4409a82adcc6" alt="Dashboard Monitoring Streams Custom Webhook Settings Tab" width="1498" height="2064" data-path="docs/images/cdy7uua7fh8z/5vJVD09aqSF0xEZZFk6wh2/e6469041b2dd1e4f1b142961ca0a12ab/custom-webhook-settings.png" />
   </Frame>

   | Ajuste                       | Descripción                                                                        |
   | ---------------------------- | ---------------------------------------------------------------------------------- |
   | **Name**                     | Un nombre para mostrar único que permita distinguir esta integración de otras.     |
   | **Payload URL**              | La URL a la que se envían las cargas útiles de eventos como solicitudes HTTP POST. |
   | **Authorization Token**      | (Opcional) El valor del encabezado Authorization de la solicitud.                  |
   | **Content Type**             | El tipo de medio de la carga útil que se enviará al webhook.                       |
   | **Content Format**           | Reciba los datos en formato JSON Lines, matrices u objetos.                        |
   | **Filter by Event Category** | Lista de filtros del flujo de registros.                                           |
   | **Starting Cursor**          | (Opcional) La fecha y hora específicas a partir de las cuales iniciar el flujo.    |
4. Haga clic en **Save**.

<div id="test-configuration">
  ## Probar la configuración
</div>

1. Cambie a la vista **Health** y confirme que **Stream Status** sea **Active.**
2. Realice una acción que genere un evento en los registros del inquilino, como un inicio de sesión, un intercambio de tokens o una llamada a la Management API de Auth0.
3. Confirme que el evento se haya creado en los registros de su inquilino.
4. Confirme que su API recibió una solicitud `HTTP POST` con los datos del evento.
5. Vaya a la vista **Health** y confirme que no se haya producido ningún error.

<div id="troubleshoot-webhooks">
  ## Solucionar problemas con Webhooks
</div>

Si tu webhook no funciona, puede resultar difícil diagnosticarlo y determinar cuál es la causa del problema. Los webhooks son asíncronos, así que probarlos puede implicar activar el webhook, esperar y luego comprobar la respuesta (suponiendo que hayas recibido alguna).

Sin embargo, existen alternativas a ese proceso ineficiente que detallamos antes. Aunque explicar en detalle cómo diagnosticar un webhook concreto queda fuera del alcance de este artículo, aquí tienes algunos pasos que puedes seguir para depurarlo:

1. Revisa [Auth0 Dashboard > Monitoring > Logs](/es/docs/deploy-monitor/logs) para ver si hay mensajes útiles.
2. Analiza las solicitudes que realiza tu webhook con una herramienta como [Mockbin](http://mockbin.io/), [Beeceptor](https://beeceptor.com/) o [RequestBin](https://github.com/RonTt/Requestbin) (autoalojada).
3. Simula solicitudes con cURL o [Postman](https://www.getpostman.com/).
4. Prueba el código de tu webhook localmente con alguna herramienta como [localtunnel](https://github.com/localtunnel/localtunnel) o [ngrok](https://ngrok.com/).
5. Usa una herramienta como [Runscope](https://www.runscope.com/) o [Assertible](https://assertible.com/) para supervisar todo el flujo de ejecución.

<div id="learn-more">
  ## Más información
</div>

* [Comprobar el estado del flujo de registros](/es/docs/customize/log-streams/check-log-stream-health)
* [Filtrar eventos de registro](/es/docs/deploy-monitor/logs/log-event-filters)
* [Códigos de tipo de evento de registro](/es/docs/deploy-monitor/logs/log-event-type-codes)