Skip to content
Guia da Central de Ajuda · Fluxos e automação
3 min de leituraVerificado 2026-11-16

Configuração de fluxos de trabalho

Defina gatilhos e regras de mudança de modelo nas Wallet Experiences diretamente no seu painel.

Neste guia

Visão geral

O Passinstance disponibiliza dois motores complementares de automatização no Painel (/workflows, /automations e /settings/workspace/integrations):

  1. 1
    Motor de Fluxos de Trabalho (Workflow Engine API em /api/v1/workflows): Máquinas de estado DAG orientadas a eventos apoiadas por workflow trigger type (29 tipos de acionadores), workflow action type (25 tipos de ações), IF_CONDITION e DELAY.
  2. 2
    Automatizações Universais (Automations API em /api/v1/automations): Regras orientadas por políticas para comércio eletrónico e PassFlow compatíveis com ExistingCardPolicy (REUSE_AND_UPDATE, ISSUE_ADDITIONAL, REPLACE, NO_OP, etc.) e ConflictResolutionPolicy (ALLOW_ALL, RUN_ALL, HIGHEST_PRIORITY, BEST_OFFER, FIRST_MATCH, EXCLUSIVE, EXCLUSIVE_BY_SCOPE).

Pré-requisitos: A criação ou modificação de fluxos via POST /api/v1/workflows requer permissões de edição de modelos (templates:manage) e pelo menos um Modelo de Cartão publicado. Os fluxos recém-criados iniciam em DRAFT ou INACTIVE até serem ativados em POST /api/v1/workflows/:workflowId/activate.

Pipeline de Execução de Fluxos

FLUXO DE ARQUITETURA
ARQUITETURA INTERATIVA
MOTOR DE FLUXOS ORIENTADO A EVENTOS E PROCESSADOR
ATORES DE SISTEMA PARTICIPANTES
P1 Barramento de Eventos / Cron
P2 Workflow Engine API & Matcher
P3 Workflow Execution Engine (Fila Bull)
ETAPA 1 PEDIDO / AÇÃO Emitir Evento Acionador
ETAPA 2 PEDIDO / AÇÃO Associar Fluxos Ativos
›
TIER_CHANGED, PASS_SCANNED)
›
(status: ACTIVE, filters)
ETAPA 3 PEDIDO / AÇÃO Enfileirar Tarefa Execução
ETAPA 4 PEDIDO / AÇÃO Avaliar condições
›
e ações IF_CONDITION
ETAPA 5 PEDIDO / AÇÃO Executar actions[] ordenadas
›
(DELAY, SEND_PUSH_NOTIFICATION,
›
SWITCH_WALLET_EXPERIENCE)

Gerir Fluxos de Trabalho via REST (Workflow Engine API)

MétodoEndpointDescrição
GET/api/v1/workflowsLista fluxos do espaço de trabalho (filtráveis por status em workflow status: DRAFT, ACTIVE, PAUSED, INACTIVE, ARCHIVED, ERROR).
POST/api/v1/workflowsCria um novo fluxo utilizando request payload (name, trigger, actions, conditions, tags).
GET/api/v1/workflows/:workflowIdObtém a definição do fluxo, histórico de execuções (/:workflowId/executions) e registos (/:workflowId/logs).
PUT/api/v1/workflows/:workflowIdAtualiza acionadores, condições, ações ou status (request payload).
POST/api/v1/workflows/:workflowId/activateAtiva um fluxo de imediato (deactivate pausa a execução; trigger executa manualmente).
DELETE/api/v1/workflows/:workflowIdElimina um fluxo e cancela tarefas agendadas em atraso.

Acionadores Suportados (workflow trigger type)

O enum Passinstance database workflow trigger type define todos os 29 tipos canónicos de acionadores de fluxo:

Categoria de AcionadorValores workflow trigger typeQuando É Disparado
Ciclo de Vida Cartão & ModeloPASS_CREATED, PASS_UPDATED, PASS_SCANNED, PASS_VOIDED, PASS_DELETED, PASS_DOWNLOADED, TEMPLATE_CREATED, TEMPLATE_UPDATEDImediatamente quando um cartão ou modelo é criado, alterado, lido, anulado, eliminado ou transferido.
Wallet, Mecânicas e Opt-InPASS_INSTALLED, PASS_REMOVED, USER_OPT_IN, USER_OPT_OUT, POINTS_UPDATED, TIER_CHANGED, BALANCE_CHANGED, EVENT_EXPIRED, PASS_INACTIVE, SCAN_PERFORMEDQuando o registo em dispositivo Apple/Google Wallet muda, o consentimento altera ou limites de pontos/patamar/saldo são atingidos.
Utilizador, Faturação e AgendaUSER_REGISTERED, USER_LOGIN, USER_PROFILE_UPDATED, SUBSCRIPTION_CHANGED, PAYMENT_RECEIVED, PAYMENT_FAILED, WEBHOOK_RECEIVED, API_CALL, SCHEDULED, MANUAL, CUSTOM_API_EVENTEm eventos de utilizador/pagamento, receção de webhooks de entrada (POST /api/v1/workflows/webhook/:customerId/:workflowId), agendamentos cron (normalizados ao fuso horário do espaço) ou execuções manuais/API.

Exemplo: Criar um Fluxo de Seguimento para Subida de Patamar (POST /api/v1/workflows)

request payload aceita um objeto principal trigger e um array ordenado actions (IWorkflowActionConfig[]), juntamente com conditions, dataMapping, maxRetries (predefinição 3) e timeout (predefinição 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 os tipos de ações em Operações Automatizadas de Cartões e orquestração visual em /workflow-engine.

Documentação de produto e API relacionada

Pronto para lançar o seu primeiro programa de cartões Wallet?

Crie o seu espaço de trabalho, configure o seu modelo e teste um cartão real na Apple Wallet e Google Wallet antes de escalar.