Google Calendar Integration Not Working

Problem Statement

The Issue

Your Google Calendar integration isn't working. This could be:

• Can't connect your Google account
• OAuth connection fails
• Events not syncing
• Sync stopped working
• Webhook errors
• Permission denied errors

Common Scenarios

Scenario 1: Connection Issues

• Clicking "Connect Google Calendar" doesn't work
• OAuth redirect fails
• Getting "OAuth not configured" error
• Connection process hangs or times out

Scenario 2: Sync Problems

• Events not appearing in Piraja CRM
• Changes in Google Calendar not reflected
• Changes in Piraja CRM not syncing to Google
• Sync was working but stopped

Scenario 3: Permission Errors

• "Access denied" errors
• "Permission required" messages
• Can't create or edit events
• Can't access calendar

Quick Diagnosis Checklist

Step 1: Check Calendar Module

The Google Calendar integration requires the Calendar module to be enabled:

1. Go to Business Settings → Modules
2. Verify Calendar module is enabled
3. If not enabled, enable it first
4. Then try connecting Google Calendar again

Step 2: Check OAuth Connection

1. Go to Modules → Google Calendar Configuration
2. Check if you see "Connected" or "Not Connected"
3. If "Not Connected", try connecting again
4. If connection fails, see OAuth troubleshooting below

Step 3: Check Sync Status

1. Go to Modules → Google Calendar Configuration
2. Look for "Last Sync" information
3. Check if sync is enabled
4. Verify sync direction (two-way, one-way, etc.)

Step 4: Check Selected Calendars

1. Go to Modules → Google Calendar Configuration
2. Verify which calendars are selected for sync
3. Ensure the calendars you want are selected
4. Check if calendars are accessible

OAuth Connection Issues

Problem: Can't Connect Google Account

Symptoms:

• Clicking "Connect Google Calendar" doesn't redirect
• OAuth page shows error
• Getting "OAuth not configured" message
• Connection process hangs

Solution 1: Verify Calendar Module is Enabled

The Google Calendar integration requires the Calendar module:

1. Go to Business Settings → Modules
2. Find Calendar module
3. Ensure it's enabled
4. If disabled, enable it
5. Try connecting Google Calendar again

Solution 2: Check OAuth Configuration

If you see "OAuth not configured" error:

This means the integration isn't set up on the server side. Contact your business administrator or support.

For Business Administrators:

• Verify Google OAuth credentials are configured
• Check environment variables are set
• Contact support if credentials are missing

Solution 3: Clear Browser Cache and Cookies

If OAuth redirect isn't working:

1. Clear browser cache
2. Clear cookies for Google and your app
3. Try in an incognito/private window
4. Try a different browser
5. Try connecting again

Solution 4: Check Redirect URI

If OAuth redirect fails:

1. Verify you're using the correct URL
2. Check that redirect URI matches configuration
3. Ensure you're not behind a proxy that blocks redirects
4. Try from a different network

Solution 5: Re-authenticate

If connection was working but stopped:

1. Go to Modules → Google Calendar Configuration
2. Click "Disconnect"
3. Wait a few seconds
4. Click "Connect Google Calendar" again
5. Complete OAuth flow

Solution 6: Check Google Account Permissions

If Google shows permission errors:

1. Go to Google Account Permissions
2. Find Piraja CRM in the list
3. Remove it if present
4. Try connecting again
5. Grant all requested permissions

Sync Problems

Problem: Events Not Syncing

Symptoms:

• Events created in Google Calendar don't appear in Piraja CRM
• Events created in Piraja CRM don't appear in Google Calendar
• Changes in one system don't reflect in the other
• Sync was working but stopped

Solution 1: Check Sync is Enabled

1. Go to Modules → Google Calendar Configuration
2. Verify "Sync Enabled" is toggled ON
3. If OFF, toggle it ON
4. Wait a few minutes for sync to run

Solution 2: Check Selected Calendars

If events from specific calendars aren't syncing:

1. Go to Modules → Google Calendar Configuration
2. Check which calendars are selected
3. Ensure the calendars you want are selected
4. Deselect and reselect calendars if needed
5. Save changes

Solution 3: Manual Sync

To force an immediate sync:

1. Go to Modules → Google Calendar Configuration
2. Look for "Sync Now" or "Manual Sync" button
3. Click it to trigger immediate sync
4. Wait a few seconds
5. Check if events appear

Solution 4: Check Sync Frequency

If sync is too slow:

1. Go to Modules → Google Calendar Configuration
2. Check sync frequency setting
3. Increase frequency if needed (minimum is usually 15 minutes)
4. Save changes

Solution 5: Check Sync Direction

If sync only works one way:

1. Go to Modules → Google Calendar Configuration
2. Check sync direction setting
3. Ensure it's set to "Two-Way" if you want bidirectional sync
4. Save changes

Solution 6: Reconnect Integration

If sync completely stopped:

1. Go to Modules → Google Calendar Configuration
2. Click "Disconnect"
3. Wait a few seconds
4. Click "Connect Google Calendar" again
5. Re-select calendars
6. Enable sync
7. Wait for initial sync to complete

