This module connects Salesforce synchronization events to Drupal's Event-Condition-Action (ECA) system. This allows you to build automated workflows that are triggered by changes in Salesforce, enabling custom logic and integrations without coding.
Salesforce ECA bridges the gap between Salesforce and Drupal's Event-Condition-Action (ECA) system, enabling automated workflows triggered by Salesforce synchronization events. Build powerful integrations without writing code.
Features
What does this module do?
- Exposes all Salesforce synchronization events (push/pull) to ECA's visual workflow builder
- Execute SOQL queries directly from ECA workflows and use results in subsequent actions
- Trigger immediate push/pull operations for specific entities without waiting for cron
- Provides Salesforce data as tokens that can be used in any ECA action
When to use this module:
- Automatically notify administrators when Salesforce sync fails
- Update related Drupal content when Salesforce data changes
- Create custom business logic around Salesforce synchronization
- Build complex integrations using ECA's visual interface instead of custom code
- Query Salesforce data on-demand for dynamic workflows
Key features:
- 10 Salesforce events available (push success/fail, pull stages, etc.)
- Full token support for all Salesforce data in workflows
- Graceful handling of optional Salesforce modules
- Rich error handling with detailed token output
Post-Installation
After installing and enabling this module:
- Create ECA workflows: Navigate to
/admin/config/workflow/ecaand create a new model - Add Salesforce events: Look for "Salesforce:" prefixed events when adding triggers to your workflow
- Configure actions: Use the included actions to execute SOQL queries or trigger push/pull operations
- Use Salesforce tokens: Access Salesforce data through tokens in any ECA action
Configuration tips:
- Push/pull events only appear if respective Salesforce modules are enabled
- Test SOQL queries in Salesforce Developer Console first
- Use token browser to explore available Salesforce data in your workflows
- Check ECA logs at
/admin/config/workflow/eca/logfor debugging
Additional Requirements
Required:
- ECA (Event-Condition-Action) - The workflow automation framework
- Salesforce Suite - At minimum: salesforce and salesforce_mapping
Optional (enables additional features):
- Salesforce Push module - Required for push events and push action
- Salesforce Pull module - Required for pull events and pull action
Similar projects
There are currently no other modules that integrate Salesforce with ECA. This module fills a specific gap for sites that use both Salesforce Suite and ECA for workflow automation.
Supporting this Module
This module is maintained by Palcera and Carlos Ospina. Support development by:
- Reporting issues and contributing patches
- Sharing your use cases and workflows
- Writing documentation and tutorials
Community Documentation
- ECA Guide - Comprehensive ECA documentation
- Salesforce Suite Documentation - Salesforce module setup
- Example workflows and tutorials coming soon!
Module Status: This is an alpha release. While core functionality has been tested, please report any issues you encounter.