Configurar suscripciones a webhooks (BETA)

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

├──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.

{
  "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
        }
      ]
    }
  }
}

Los campos marcados con * son obligatorios.

Campo	Tipo	Descripción
`uid`*	Cadena	Un identificador único interno para el componente del webhook.
`type`*	Cadena	El tipo de componente, que en este caso debe ser `webhooks`.
`settings`*	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`*	Objeto	Un objeto que especifica los tipos de suscripción a los que se suscribirá la aplicación.
`crmObjects`	Matriz	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 (`object.*`). Por otra parte, los tipos de suscripción a webhook anteriores deben incluirse en las matrices `legacyCrmObjects` y `hubEvents`, dependiendo del evento.
`legacyCrmObjects`	Matriz	Matriz que contiene los tipos de suscripción anteriores, 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.

Crear aplicaciones

Agregar funciones

Publicar en el mercado de HubSpot

Configurar suscripciones a webhooks (BETA)

Estructura del directorio

Configuración del webhook

​Estructura del directorio

​Configuración del webhook

Estructura del directorio

Configuración del webhook