Webhook Configuration

Problem: Real-Time Updates Not Working

Symptoms:

• Changes take a long time to sync
• Real-time updates not working
• Webhook errors in logs

Understanding Webhooks

Webhooks allow Google Calendar to notify Piraja CRM immediately when events change, enabling real-time synchronization.

Solution 1: Verify Webhook is Set Up

Webhooks are automatically configured when you connect:

1. Check if integration shows "Connected"
2. If connected, webhooks should be active
3. If not working, try reconnecting

Solution 2: Check Webhook Endpoint

If webhook errors appear:

1. Verify webhook endpoint is accessible
2. Check HTTPS is configured correctly
3. Ensure firewall isn't blocking webhook requests
4. Contact support if webhook endpoint is down

Solution 3: Re-register Webhook

If webhooks stopped working:

1. Disconnect Google Calendar integration
2. Wait a few minutes
3. Reconnect Google Calendar
4. Webhooks will be re-registered automatically

Solution 4: Check Webhook Logs

For Business Administrators:

1. Check server logs for webhook errors
2. Look for "webhook" or "google-calendar" in logs
3. Verify webhook requests are being received
4. Check for authentication errors

Permission Errors

Problem: Access Denied or Permission Errors

Symptoms:

• "Access denied" errors
• "Permission required" messages
• Can't create events
• Can't edit events
• Can't access calendar

Solution 1: Re-authenticate with Correct Permissions

If permissions were denied or revoked:

1. Go to Modules → Google Calendar Configuration
2. Click "Disconnect"
3. Wait a few seconds
4. Click "Connect Google Calendar" again
5. Important: Grant all requested permissions
6. Don't skip any permission requests

Solution 2: Check Google Account Permissions

If Google shows permission errors:

1. Go to Google Account Permissions
2. Find Piraja CRM in the list
3. Check if permissions are granted
4. If not, remove and reconnect
5. Grant all permissions when reconnecting

Solution 3: Verify Calendar Access

If you can't access specific calendars:

1. Check if you have access to the calendar in Google Calendar
2. Verify calendar sharing settings in Google
3. Ensure calendar is not private or restricted
4. Try selecting a different calendar

Solution 4: Check Business Admin Settings

If you're not a business admin:

1. Contact your business administrator
2. Ask them to verify integration settings
3. Ensure integration is enabled for your business
4. Check if there are any restrictions

Common Causes

Why Integration Issues Happen

1. Calendar Module Not Enabled

• Google Calendar requires Calendar module
• Solution: Enable Calendar module first

2. OAuth Configuration Missing

• Server-side OAuth not configured
• Solution: Contact business admin or support

3. Token Expired

• OAuth token expired and not refreshed
• Solution: Reconnect integration

4. Permissions Revoked

• User revoked permissions in Google
• Solution: Reconnect and grant permissions

5. Sync Disabled

• Sync was manually disabled
• Solution: Enable sync in configuration

6. Wrong Calendars Selected

• Calendars not selected for sync
• Solution: Select correct calendars

7. Network Issues

• Firewall blocking webhook requests
• Solution: Check network configuration

8. Google API Limits

• Hit Google API rate limits
• Solution: Wait and try again later

9. Browser Cache

• Old cached data causing issues
• Solution: Clear cache and refresh

10. Multiple Integrations

• Conflicting integrations
• Solution: Check for duplicate connections

Prevention Tips

How to Avoid Integration Issues

1. Keep Integration Connected

• Don't disconnect unless necessary
• Reconnect if connection is lost
• Check connection status regularly

2. Grant All Permissions

• Always grant all requested permissions
• Don't skip permission requests
• Review permissions periodically

3. Monitor Sync Status

• Check sync status regularly
• Monitor for sync errors
• Address issues promptly

4. Select Correct Calendars

• Only select calendars you need
• Verify calendar access
• Update selections as needed

5. Keep Calendar Module Enabled

• Don't disable Calendar module
• Check dependencies before disabling
• Re-enable if accidentally disabled

6. Regular Testing

• Test sync periodically
• Create test events to verify sync
• Check both directions of sync

7. Stay Updated

• Keep app updated
• Check for integration updates
• Review release notes

Still Not Working?

When to Contact Support

If you've tried all solutions and the integration still isn't working:

1. Gather Information Before contacting support:

• Integration status (Connected/Not Connected)
• Error messages (exact text)
• When the issue started
• Steps you've already tried
• Screenshots of errors

2. Contact Support

• Email: support@piraja.com (or your support email)
• In-App: Use the help icon (?) in the interface
• Knowledge Base: Search for related articles

3. What Support Will Need

• Your account email
• Business name
• Integration type (Google Calendar)
• Error messages
• Steps you've tried
• Screenshots (if possible)

Related Articles

• Email Logging: Emails Not Appearing
• Understanding the Module System

Additional Resources

• Calendar Module Guide: Complete guide to calendar features
• Integration Help: General integration troubleshooting
• Google Calendar API: Official Google Calendar API documentation