=== Sync Engine – Intercom Integration for WordPress & WooCommerce ===
Contributors: ripplestep
Tags: intercom, wordpress intercom, intercom integration, user sync, woocommerce intercom
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 8.2
WC requires at least: 8.0
WC tested up to: 10.4
Stable tag: 2.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Sync WordPress and WooCommerce users, events, tags, and customer data with Intercom in real time.

== Description ==
Sync Engine is a WordPress plugin that provides a reliable Intercom integration for WordPress and WooCommerce sites.

It automatically syncs WordPress users to Intercom, updates Intercom user attributes and tags when WordPress data changes, and sends WordPress and WooCommerce events to Intercom in real time.

This plugin is ideal for SaaS, membership sites, and WooCommerce stores that want accurate Intercom user data without custom development or expensive automation tools.

= Demo Video =

See Sync Engine in action—connect WordPress and WooCommerce to Intercom, sync users, events, and tags.

[youtube https://www.youtube.com/watch?v=Gz2w-_S4aeA]

= Intercom Integration for WordPress =

Sync Engine is a complete [WordPress Intercom Integration](https://ripplestep.com/wordpress-intercom-integration/) for WordPress that seamlessly connects your site with Intercom. It automatically syncs WordPress users, updates Intercom profiles when data changes, and sends WordPress events, tags, and metadata to Intercom.

Whether you're running a membership site, LMS platform, WooCommerce store, or any WordPress site, this plugin provides a robust Intercom API WordPress integration that keeps your customer data synchronized in real-time.


= Why Choose This Intercom WordPress Plugin? =

* **Complete User Synchronization**: Automatically sync WordPress users to Intercom when they register or update their profiles. Your Intercom contacts stay up-to-date with WordPress user data including email, name, phone, avatar, and custom attributes.

* **Real-Time Event Tracking**: Send WordPress events to Intercom automatically. Track user registrations, logins, profile updates, WooCommerce orders, cart additions, and custom events. All events are synced to Intercom for powerful segmentation and automation.

* **WooCommerce Integration**: Full [WooCommerce Intercom Integration](https://ripplestep.com/intercom-woocommerce/) support. Track order events, cart activity, customer lifetime value, and purchase behavior. Sync WooCommerce customer data to Intercom custom attributes.

* **Custom Events Support**: Track any custom WordPress event and send it to Intercom. Use the simple API to track custom actions, milestones, or any user activity you want to monitor in Intercom.

* **Automatic Profile Updates**: When WordPress user data changes, Intercom user profiles are automatically updated. No manual syncing required - your Intercom contacts always reflect the latest WordPress user information.

* **Metadata & Custom Attributes**: Sync WordPress user metadata and custom fields to Intercom custom attributes. Map any WordPress user data to Intercom for comprehensive customer profiles.

* **User Segmentation**: Automatically segment users in Intercom based on WordPress roles, membership levels, purchase history, and custom attributes. Create targeted campaigns and personalized messaging.

* **Background Processing**: Uses WordPress Action Scheduler for reliable background processing. Large syncs won't slow down your site - everything happens in the background.

* **Rate Limiting**: Built-in rate limiting ensures compliance with Intercom API limits. Your syncs are reliable and won't hit API restrictions.

* **HPOS Compatible**: Fully compatible with WooCommerce High-Performance Order Storage (HPOS). Works seamlessly with both traditional and HPOS order storage systems.

* **Developer Friendly**: Extensive hooks and filters for developers. Customize event data, modify sync behavior, and integrate with other plugins easily.

* **Stay Updates**: Supports two-way style syncing where Intercom profiles stay updated as WordPress data changes

= Key Features =

= Sync WordPress Users to Intercom | WordPress Intercom User Sync  =

* Automatically sync WordPress users to Intercom on registration
* Update Intercom when WordPress user updates occur
* Sync email, name, phone, avatar, and custom attributes
* Map WordPress user roles to Intercom segments
* Select which user roles to sync
* Background processing for large user bases
* Real-time sync for immediate updates

= Send WordPress Events to Intercom | WordPress Intercom Events =

* Track WordPress user events (registration, login, logout, profile updates)
* Send WordPress events to Intercom automatically
* WooCommerce event tracking (orders, cart, purchases)
* Custom event support for any WordPress action
* Event metadata and custom properties
* Enable/disable individual events
* Event prefix customization

= Sync WordPress Tags to Intercom =
Automatically apply tags in Intercom based on WordPress roles, user activity, purchases, and custom attributes. Use tags to create targeted Intercom segments and personalized messaging.

= Intercom API WordPress Integration =

* Secure Intercom API connection
* Access token and workspace ID configuration
* Automatic contact creation and updates
* Find contacts by email
* Update existing Intercom contacts
* Error handling and retry logic
* Comprehensive logging

= WooCommerce Intercom Integration =

* Sync WooCommerce customers to Intercom
* Track WooCommerce order events
* Monitor cart activity
* Send purchase data to Intercom
* Customer lifetime value tracking
* Product and order metadata sync

= Custom Attributes & Metadata =

* Map WordPress user metadata to Intercom custom attributes
* Sync custom fields to Intercom
* Update Intercom custom attributes when WordPress data changes
* Support for any WordPress user meta field
* Flexible field mapping

= User Segmentation & Tagging =

* Automatically tag users in Intercom based on WordPress roles
* Create segments from WordPress user data
* Sync membership levels and subscription status
* Track user activity and engagement
* Build targeted Intercom segments

= Developer Features =

* Extensive WordPress hooks and filters
* Custom event tracking API
* Modify event data before sending
* Prevent events from being sent
* Register custom event hooks
* Action scheduler integration
* Comprehensive logging system

= Use Cases =

This WordPress Intercom integration plugin is perfect for:

* **E-commerce Stores**: WooCommerce Intercom integration for tracking customer purchases, cart abandonment, and order events. Sync customer data and create targeted campaigns.

* **Membership Sites**: Sync WordPress users to Intercom for membership platforms. Track registrations, renewals, and member activity. Automate member communications.

* **LMS Platforms**: Connect learning management systems with Intercom. Track course enrollments, completions, and student progress. Sync student data to Intercom.

* **SaaS Applications**: WordPress Intercom sync for SaaS platforms. Track user signups, feature usage, and subscription changes. Monitor KPIs and user behavior.

* **Content Sites**: Send WordPress events to Intercom for content sites. Track user engagement, article views, and content interactions.

* **Any WordPress Site**: If you need to connect Intercom to WordPress, this plugin provides the complete solution for user sync and event tracking.

= Installation =

= Step 1: Install the Plugin =

1. Log in to your WordPress admin dashboard
2. Navigate to Plugins → Add New
3. Search for "Sync Engine for Intercom" or "WordPress Intercom integration"
4. Click "Install Now" and then "Activate"

Alternatively, upload the plugin files to `/wp-content/plugins/sync-engine-for-intercom/` directory, or install the plugin through the WordPress plugins screen directly.

= Step 2: Connect to Intercom API =

1. Go to **Intercom Sync** in your WordPress admin menu
2. Navigate to the **Connection** page
3. Get your Intercom Access Token from your Intercom workspace:
   * Go to Settings → Developers → Developer Hub in Intercom
   * Create a new app or use an existing one
   * Copy your Access Token
4. Enter your Intercom Access Token and Workspace ID
5. Click "Save Connection" to test the connection

= Step 3: Configure User Sync =

1. Go to **Intercom Sync → User Sync**
2. Enable "User Sync" toggle
3. Select which WordPress user roles to sync to Intercom
4. Choose which user data fields to sync (email, name, phone, avatar, etc.)
5. Click "Save Settings"

Your WordPress users will now automatically sync to Intercom when they register or update their profiles.

= Step 4: Configure Events =

1. Go to **Intercom Sync → Events**
2. Enable the WordPress events you want to track:
   * User Registration
   * User Login
   * User Logout
   * Profile Updates
   * WooCommerce Order Events (if WooCommerce is installed)
   * Cart Events
3. Configure event prefixes if needed
4. Events will automatically sync to Intercom

= Step 5: Test the Integration =

1. Create a test WordPress user or update an existing user profile
2. Check your Intercom workspace to verify the contact was created/updated
3. Perform a test action (login, order, etc.) and verify the event appears in Intercom
4. Review the Logs page for any sync issues

= Frequently Asked Questions =

= How do I connect Intercom to WordPress? =

Install the Sync Engine for Intercom plugin, go to Intercom Sync → Connection, and enter your Intercom Access Token and Workspace ID. The plugin will automatically connect to the Intercom API and start syncing your WordPress users.

= Does this plugin sync WordPress users to Intercom automatically? =

Yes! Once configured, the plugin automatically syncs WordPress users to Intercom when they register or update their profiles. You can select which user roles to sync and which data fields to include.

= Can I send WordPress events to Intercom? =

Absolutely. The plugin tracks WordPress events (user registration, login, profile updates) and WooCommerce events (orders, cart activity) and automatically sends them to Intercom. You can also track custom events using the provided API.

= Is this plugin free? =

Yes, Sync Engine is free to use. Advanced features are offered in premium version. For support or questions, use our [contact form](https://ripplestep.com/contact/).

= Does this work with WooCommerce? =

Yes, this plugin includes full [WooCommerce Intercom Integration](https://ripplestep.com/intercom-woocommerce/). It syncs WooCommerce customers to Intercom, tracks order events, monitors cart activity, and sends purchase data to Intercom for segmentation and automation.

= How do I sync custom WordPress user metadata to Intercom? =

The plugin automatically maps WordPress user metadata to Intercom custom attributes. Any WordPress user meta fields are synced to Intercom, allowing you to use WordPress data in Intercom segments and workflows.

= Can I update Intercom when WordPress user updates occur? =

Yes, the plugin automatically updates Intercom user profiles whenever WordPress user data changes. This includes profile updates, role changes, and metadata modifications.

= Does this plugin support custom events? =

Yes, you can track custom WordPress events and send them to Intercom using the `track_custom_event()` method. This allows you to track any user action or milestone you want to monitor in Intercom.

= How do I track WordPress Intercom KPIs? =

The plugin sends WordPress events and user data to Intercom, which you can then use to track KPIs in Intercom's analytics. This includes user registrations, engagement, purchases, and custom metrics.

= Will this slow down my WordPress site? =

No, the plugin uses WordPress Action Scheduler for background processing. All syncs happen in the background, so they won't impact your site's performance.

= Can I use this with membership plugins? =

Yes, the plugin works with all WordPress membership plugins, LMS platforms, and user management systems. It syncs WordPress users regardless of how they're managed.

= How do I segment users in Intercom based on WordPress data? =

The plugin automatically syncs WordPress user roles, metadata, and custom attributes to Intercom. You can then use this data in Intercom to create segments based on WordPress roles, membership levels, purchase history, and any custom fields.

= What WordPress events are tracked? =

The plugin tracks user registration, login, logout, profile updates, WooCommerce order creation, order completion, cart item additions, and any custom events you define.

= Can I prevent certain events from being sent to Intercom? =

Yes, you can disable individual events in the Events settings page, or use the `rpplstp_iws_should_send_event` filter to programmatically prevent events from being sent.


= Screenshots =

1. Intercom integration setup in WordPress
2. Sync WordPress users to Intercom
3. WooCommerce customer and revenue sync with Intercom
4. Send WordPress and WooCommerce events to Intercom

= Changelog =

= 2.0.1 =
* Async Role Tag Added
* HPOS Compatiblity 
* Reduced API Calls for User Sync And Event Sync
* Used Rate Limiting along With Instant Async Call 


= 1.0.3 =
* Initial release
* WordPress Intercom user sync functionality
* Automatic profile updates when WordPress user data changes
* WordPress event tracking and syncing to Intercom
* WooCommerce Intercom integration
* Custom event support
* Metadata and custom attributes sync
* User segmentation and tagging
* Background processing with Action Scheduler
* Rate limiting for Intercom API compliance
* Comprehensive logging system
* Developer hooks and filters

= Upgrade Notice =

= 1.0.3 =
Initial release of Sync Engine for Intercom. Install to start syncing WordPress users and events to Intercom.

== Plugin Name Variations ==

This plugin may also be referred to as:
* WordPress Intercom Sync
* Intercom WordPress Integration
* WordPress to Intercom Sync
* Intercom Sync for WordPress
* WP Intercom Connector
* WordPress Intercom Connector
