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