Skip to content
Guía del Centro de ayuda · Flujos y automatización
3 min de lecturaVerificado 2026-11-16

Configuración de flujos de trabajo

Define disparadores y cambios de plantilla dentro de tus Wallet Experiences sin salir del panel.

En esta guía

Descripción general

Passinstance ofrece dos motores de automatización complementarios dentro del Panel de control (/workflows, /automations y /settings/workspace/integrations):

  1. 1
    Motor de flujos de trabajo (Workflow Engine API en /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_CONDITION y DELAY.
  2. 2
    Automatizaciones universales (Automations API en /api/v1/automations): Reglas de e-commerce y PassFlow basadas en políticas compatibles con ExistingCardPolicy (REUSE_AND_UPDATE, ISSUE_ADDITIONAL, REPLACE, NO_OP, etc.) y ConflictResolutionPolicy (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/workflows requiere permisos de edición de plantillas (templates:manage) y al menos una plantilla de pase publicada. Los flujos recién creados comienzan en estado DRAFT o INACTIVE hasta que se activan mediante POST /api/v1/workflows/:workflowId/activate.

Canalización de ejecución de flujos de trabajo

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
MOTOR DE FLUJOS DIRIGIDO POR EVENTOS Y PROCESADOR
ACTORES DEL SISTEMA
P1 Bus de eventos / Cron
P2 Workflow Engine API y Matcher
P3 Workflow Execution Engine (Cola Bull)
PASO 1 SOLICITUD / ACCIÓN Emitir evento disparador
PASO 2 SOLICITUD / ACCIÓN Buscar flujos activos
›
TIER_CHANGED, PASS_SCANNED)
›
(status: ACTIVE, filters)
PASO 3 SOLICITUD / ACCIÓN Encolar trabajo de ejecución
PASO 4 SOLICITUD / ACCIÓN Evaluar condiciones
›
y acciones IF_CONDITION
PASO 5 SOLICITUD / ACCIÓN Ejecutar acciones[] ordenadas
›
(DELAY, SEND_PUSH_NOTIFICATION,
›
SWITCH_WALLET_EXPERIENCE)

Gestión de flujos de trabajo vía REST (Workflow Engine API)

MétodoEndpointDescripción
GET/api/v1/workflowsLista los flujos de trabajo del espacio de trabajo (filtrables por status en workflow status: DRAFT, ACTIVE, PAUSED, INACTIVE, ARCHIVED, ERROR).
POST/api/v1/workflowsCrea un nuevo flujo usando request payload (name, trigger, actions, conditions, tags).
GET/api/v1/workflows/:workflowIdRecupera la definición del flujo, el historial de ejecuciones (/:workflowId/executions) y los registros (/:workflowId/logs).
PUT/api/v1/workflows/:workflowIdActualiza disparadores, condiciones, acciones o status del flujo (request payload).
POST/api/v1/workflows/:workflowId/activateActiva un flujo de inmediato (deactivate pausa la ejecución; trigger lo ejecuta manualmente).
DELETE/api/v1/workflows/:workflowIdElimina 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 disparadorValores de workflow trigger typeCuándo se activa
Ciclo de vida de pase y plantillaPASS_CREATED, PASS_UPDATED, PASS_SCANNED, PASS_VOIDED, PASS_DELETED, PASS_DOWNLOADED, TEMPLATE_CREATED, TEMPLATE_UPDATEDInmediatamente cuando se crea, modifica, escanea, anula, elimina o descarga un pase o una plantilla.
Wallet, mecánicas y consentimientoPASS_INSTALLED, PASS_REMOVED, USER_OPT_IN, USER_OPT_OUT, POINTS_UPDATED, TIER_CHANGED, BALANCE_CHANGED, EVENT_EXPIRED, PASS_INACTIVE, SCAN_PERFORMEDCuando 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ónUSER_REGISTERED, USER_LOGIN, USER_PROFILE_UPDATED, SUBSCRIPTION_CHANGED, PAYMENT_RECEIVED, PAYMENT_FAILED, WEBHOOK_RECEIVED, API_CALL, SCHEDULED, MANUAL, CUSTOM_API_EVENTAnte 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):

JSON
{
  "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.

Documentación de producto y API relacionada

¿Listo para lanzar su primer programa de tarjetas Wallet?

Cree su espacio de trabajo, configure su plantilla y pruebe una tarjeta real en Apple Wallet y Google Wallet antes de escalar.