Use FlashWombat Flow Actions

FlashWombat actions let an active Shopify Flow workflow create or update a product QR placement, change campaign lifecycle behavior, or inspect one placement's configuration health.

Add an Action to a Workflow

1. In Shopify admin, go to Apps > Flow.
2. Select Create workflow.
3. Choose the trigger that should start the workflow.
4. Add any conditions that should prevent the action from running in the wrong situation.
5. Select Then > Action, choose FlashWombat from the installed apps, and select an action.
6. Configure the action. For actions with a custom configuration page, select the target and save the configuration before returning to Flow.
7. Test the workflow, then turn it on.

Follow Shopify's workflow editor guide for the current editor controls.

tip

Use a product-bound target when an earlier workflow step supplies the Shopify product and the campaign was created by Create or update product QR placement. Use an explicit target when you want the workflow tied to one existing FlashWombat campaign or placement.

Create or Update a Product QR Placement

Use Create or update product QR placement when a product event should create a campaign and named QR placement, or update the asset previously bound to the same automation.

Configure these fields:

Field	What to enter
Contract version	1
Product	The product supplied by the workflow
Destination mode	product_page or ready_cart
Variant GID	Optional for product pages; required for a multi-variant ready cart
Ready-cart quantity	A whole number from 1 to 999; ignored in product-page mode
Existing discount codes	Optional comma-separated Shopify discount codes for a ready cart
Placement name template	Text with optional {{product_title}} and {{variant_title}} tokens
Placement category	packaging, insert, poster, event, retail_display, or other
Duplicate policy	update to reuse the bound asset or create to make another asset
Initially active	Whether a newly created campaign can serve visits immediately
Design preset identifier	Optional; use default for the safe black-and-white design

The action does not create discount codes or guarantee that a code is currently valid. Existing bound campaigns keep their current active state and design, so a retry does not unexpectedly overwrite a deployed QR design.

Set a QR Campaign's State

Use Set QR campaign state to request an active or inactive campaign state.

1. Set Contract version to 1.
2. Choose product_bound for a product campaign created by the product QR action, or explicit for a campaign selected on the custom configuration page.
3. Set Desired state to active or inactive.
4. Review the configuration warning before allowing deployed QR material to become unavailable.

Existing start and end dates still apply. Deactivating a campaign does not remove schedules, fallbacks, or its printed QR identity. FlashWombat checks the current deployment and fallback state again when the action runs.

Change Lifecycle Fallbacks

Use Change QR fallback destination to control where visits go before a campaign starts, while it is manually inactive, or after it expires.

1. Select a product_bound or explicit target.
2. Choose one or more lifecycle slots: before start, manually inactive, or after expiry.
3. Choose replace to set a fallback or clear to disable the selected fallbacks.
4. For a replacement, choose the store home page, a referenced product, or a saved destination.
5. Review and save the custom configuration.

The action changes only the selected fallback slots. It does not change the active campaign destination or the public URL encoded in printed QR material. If the requested replacement is not valid when the action runs, FlashWombat leaves the existing fallback in place.

Run a QR Health Check

Use Run QR health check to evaluate one named placement and make the result available to later Flow conditions.

Choose a product-bound placement or select an explicit placement on the custom configuration page. The result includes:

• status: healthy, attention, broken, or could_not_complete.
• finding_count and highest_severity.
• Bounded finding_codes for routing a workflow.
• Placement name, deployment state, check time, and an authenticated admin URL.
• check_completed and a safe error_code when a dependency prevents a complete check.

The action does not change the campaign. It checks FlashWombat configuration without fetching arbitrary destination URLs, so external DNS, TLS, regional availability, and destination page content remain outside the result.

Practical Workflow Ideas

• When a product is created or reaches a launch-ready status, create its product QR placement.
• Before a scheduled print run, check one placement and continue only when its status is healthy.
• At the end of a seasonal campaign, deactivate it while retaining a configured after-expiry fallback.
• When a product changes, replace selected lifecycle fallbacks without changing the printed QR code.

These are examples, not preconfigured templates. Build and activate each workflow in Shopify Flow for your store.