Importing BPMN Processes

If your organization already has business processes modeled in tools like Camunda, MEGA HOPEX, Signavio, ARIS, or Bizagi, you can import them directly into MeetLoyd. BPMN 2.0 XML (ISO 19510) is the universal interchange format, and MeetLoyd converts it into draft workflows ready for AI agent assignment.

This guide covers the import wizard, element mapping, supported tools, and current limitations.

How It Works

The import follows a three-step wizard:

1. Upload and Validate — drop your .bpmn or .xml file
2. Preview — review the mapped workflow, warnings, and unmapped elements
3. Assign Agents — pick which agents handle each task (or skip and assign later)

The result is a draft workflow that you can further customize in the visual editor before activating.

Step-by-Step Guide

1. Open the Import Dialog

Navigate to Workflows and click the Import BPMN button next to "New Workflow".

2. Upload Your BPMN File

Drag and drop your .bpmn or .xml file into the upload zone, or click to browse. Files up to 5 MB are supported (typical BPMN files are 50-500 KB).

The system automatically validates:

• Well-formed XML with BPMN namespace
• At least one start event and one end event
• All elements are reachable from the start event

If validation fails, you see specific error messages explaining what needs to be fixed in the source tool.

3. Review the Preview

After validation passes, you see a preview of the mapped workflow:

• Mapped nodes — each BPMN element converted to a MeetLoyd node type
• Agent slots — tasks that need an agent assigned
• Warnings — elements that were approximated or partially supported
• Unmapped elements — BPMN constructs that could not be imported

You can rename the workflow at this stage.

4. Assign Agents

For each agent slot, you can either select an existing agent from your team or leave it as a placeholder and assign later from the workflow editor.

tip

If your BPMN file uses lanes (swim lanes), the import suggests roles based on lane names to help you pick the right agent.

5. Confirm Import

Click Import Workflow to create the draft workflow. You can then open it in the visual workflow editor to fine-tune, assign remaining agents, configure conditions and timeouts, and activate when ready.

Element Mapping

Here is how BPMN elements map to MeetLoyd workflow nodes:

BPMN Element	MeetLoyd Node	What Happens
Start Event	Start	Entry point of the workflow
End Event	End	Exit point
Service Task	Agent	Placeholder for an AI agent
User Task	Human	Human-in-the-loop approval step
Script Task	Transform	Script stored as description (never executed directly)
Send/Receive Task	Webhook	HTTP integration placeholder
Exclusive Gateway	Condition	Conditional branching
Parallel Gateway (fork)	Parallel	Execute branches concurrently
Parallel Gateway (join)	Merge	Wait for all branches
Timer Event	Delay	Wait for specified duration
Sub-Process	Flattened	Child elements are inlined into the main flow

Conditions

BPMN condition expressions are mapped to MeetLoyd's template syntax where possible. Complex expressions that cannot be automatically converted are preserved as comments, and you see a warning to configure them manually.

Gateways

BPMN gateways can serve as both a join point (multiple incoming flows) and a fork point (multiple outgoing flows) simultaneously. MeetLoyd separates these into a merge node followed by a parallel or condition node, connected automatically.

Supported Export Tools

Any tool that produces standard BPMN 2.0 XML is supported. The importer detects the source tool from the XML metadata and handles tool-specific quirks automatically.

Tool	Status
Camunda Modeler	Fully supported
MEGA HOPEX	Fully supported
Signavio	Fully supported
Bizagi	Fully supported
ARIS	Fully supported
draw.io (BPMN mode)	Fully supported

Limitations (v1)

Some BPMN constructs are partially supported or approximated:

BPMN Feature	Handling
Inclusive gateways	Treated as exclusive (warning issued)
Complex gateways	Treated as exclusive
Signal/compensation events	Skipped with warning
Message flows between pools	Not supported (single-process import)
Data store references	Noted in descriptions
Multi-instance tasks	Approximated as loops

All limitations produce clear warnings during preview so you know exactly what was approximated.

Tips

• Export as BPMN 2.0 XML — make sure your tool exports standard BPMN, not a proprietary format
• Keep it under 100 tasks — very large processes work but are easier to manage when split into smaller workflows
• Use lanes — lane names in your BPMN diagram become role suggestions during agent assignment
• Add documentation — BPMN task documentation annotations become node descriptions in MeetLoyd
• Start with draft — imported workflows are always created as drafts, giving you time to review and configure before activation

---

Next: Learn more about Workflows and how to build them from scratch.