Shopware Flow Builder Integration Guide for Shopware 6

1. Introduction

Shopware 6 introduced the Shopware Flow Builder, a potent low-code automation tool that lets merchants create event-driven workflows and business processes without having to write any custom code. Through visual configuration, it is intended to provide flexibility, increase efficiency, and simplify operational tasks.

With Flow Builder, merchants can create automated action sequences that are triggered by Shopware system events (e.g., order placed, payment status changed, customer registered). Every flow includes:

• Trigger (event) – such as an order status change.
• Conditions – such as payment method or customer group.
• Actions – such as sending an email, changing a status, or calling a webhook.

Benefits for Online Stores

• Automation
  Reduces manual tasks like sending emails or updating order statuses.
• Flexibility
  Offers granular control over workflows using conditions and branching logic.
• Scalability
  Suitable for small businesses as well as large-scale operations by automating complex business logic.
• Improved Customer Experience
  Enables timely and consistent communication (e.g., shipping updates, thank-you emails).
• No Coding Required
  Non-technical users can create, edit, and manage flows directly in the admin interface.

Relevant Flow Builder Use Cases in Shopware

• Send an automated email when an order is completed.
• Notify internal teams via email or webhook when high-value orders are placed.
• Automatically assign customers to different groups based on purchase behavior.
• Trigger custom actions like discount application or third-party API calls.

2. What is Shopware Flow Builder?

Shopware 6 comes with a visual workflow automation tool called Shopware Flow Builder. By responding to system events and chaining conditions and actions without requiring custom development, it enables merchants to create unique business logic. Store administrators can create flows that automate a variety of operational procedures using its user-friendly drag-and-drop interface.

Three essential components make up each flow:

• Trigger – The event that starts the flow (e.g., “Order placed”).
• Conditions – Optional filters to define when the flow should continue (e.g., “Payment method is PayPal”).
• Actions – The steps executed when the conditions are met (e.g., “Send email to customer”).

Benefits for Online Stores

• Operational Efficiency: Reduces manual tasks and improves order processing speed.
• Personalized Communication: Enhances customer engagement by automating tailored emails based on customer or order behavior.
• Error Reduction: Minimizes the risk of human error in repetitive tasks.
• Time-Saving: Quickly deploy and modify workflows via a no-code interface.
• Adaptability: Allows merchants to respond quickly to business needs or changes without developer intervention.

Relevant Flow Builder Solutions in Shopware

• Order Management: Trigger actions when order status changes (e.g., notify logistics team).
• Customer Segmentation: Assign customers to groups based on behavior or purchase history.
• Email Automation: Automatically send transactional or marketing emails.
• Payment Handling: Trigger refunds, alerts, or escalations based on payment events.
• Third-party Integrations: Use webhooks to connect to external systems and automate cross-platform tasks.

3. Requirements

Make sure your technical environment satisfies the requirements before beginning to use the Shopware Flow Builder. Compatibility, stability, and access to the newest Flow Builder features are ensured by proper setup.

Technical Prerequisites

• Shopware Edition
  Flow Builder is available in Shopware 6.4 or higher and is included in Shopware Commercial (Professional, Enterprise, Evolve) editions. It is not available in the open-source Community Edition by default.
• PHP Version & Server Requirements
  PHP 7.4 or higher (PHP 8.1+ recommended); compatible web server (Apache or NGINX); MySQL 5.7+ or MariaDB 10.3+; Composer installed for CLI work.
• API Credentials (Optional for Webhooks)
  If you plan to use webhook actions, generate a Client ID and Client Secret via the Shopware Admin API with proper permissions.
• Mail Configuration
  Ensure your email service is configured in the admin panel for automated mail-sending actions.

4. Creating Your First Flow

Once the Flow Builder plugin is installed and activated, you can begin automating processes tailored to your store’s operations. Below is a step-by-step guide to creating a basic flow.

Example: Send a Confirmation Email When an Order Is Placed

1. Navigate to Flow Builder
   Go to Settings → Flow Builder → Add Flow.
2. Define Basic Flow Information
   Name: Order Confirmation Email
   Description: (optional) Sends an email to the customer when a new order is placed.
   Priority: set based on execution order (lower numbers = higher priority).
   Active: toggle ON to enable.
3. Set a Trigger
   Under Trigger, select Order placed (Event: checkout.order.placed ).
4. Add a Condition (Optional)
   Add condition: Payment Method → is → PayPal (only if paid via PayPal).
5. Add an Action
   Choose Send email; configure recipient (Customer email), template (Order confirmation), and language.
6. Save and Test
   Save the flow (ensure Active). Place a test order to confirm the email is sent.

Other Examples of Useful Flows

• Order value above €500 → Notify sales manager via email.
• Customer registered → Send welcome discount email.
• Payment failed → Create internal task or webhook alert.

5. Testing the Flow Builder

1. Simulate the Triggering Event
   Perform the event (e.g., place a new order).
2. Check the Outcome
   Verify emails, tasks, or webhooks as configured.
3. Review Execution Logs
   In Settings → Flow Builder → Executions to see success/failure details.
4. Adjust and Re-Test
   Modify conditions/actions and repeat until correct.

6. Troubleshooting

Common Errors and Issues

• Flow Not Triggering – ensure flow is active, trigger event matches, and conditions aren’t excluding it.
• Emails Not Sent – verify SMTP settings and that the email template is assigned to the correct sales channel.
• Webhook Failures – confirm endpoint is reachable, credentials valid, payload format correct.
• Multiple Flows Conflict – use differing priorities to control execution order.

How to Find and Analyze Logs

• Execution Logs – Settings → Flow Builder → Executions.
• System Logs – server logs in /var/log/ (e.g., shopware.log ).
• Developer Tools – use Postman or browser dev tools to inspect webhook requests.

7. Best Practices & Security

Top Techniques

• Name Flows Clearly – consistent, descriptive titles ease maintenance.
• Use Conditions Wisely – avoid overly broad triggers.
• Set Priorities Strategically – leave gaps (100, 200, 300) for future flows.
• Test in Staging – validate complex flows off-line first.

Security Guidelines

• Expose webhooks only to trusted HTTPS endpoints.
• Store API credentials securely and rotate them regularly.
• Audit execution logs for suspicious activity.
• Limit administrator access via ACL roles.

8. Frequently Asked Questions (FAQ)

Q1: Is Flow Builder included in Shopware’s free Community Edition?
A: No. Flow Builder is only available in Shopware’s commercial editions (Rise, Evolve, Beyond).

Q2: Can I trigger custom events in Flow Builder?
A: Yes. Developers can dispatch custom events in code; if registered, Flow Builder can listen to them.

Q3: Can one flow contain multiple actions?
A: Absolutely. A single flow may include several sequential actions.

Q4: Does Flow Builder work in multilingual stores?
A: Yes. Assign language-specific templates and configure flows per sales channel or locale.