Troubleshooting iQ-Sync: Common Issues and Fixes

How to Integrate iQ-Sync into Your Workflow in 30 Minutes

What you’ll accomplish (30 minutes)

• 0–5 min: Install and connect iQ-Sync
• 5–12 min: Configure core sync settings
• 12–20 min: Integrate with one key app/tool
• 20–27 min: Set up automation and notifications
• 27–30 min: Quick test and go-live

0–5 min — Install and connect iQ-Sync

1. Create an account or sign in at the iQ-Sync web portal.
2. Download and install the desktop client (or use the web app) for your OS.
3. Open iQ-Sync and sign in; allow required permissions when prompted.
4. Navigate to Settings > Connections and click “Connect” for the services you use (e.g., Google Workspace, Microsoft 365, Slack).

5–12 min — Configure core sync settings

1. From Settings > Sync Preferences, choose direction:
   • Two-way for full bi-directional sync.
   • One-way (source → target) to avoid overwrites.
2. Set sync frequency: choose real-time or 15-minute intervals for balanced load.
3. Enable conflict resolution policy: Last edit wins for simplicity or Prompt for safety.
4. Configure data filters to include/exclude folders, labels, or file types.

12–20 min — Integrate with one key app/tool

1. Open Integrations > Add Integration.
2. Select the primary app (example: Google Drive, Trello, or Jira).
3. Authorize iQ-Sync access using OAuth.
4. Map entities:
   • Map Google Drive folders → Project folders in iQ-Sync.
   • Map Trello boards → iQ-Sync projects or tags.
5. Save mapping and run an initial sync for that integration.

20–27 min — Set up automation and notifications

1. Go to Automations > New Rule.
2. Create a simple rule: When a file is added to Folder A → copy to Folder B and notify Slack channel.
3. Test notifications: choose Slack/Microsoft Teams, authorize, and send a test message.
4. Set retry and error-handling behavior (e.g., retry 3x with exponential backoff).

27–30 min — Quick test and go-live

1. Perform a small test: create a test file/item in the source app.
2. Verify it appears correctly in the target, metadata preserved, and notifications received.
3. Check the sync logs for errors and fix mapping or permission issues if present.
4. Switch the integration from Test → Active.

Tips for a smooth rollout

• Start with one integration and scale after 24–48 hours.
• Use one-way sync initially if worried about overwrites.
• Keep a backup snapshot before the first full sync.
• Document mappings and automation rules for team members.

Troubleshooting quick checklist

• Permissions denied → re-authenticate OAuth.
• Missing items → check filters/mappings.
• Duplicate conflicts → adjust conflict policy.
• Slow syncs → lower frequency or increase bandwidth.

Example 30-minute checklist (copyable)

• Sign in / install iQ-Sync
• Connect primary services
• Configure sync direction & frequency
• Map one key integration
• Create one automation rule
• Run test sync and verify
• Activate integration

Follow this sequence and you’ll have iQ-Sync integrated into a primary workflow within 30 minutes.