Key Concepts in Soom Connect

Understanding the core concepts and terminology is essential for effectively using Soom Connect. This guide covers the fundamental concepts you'll encounter when building integrations and workflows.

Core Concepts

Flows

Flows are the central concept in Soom Connect. A flow represents a complete integration workflow that:

• Connects Applications: Links different systems and services
• Processes Data: Transforms and routes data between systems
• Handles Events: Responds to triggers and events
• Manages Errors: Handles errors and retry logic

Connectors

Connectors are pre-built components that enable integration with specific applications or services:

• Pre-configured: Ready-to-use integration components
• Authentication: Handle authentication and authorization
• Data Mapping: Map data between different formats
• Error Handling: Built-in error handling and retry logic

Triggers

Triggers are events that start a flow execution:

• Event Triggers: Respond to external events
• Schedule Triggers: Run flows on a schedule
• Manual Triggers: Start flows manually
• Webhook Triggers: Respond to webhook calls

Actions

Actions are the steps that perform work in a flow:

• Data Actions: Process and transform data
• Integration Actions: Connect with external services
• Logic Actions: Implement conditional logic
• Notification Actions: Send notifications and alerts

Data Flow Concepts

Data Mapping

Data mapping defines how data is transformed between different systems:

• Field Mapping: Map fields between different data structures
• Data Transformation: Convert data formats and types
• Data Validation: Validate data before processing
• Data Enrichment: Add additional data to existing records

Data Routing

Data routing determines where data is sent:

• Conditional Routing: Route data based on conditions
• Parallel Processing: Send data to multiple destinations
• Error Routing: Handle data that fails validation
• Transformation Routing: Route data through transformation steps

Integration Concepts

Authentication

Authentication ensures secure access to external services:

• OAuth: OAuth 2.0 authentication flow
• API Keys: Simple API key authentication
• Basic Auth: Username and password authentication
• Custom Auth: Custom authentication methods

Rate Limiting

Rate limiting prevents overwhelming external services:

• Request Limits: Limit the number of requests per time period
• Burst Handling: Handle sudden spikes in requests
• Queue Management: Queue requests when limits are reached
• Retry Logic: Retry failed requests with backoff

Workflow Concepts

Error Handling

Error handling ensures robust and reliable workflows:

• Error Detection: Detect and categorize errors
• Retry Logic: Automatically retry failed operations
• Fallback Actions: Execute alternative actions on failure
• Error Notifications: Notify administrators of critical errors

Monitoring and Logging

Monitoring and logging provide visibility into flow execution:

• Execution Logs: Track flow execution and performance
• Error Logs: Log errors and exceptions
• Performance Metrics: Monitor flow performance
• Alerting: Set up alerts for critical issues

Best Practices

• Design for Failure: Build resilient workflows that handle errors gracefully
• Use Appropriate Triggers: Choose the right trigger type for your use case
• Optimize Data Flow: Minimize data transformation and processing
• Monitor Performance: Track flow performance and optimize as needed
• Secure Integrations: Use proper authentication and security measures

Next Steps

• Create Flow - Build your first integration flow
• Available Apps - Explore supported applications
• Configuration - Learn about advanced configuration