# Crea tu primera URL de webhook

> Unos pasos sencillos para crear webhooks en Pocket Alert

*25.01.2025*

<!-- source: https://pocketalert.app/es/blog/create-your-first-webhook-url -->

[//]: # '# Cómo integrar webhooks de Bitbucket en Pocket Alert'

## Crear un nuevo webhook

![crear webhook](https://cdn.pocketalert.app/guides/git/webhook-create.gif)

1. Ve a la página de [Webhooks](https://pocketalert.app/webhooks)
2. Haz clic en el botón "Create"
3. Rellena el formulario con la siguiente información:
   - **Name**: El nombre del webhook
   - **Application**: La aplicación a la que vincular el webhook
   - **Device**: El dispositivo al que vincular el webhook
   - **Message**: El mensaje que se enviará cuando se active el webhook
4. Haz clic en el botón "Create"
5. Copia la URL del webhook

**En el mensaje, especificamos \* para obtener todo el JSON y determinar qué parámetros necesitamos.**

## Cómo funciona el analizador JSON
Los webhooks son esenciales para la transmisión de datos en tiempo real entre aplicaciones. Sigue estos pasos para configurar los webhooks de forma eficiente y asegurar una integración fluida con tus sistemas.

1. **Define la estructura de tu payload JSON**
   Identifica el formato de datos que quieres recibir. Para capturar el conjunto de datos completo, usa el símbolo comodín * en tu configuración. Así se garantiza que se entregue todo el payload JSON sin filtrar.
2. **Extrae datos específicos de un JSON anidado**
   Para acceder a campos individuales dentro de objetos anidados, usa la sintaxis `%objectName.field%`. Por ejemplo, `%params.name%` extrae el valor de name del objeto params.

```json
{
  "event": {
    "title": "New Order",
    "message": "A new order has been placed with ID 12345",
    "tags": ["order", "new"],
    "users": [
      {"first": "Dale", "last": "Murphy", "age": 44, "nets": ["ig", "fb", "tw"]},
      {"first": "Roger", "last": "Craig", "age": 68, "nets": ["fb", "tw"]},
      {"first": "Jane", "last": "Murphy", "age": 47, "nets": ["ig", "tw"]}
    ]
  }
}
```

Para configurar el webhook, lo harías así:

- Si quieres mostrar todo el JSON, usa simplemente el *
- Para obtener el título del evento, usa `%event.title%`
- Para obtener el mensaje, usa `%event.message%`
- Para obtener las etiquetas, usa `%event.tags%`

```json
Title: %event.title%
Message: %event.message%
Tags: %event.tags%
Users: %event.users.0%
First user: %event.users.0.first% %event.users.0.last%
```

Este es un ejemplo de cómo se vería la salida con la configuración indicada y el JSON de ejemplo:

```
Title: New Order
Message: A new order has been placed with ID 12345
Tags: ["order","new"]
Users: {"age":44,"first":"Dale","last":"Murphy","nets":["ig","fb","tw"]}
First user: Dale Murphy
```

Puedes encontrar más información sobre las variables en la [sintaxis de GJSON Path](https://github.com/tidwall/gjson/blob/master/SYNTAX.md).
