> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.es/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurar suscripciones a webhooks (BETA)

> Encuentra más información sobre cómo definir suscripciones a webhooks en la última versión de la plataforma para desarrolladores (BETA).

<style>
  {`
    .table-key, .table-key div, .table-key p {
      margin: 0;
      font-size: 14px;
    }
    code {
      text-wrap:nowrap!important;
    }

    `}
</style>

Para definir un conjunto de suscripciones a webhooks para una aplicación en la nueva plataforma para desarrolladores, incluye el directorio `webhooks` en el proyecto, junto con un archivo de configuración `*-hsmeta.json`.

## Estructura del directorio

```shell theme={null}
├──src
│   ├── app/
│   │   └── app-hsmeta.json
│   │   └── ...
│   │   └── webhooks/
│   │     └── webhooks-hsmeta.json
└──
```

## Configuración del webhook

A continuación, están las opciones de configuración disponibles para el archivo `*-hsmeta.json`.

```json theme={null}
{
  "uid": "webhooks",
  "type": "webhooks",
  "config": {
    "settings": {
      "targetUrl": "https://example.com/webhook",
      "maxConcurrentRequests": 10
    },
    "subscriptions": {
      "crmObjects": [
        {
          "subscriptionType": "object.creation",
          "objectType": "contact",
          "active": true
        }
      ],
      "legacyCrmObjects": [
        {
          "subscriptionType": "contact.propertyChange",
          "propertyName": "lastname",
          "active": true
        },
        {
          "subscriptionType": "contact.deletion",
          "active": true
        }
      ],
      "hubEvents": [
        {
          "subscriptionType": "contact.privacyDeletion",
          "active": true
        }
      ]
    }
  }
}
```

<p className="table-key">
  Los campos marcados con <span style={{ color: 'red' }}>\*</span> son obligatorios.
</p>

| Campo                                                | Tipo   | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ---------------------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `uid`<span style={{color:"red"}}>\*</span>           | Cadena | Un identificador único interno para el componente del webhook.                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `type`<span style={{color:"red"}}>\*</span>          | Cadena | El tipo de componente, que en este caso debe ser `webhooks`.                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `settings`<span style={{color:"red"}}>\*</span>      | Objeto | Un objeto que especifica dos campos: `targetUrl`, que es la URL disponible públicamente para que HubSpot llame a donde se entregarán los datos de eventos, y `maxConcurrentRequests`, que es el umbral superior de peticiones HTTP que HubSpot realizará en un período de tiempo determinado.                                                                                                                                                                                                        |
| `subscriptions`<span style={{color:"red"}}>\*</span> | Objeto | Un objeto que especifica los tipos de suscripción a los que se suscribirá la aplicación.                                                                                                                                                                                                                                                                                                                                                                                                             |
| `crmObjects`                                         | Matriz | <p>Matriz que contiene definiciones de suscripción a eventos. Esta es la matriz estándar que hay que incluir, y debe utilizarse para todos los eventos en el [nuevo formato](/apps/legacy-apps/public-apps/create-generic-webhook-subscriptions) (`object.*`).</p> <p>Por otra parte, los [tipos de suscripción a webhook anteriores](/api-reference/webhooks-webhooks-v3/guide#webhook-subscriptions) deben incluirse en las matrices `legacyCrmObjects` y `hubEvents`, dependiendo del evento.</p> |
| `legacyCrmObjects`                                   | Matriz | Matriz que contiene los [tipos de suscripción anteriores](/api-reference/webhooks-webhooks-v3/guide#webhook-subscriptions), como `contact.creation` y `deal.deletion`.                                                                                                                                                                                                                                                                                                                               |
| `hubEvents`                                          | Matriz | Una matriz que contiene los tipos de suscripción anteriores `contact.privacyDeletion` y `conversation.*`                                                                                                                                                                                                                                                                                                                                                                                             |

Para cada objeto `subscription`, se pueden especificar los siguientes campos, dependiendo del tipo de definición de suscripción al que estés suscrito (es decir, `crmObjects`, `legacyCrmObjects` o `hubEvents`) o de si estás suscrito a un cambio de propiedad específico (por ejemplo, `contact.propertyChange`).

| Campo              | Tipo     | Descripción                                                                                                                             |
| ------------------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `subscriptionType` | Cadena   | El tipo de evento al que se está suscrito.                                                                                              |
| `objectType`       | Cadena   | Para las suscripciones especificadas en la matriz `crmObjects`, especifica el objeto del CRM al que se está suscribiendo tu aplicación. |
| `propertyName`     | Cadena   | Para las suscripciones de cambio de propiedad, especifica qué propiedad desencadenará el evento del webhook.                            |
| `active`           | Booleano | Si se desencadenarán eventos webhook para esta suscripción.                                                                             |