# Webhooks personalizados

> Integra Applivery con webhooks para recibir notificaciones en tiempo real de nuevas Builds, feedback, informes de error y vencimiento de certificados.

Source: https://docs.applivery.com/es/app-distribution/integrations/webhooks/  •  Last updated: 2026-06-08

**Answers:** ¿Qué eventos de Applivery pueden lanzar un webhook? · ¿Dónde puedo configurar los webhooks de Applivery? · ¿Qué datos se envían en un webhook de Applivery? · ¿Cómo edito un webhook existente en Applivery?

---

**TL;DR:** Integra Applivery con webhooks para recibir notificaciones en tiempo real sobre eventos de distribución de apps como nuevas builds, registros de usuarios y crashes.

![webhooks](https://docs.applivery.com/int/_r2/media/09ac0a4e-3ad8-478f-9f15-3474973eec71/a78842cc-a70c-4563-8b35-9740ae11e2d1.png)

Integra Applivery con servicios externos usando webhooks personalizados para recibir notificaciones en tiempo real sobre eventos clave de Distribución de Apps.

Los webhooks te permiten conectar Applivery con cualquier servicio externo que acepte peticiones HTTP POST — pipelines CI/CD, paneles de control personalizados, herramientas de notificaciones, y más. Cuando ocurre un evento relevante en Applivery, se envía automáticamente un payload JSON a la URL que hayas configurado.

Para la Distribución de Apps, los siguientes eventos pueden lanzar una notificación de webhook:

-   Se ha subido una nueva **Build**.

-   Una nueva **Build** ha sido procesada y está lista para instalar.

-   Se ha recibido un nuevo **informe de feedback**.

-   Se ha recibido un nuevo **informe de error**.

-   Un **certificado Enterprise** de una App está a punto de vencer.

## Primeros pasos

Las integraciones de webhooks pueden configurarse en dos niveles:

-   **Workspace** — Las notificaciones de todas las Apps de tu organización se envían a la URL configurada.

-   **App** — Las notificaciones de una App específica se envían a la URL configurada.

**Navegar a Integraciones**

Decide si quieres una integración a nivel de Workspace o de App. Una vez en el [**panel de Applivery**](https://dashboard.applivery.io/):

-   Para **Workspace**: Ve a los Ajustes del Workspace 1 desde el menú desplegable superior, abre Integraciones 2 en el menú lateral izquierdo y haz clic en el botón + Crear integración 3.

![integrations](https://docs.applivery.com/int/_r2/media/09ac0a4e-3ad8-478f-9f15-3474973eec71/f9d029bf-b26a-4951-9f24-7f1b086ed836.png)

-   Para una **App** específica: Ve a los **Ajustes de la App** 4 y, desde el menú lateral izquierdo, selecciona **Integraciones** 5. Haz clic en el botón **\+ Crear integración** 6.

![app integration](https://docs.applivery.com/int/_r2/media/09ac0a4e-3ad8-478f-9f15-3474973eec71/3c423eaf-87f2-4da8-a4e1-74c2dd765cc9.png)

**Configurar el Webhook**

1.  Selecciona **Webhook** como tipo de integración.

2.  Introduce la **URL** que debe recibir los payloads del webhook.

3.  Selecciona los **eventos** a los que quieres suscribirte de la lista.

4.  Haz clic en **Guardar**.

![webhook configuration](https://docs.applivery.com/int/_r2/media/09ac0a4e-3ad8-478f-9f15-3474973eec71/e6adcaa6-e8b5-42fd-9616-42021457e409.png)

## Gestionar las integraciones de Webhook

Tras guardar, serás redirigido a la sección de Integraciones, donde tu nuevo webhook aparecerá listado con un resumen de su configuración:

-   **Tipo:** Webhook

-   **Configuración:** La URL de destino

-   **Eventos:** La lista de eventos suscritos

### Editar un Webhook

Ve a la sección **Integraciones** de tu Organización o App y haz clic en una integración de webhook existente. Se abrirá un panel lateral donde podrás actualizar la URL de destino y los eventos suscritos.

### Eliminar un Webhook

Abre la integración de webhook desde la sección Integraciones y haz clic en el botón **Eliminar** en el panel lateral.

## Payloads de eventos

Todas las notificaciones de webhook se entregan como peticiones HTTP POST con un cuerpo JSON. Usa el campo `action` para identificar el tipo de evento y enrutar tu lógica de procesamiento en consecuencia.

**build_created — Se lanza cuando se ha subido una nueva Build y está en cola para ser procesada, pero todavía no ha sido procesada.**

```json
{
  "action": "build_created",
  "organization": {
    "id": "5d4d1391cd523c15f50df235",
    "name": "Applivery Test",
    "url": "https://dashboard.applivery.io/test"
  },
  "application": {
    "id": "5e790ce04faa50cac52e4676",
    "name": "Awesome App",
    "url": "https://dashboard.applivery.io/test/apps/awesome-app"
  },
  "build": {
    "id": "5e79232e98d88ac68cf7d4bc",
    "url": "https://dashboard.applivery.io/test/apps/awesome-app/builds?id=5e79232e98d88ac68cf7d4bc"
  }
}
```

**build_processed — Se lanza cuando una Build se ha procesado correctamente y está lista para instalar.**

```json
{
  "action": "build_processed",
  "organization": {
    "id": "5d4d1391cd523c15f50df235",
    "name": "Applivery Test",
    "url": "https://dashboard.applivery.io/test"
  },
  "application": {
    "id": "5e790ce04faa50cac52e4676",
    "name": "Awesome App",
    "url": "https://dashboard.applivery.io/test/apps/awesome-app"
  },
  "build": {
    "id": "5e79232e98d88ac68cf7d4bc",
    "os": "android",
    "versionName": "",
    "url": "https://dashboard.applivery.io/test/apps/awesome-app/builds?id=5e79232e98d88ac68cf7d4bc"
  }
}
```

**bug_created — Se lanza cuando se ha enviado un nuevo informe de error.**

```json
{
  "action": "bug_created",
  "organization": {
    "id": "5c9921fbb9f3bb001cc5c9a9",
    "name": "Applivery Dev",
    "url": "https://dashboard.applivery.io/test"
  },
  "application": {
    "id": "5cd19870cdecf8001bef50b7",
    "name": "Awesome App",
    "url": "https://dashboard.applivery.io/test/apps/awesome-app"
  },
  "report": {
    "message": "This is a Bug message that will be included in the Report along with the technical information of the device",
    "url": "https://dashboard.applivery.io/test/apps/awesome-app/reports?id=5e7923a976b4b0e9aa4aa6a9"
  }
}
```

**feedback_created — Se lanza cuando se ha enviado un nuevo informe de feedback.**

```json
{
  "action": "feedback_created",
  "organization": {
    "id": "5c9921fbb9f3bb001cc5c9a9",
    "name": "Applivery Dev",
    "url": "https://dashboard.applivery.io/test"
  },
  "application": {
    "id": "5cd19870cdecf8001bef50b7",
    "name": "Awesome App",
    "url": "https://dashboard.applivery.io/test/apps/awesome-app"
  },
  "report": {
    "message": "This is a Feedback message that will be included in the Report along with the technical information of the device",
    "url": "https://dashboard.applivery.io/test/apps/awesome-app/reports?id=5e7923a976b4b0e9aa4aa6a9"
  }
}
```

**certificate_will_expire — Se lanza cuando un certificado Enterprise de una App se acerca a su fecha de vencimiento.**

```json
{
  "action": "certificate_application_will_expire",
  "organization": {
    "id": "5c9921fbb9f3bb001cc5c9a9",
    "name": "Applivery Dev",
    "url": "https://dashboard.applivery.io/test"
  },
  "application": {
    "id": "5cd19870cdecf8001bef50b7",
    "name": "Awesome App",
    "url": "https://dashboard.applivery.io/test/apps/awesome-app"
  },
  "numDays": "5",
  "team": {
    "name": "Applivery Test",
    "identifier": "BJ55L1KAQW"
  }
}
```

:::info
El campo `numDays` indica cuántos días faltan para que venza el certificado.
:::

## Referencia de eventos

| Acción | Disparador |
| --- | --- |
| `build_created` | Se ha subido una nueva Build y está en cola para procesarse. |
| `build_processed` | Una Build ha sido procesada y está lista para instalar. |
| `bug_created` | Se ha enviado un nuevo informe de error. |
| `feedback_created` | Se ha enviado un nuevo informe de feedback. |
| `certificate_will_expire` | Un certificado Enterprise de una App está a punto de vencer. |