Descripción general
Passinstance ofrece dos motores de automatización complementarios dentro del Panel de control (/workflows, /automations y /settings/workspace/integrations):
-
1
Motor de flujos de trabajo (
Workflow Engine APIen/api/v1/workflows): Máquinas de estado DAG dirigidas por eventos respaldadas por workflow trigger type (29 tipos de disparadores), workflow action type (25 tipos de acciones),IF_CONDITIONyDELAY. -
2
Automatizaciones universales (
Automations APIen/api/v1/automations): Reglas de e-commerce y PassFlow basadas en políticas compatibles conExistingCardPolicy(REUSE_AND_UPDATE,ISSUE_ADDITIONAL,REPLACE,NO_OP, etc.) yConflictResolutionPolicy(ALLOW_ALL,RUN_ALL,HIGHEST_PRIORITY,BEST_OFFER,FIRST_MATCH,EXCLUSIVE,EXCLUSIVE_BY_SCOPE).
Requisitos previos: Crear o modificar flujos de trabajo mediante
POST /api/v1/workflowsrequiere permisos de edición de plantillas (templates:manage) y al menos una plantilla de pase publicada. Los flujos recién creados comienzan en estadoDRAFToINACTIVEhasta que se activan mediantePOST /api/v1/workflows/:workflowId/activate.
Canalización de ejecución de flujos de trabajo
Gestión de flujos de trabajo vía REST (Workflow Engine API)
| Método | Endpoint | Descripción |
|---|---|---|
| GET | /api/v1/workflows | Lista los flujos de trabajo del espacio de trabajo (filtrables por status en workflow status: DRAFT, ACTIVE, PAUSED, INACTIVE, ARCHIVED, ERROR). |
| POST | /api/v1/workflows | Crea un nuevo flujo usando request payload (name, trigger, actions, conditions, tags). |
| GET | /api/v1/workflows/:workflowId | Recupera la definición del flujo, el historial de ejecuciones (/:workflowId/executions) y los registros (/:workflowId/logs). |
| PUT | /api/v1/workflows/:workflowId | Actualiza disparadores, condiciones, acciones o status del flujo (request payload). |
| POST | /api/v1/workflows/:workflowId/activate | Activa un flujo de inmediato (deactivate pausa la ejecución; trigger lo ejecuta manualmente). |
| DELETE | /api/v1/workflows/:workflowId | Elimina un flujo de trabajo y cancela los trabajos diferidos pendientes. |
Disparadores compatibles (workflow trigger type)
La enumeración workflow trigger type de Passinstance database define los 29 tipos canónicos de disparadores de flujos de trabajo:
| Categoría del disparador | Valores de workflow trigger type | Cuándo se activa |
|---|---|---|
| Ciclo de vida de pase y plantilla | PASS_CREATED, PASS_UPDATED, PASS_SCANNED, PASS_VOIDED, PASS_DELETED, PASS_DOWNLOADED, TEMPLATE_CREATED, TEMPLATE_UPDATED | Inmediatamente cuando se crea, modifica, escanea, anula, elimina o descarga un pase o una plantilla. |
| Wallet, mecánicas y consentimiento | PASS_INSTALLED, PASS_REMOVED, USER_OPT_IN, USER_OPT_OUT, POINTS_UPDATED, TIER_CHANGED, BALANCE_CHANGED, EVENT_EXPIRED, PASS_INACTIVE, SCAN_PERFORMED | Cuando cambia el registro en dispositivos Apple/Google Wallet, se alterna el consentimiento de marketing o se alcanzan umbrales de puntos, nivel o saldo. |
| Usuario, facturación y programación | USER_REGISTERED, USER_LOGIN, USER_PROFILE_UPDATED, SUBSCRIPTION_CHANGED, PAYMENT_RECEIVED, PAYMENT_FAILED, WEBHOOK_RECEIVED, API_CALL, SCHEDULED, MANUAL, CUSTOM_API_EVENT | Ante eventos de usuario/pago, recepción de webhooks entrantes (POST /api/v1/workflows/webhook/:customerId/:workflowId), programaciones cron (normalizadas a la zona horaria del espacio de trabajo) o ejecuciones manuales/vía API. |
Ejemplo: creación de un flujo de seguimiento por ascenso de nivel (POST /api/v1/workflows)
request payload acepta un objeto trigger en el nivel superior y un arreglo ordenado actions (IWorkflowActionConfig[]), junto con los campos opcionales conditions, dataMapping, maxRetries (por defecto 3) y timeout (por defecto 300 segundos):
{
"name": "Gold Tier Upgrade Celebration & Companion Voucher",
"description": "Sends congratulatory push and waits 1 hour before issuing bonus drink voucher",
"trigger": {
"type": "TIER_CHANGED",
"filters": {
"templateId": "tmpl_loyalty_01"
}
},
"conditions": {
"field": "pass.tier",
"operator": "EQUALS",
"value": "GOLD"
},
"actions": [
{
"type": "SEND_PUSH_NOTIFICATION",
"name": "Gold Upgrade Alert",
"config": {
"message": "Welcome to Gold Tier! Enjoy 2x points on every visit."
}
},
{
"type": "DELAY",
"name": "Wait 60 Minutes",
"config": {
"durationMinutes": 60
}
},
{
"type": "GENERATE_ADDITIONAL_PASS",
"name": "Issue Companion Voucher",
"config": {
"targetTemplateId": "tmpl_gold_welcome_drink",
"linkToParentPass": true
}
}
],
"tags": ["loyalty", "gold-tier"]
}
Explore todos los tipos de acciones en Operaciones automatizadas de pases y la orquestación visual en /workflow-engine.
