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.
Decide si quieres una integración a nivel de Workspace o de App. Una vez en el panel de Applivery:
- 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.
- 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.
Selecciona Webhook como tipo de integración.
Introduce la URL que debe recibir los payloads del webhook.
Selecciona los eventos a los que quieres suscribirte de la lista.
Haz clic en Guardar.
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.
{
"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"
}
}
{
"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"
}
}
{
"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"
}
}
{
"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"
}
}
{
"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"
}
}
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. |