Integration Troubleshooting

Calendar Sync Issues

Google Calendar Not Syncing

Problem: Google Calendar meetings aren't appearing.

Solutions:

1. Reconnect Google Calendar:
   • Go to Settings → Integrations
   • Disconnect Google Calendar
   • Reconnect and re-authorize
2. Check Permissions:
   • Verify calendar read permissions granted
   • Check Google account permissions
3. Verify Calendar Selection:
   • Ensure correct calendar is selected
   • Check if multiple calendars need connection
4. Check Sync Settings:
   • Verify sync is enabled
   • Check sync frequency settings
5. Manual Sync:
   • Use "Sync Now" button
   • Wait for sync to complete
6. Google Account Issues:
   • Verify Google account is active
   • Check for Google service outages

Microsoft Calendar (Outlook) Issues

Problem: Outlook calendar not syncing properly.

Solutions:

1. Re-authenticate:
   • Disconnect Microsoft integration
   • Reconnect with fresh OAuth
2. Check Office 365 Status:
   • Verify Office 365 service status
   • Check for known Microsoft outages
3. Verify Account Type:
   • Ensure using work/school account if required
   • Personal accounts may have limitations
4. Permissions:
   • Grant calendar read permissions
   • Verify admin consent if required
5. Sync Frequency:
   • Adjust sync frequency if needed
   • Use manual sync for immediate updates

Zoom Calendar Issues

Problem: Zoom meetings not syncing.

Solutions:

1. Verify Zoom Connection:
   • Check Zoom account connection
   • Reconnect if needed
2. Check Zoom Settings:
   • Ensure calendar integration enabled in Zoom
   • Verify Zoom calendar permissions
3. Meeting Format:
   • Ensure meetings are properly scheduled in Zoom
   • Check meeting details are complete
4. Sync Timing:
   • Zoom calendar syncs may have delays
   • Use manual sync for immediate updates

Jira Integration Problems

Jira Connection Issues

Problem: Unable to connect Jira account.

Solutions:

1. Verify Credentials:
   • Check Jira username and API token
   • Ensure API token hasn't expired
   • Generate new API token if needed
2. Check Jira URL:
   • Verify correct Jira instance URL
   • Ensure URL format is correct (https://your-domain.atlassian.net)
3. Permissions:
   • Verify Jira account has necessary permissions
   • Check project access permissions
4. API Token:
   • Generate new API token in Jira
   • Ensure token has correct scopes
5. Jira Status:
   • Check Atlassian status page
   • Verify Jira service is operational

Jira Sync Errors

Problem: Jira issues not syncing or creating incorrectly.

Solutions:

1. Check Project Access:
   • Verify access to selected projects
   • Ensure project keys are correct
2. Field Mapping:
   • Review field mappings in integration settings
   • Ensure required fields are mapped
3. Issue Types:
   • Verify issue types exist in project
   • Check if custom fields are configured
4. Permissions:
   • Ensure Jira account can create issues
   • Check project permissions
5. Review Error Logs:
   • Check integration sync logs
   • Review specific error messages
6. Test Connection:
   • Use "Test Connection" feature
   • Verify connectivity before syncing

Salesforce Sync Errors

Salesforce Connection Issues

Problem: Unable to connect Salesforce account.

Solutions:

1. OAuth Authentication:
   • Complete OAuth flow properly
   • Grant all requested permissions
2. Salesforce Edition:
   • Verify Salesforce edition supports API access
   • Some editions have API limitations
3. Permissions:
   • Ensure user has API access enabled
   • Check profile permissions
4. Security Settings:
   • Verify IP restrictions allow platform access
   • Check trusted IP ranges
5. Re-authenticate:
   • Disconnect and reconnect Salesforce
   • Complete fresh OAuth flow

Salesforce Sync Problems

Problem: Salesforce records not syncing correctly.

Solutions:

1. Object Permissions:
   • Verify access to objects (Leads, Contacts, Opportunities)
   • Check field-level security
2. Data Validation:
   • Ensure data meets Salesforce validation rules
   • Check required fields are populated
3. Field Mapping:
   • Review field mappings
   • Verify field types match
4. Record Filters:
   • Check if filters are too restrictive
   • Review record visibility settings
5. API Limits:
   • Monitor Salesforce API usage
   • Check if limits are exceeded
6. Review Logs:
   • Check sync logs for specific errors
   • Review Salesforce debug logs

API Connection Issues

API Authentication Errors

Problem: API requests failing with authentication errors.

Solutions:

1. Verify API Key:
   • Check API key is correct
   • Ensure key hasn't expired
   • Generate new key if needed
2. Check Token:
   • Verify access token is valid
   • Refresh token if expired
3. Scopes:
   • Ensure API key has required scopes
   • Check permission grants
4. Rate Limits:
   • Check if rate limits exceeded
   • Wait for limit reset
   • Implement request throttling

API Rate Limit Issues

Problem: Getting "Rate limit exceeded" errors.

Solutions:

1. Understand Limits:
   • Review your plan's API rate limits
   • Check current usage
2. Implement Throttling:
   • Add delays between requests
   • Batch requests when possible
3. Monitor Usage:
   • Track API usage over time
   • Identify peak usage patterns
4. Upgrade Plan:
   • Consider upgrading for higher limits
   • Contact sales for custom limits
5. Optimize Requests:
   • Reduce unnecessary API calls
   • Use webhooks instead of polling
   • Cache responses when appropriate

Webhook Issues

Problem: Webhooks not receiving events.

Solutions:

1. Verify URL:
   • Check webhook URL is correct and accessible
   • Ensure URL uses HTTPS
2. Test Endpoint:
   • Verify endpoint responds correctly
   • Check endpoint returns 200 status
3. Security:
   • Verify webhook secret matches
   • Check signature validation
4. Logs:
   • Review webhook delivery logs
   • Check for delivery failures
5. Retry Logic:
   • Implement retry logic for failed deliveries
   • Handle temporary failures gracefully