Integration Connection Problems
Troubleshooting guide for WhatsApp, Messenger, Instagram, and Google Calendar integration issues.
General Integration Troubleshooting
Check Integration Status First
Before diving into specific issues:
Go to Settings → Integrations
Look at status indicator for each integration:
- 🟢 Green pulse (Connected) - Working normally
- 🟡 Yellow (Pending) - Setup incomplete
- 🔴 Red (Error) - Issue detected
- ⚪ Gray (Disconnected) - Not connected
Check "Last synced" or "Last active" timestamp
Recent activity = integration is working
Verify Subscription Tier
Integration availability by tier:
| Integration | Free | Solo | Growth | Business |
|---|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ | |
| Google Calendar | ❌ | ✅ | ✅ | ✅ |
| Messenger | ❌ | ❌ | ✅ | ✅ |
| ❌ | ❌ | ✅ | ✅ |
If integration shows "Upgrade Required":
- Go to Settings → Billing
- Upgrade to required tier
- Return to Integrations to connect
Clear Browser Cache
Sometimes OAuth tokens get stuck:
- Clear browser cache and cookies
- Log out of rendevo
- Close all browser tabs
- Reopen browser
- Log back into rendevo
- Try reconnecting integration
Check External Platform Status
Before troubleshooting further:
- Facebook/Meta platforms: status.facebook.com
- Google services: status.cloud.google.com
If platform is down:
- Wait for platform to recover
- Retry connection later
- No action needed on your end
WhatsApp Business Issues
"Integration Not Found" Error
Causes and solutions:
1. Phone Number Not Registered with WhatsApp Business
Symptoms:
- Error during connection
- "Phone number not found"
- Can't complete OAuth flow
Fix:
- Go to business.facebook.com
- Select your Business Manager
- Go to Business Settings → Accounts → WhatsApp Accounts
- Verify you have a WhatsApp Business Account (WABA)
- Check phone number is:
- Registered
- Verified
- Active
- Not banned or restricted
- If no WABA exists: create one through Facebook Business Manager
- Return to rendevo and reconnect
2. Access Token Expired
Symptoms:
- Was working, now shows disconnected
- Red error status
- Messages not sending/receiving
Fix:
- Go to Settings → Integrations
- Find WhatsApp card
- Click Reconnect or Disconnect then Connect
- Complete OAuth flow again
- Grant all permissions
- Status should change to Connected
3. Insufficient Permissions
Symptoms:
- Connection completes but doesn't work
- Some features work, others don't
Fix:
- Disconnect WhatsApp integration
- Reconnect
- On permission screen: Grant ALL permissions
- Don't skip or decline any permission requests
- Complete flow
Messages Not Appearing in Inbox
Problem: Customer sends WhatsApp message but doesn't show in rendevo Inbox.
Diagnostic steps:
1. Test Message Flow
- Send test message to your WhatsApp Business number from personal phone
- Wait 30-60 seconds (webhook processing time)
- Refresh Inbox page in rendevo
- Check "All" conversations filter
2. Check Integration Status
- Settings → Integrations
- WhatsApp status should be Connected (green)
- If error: reconnect
3. Check Inbox Filters
- Click "All" conversations
- Conversation may be in different filter
- Search by customer name or phone
4. Verify Phone Number Match
- The number customer messaged must match number connected in rendevo
- Check in business.facebook.com → WhatsApp Accounts
- Verify number matches
5. Check Facebook Business Manager
- Go to business.facebook.com
- Business Settings → WhatsApp Accounts
- Click your WABA
- Check "Webhooks" section
- Should show active webhook
- If missing: disconnect and reconnect in rendevo
If still not working:
- Disconnect WhatsApp
- Wait 5 minutes
- Reconnect
- Test again
Cannot Send Messages
Problem: Can't reply to customers on WhatsApp.
Common causes:
1. 24-Hour Window Expired
WhatsApp policy:
- You can only message customers within 24 hours of their last message to you
- OR customer must message you first
Symptoms:
- Reply button grayed out
- "24-hour window expired" message
- Send fails
Solution:
- Wait for customer to message again
- Then reply within 24 hours
- This is WhatsApp policy, not rendevo limitation
2. Access Token Invalid
Symptoms:
- All messages fail to send
- Error notification
Fix:
- Settings → Integrations → WhatsApp
- Click Reconnect
- Complete OAuth
- Try sending again
3. Phone Number Suspended
Symptoms:
- Can't send messages
- May receive error from Facebook
Fix:
- Check business.facebook.com
- Go to your WABA
- Check for quality rating or restrictions
- If restricted: follow Facebook's instructions to appeal
- Ensure compliance with WhatsApp Business Policy
4. Rate Limiting
Symptoms:
- Some messages send, others fail
- "Too many requests" error
Solution:
- WhatsApp limits message volume for new business accounts
- Limit increases over time with good quality rating
- Spread messages out over time
- Check business.facebook.com for your messaging tier
Google Calendar Issues
Events Not Creating in Google Calendar
Problem: rendevo appointments don't appear in Google Calendar.
Diagnostic steps:
1. Check Sync Status
- Settings → Integrations
- Find Google Calendar card
- Check "Last synced" timestamp
- Should update within 1-2 minutes of creating appointment
If not syncing:
- Click Disconnect
- Wait 30 seconds
- Click Connect
- Grant permissions
- Create test appointment
- Wait 1 minute
- Check Google Calendar
2. Verify Permissions
- Go to myaccount.google.com/permissions
- Find rendevo app
- Check permissions include:
- View events
- Create events
- Edit events
- Delete events
If permissions missing:
- Remove rendevo app from Google permissions
- Return to rendevo
- Disconnect Google Calendar
- Reconnect (will prompt for permissions again)
- Grant ALL permissions
3. Check Correct Calendar
- Events may be in different calendar
- Open calendar.google.com
- Left sidebar: check all calendars
- Look for "rendevo Bookings" or similar
- Check if events appear there
- If in wrong calendar: events are syncing correctly, just check that calendar
4. Check Calendar Selection
- Some Google accounts have multiple calendars
- rendevo syncs to your primary calendar by default
- Open Google Calendar
- Settings → Settings for my calendars
- Check which is set as primary
- Verify events appear there
"Sync Failed" Error
Problem: Integration shows sync error.
Solutions:
1. Token Expired (Most Common)
Fix:
- Settings → Integrations → Google Calendar
- Click Disconnect
- Wait 30 seconds (allows cleanup)
- Click Connect
- Complete Google OAuth
- Grant all permissions
- Test: Create appointment in rendevo
- Verify appears in Google Calendar within 1 minute
2. Calendar Permissions Changed
Fix:
- Go to myaccount.google.com/permissions
- Find rendevo
- Click to view permissions
- Ensure all calendar permissions granted
- If not: Remove app access
- Reconnect in rendevo
- Grant all permissions
3. Google Account Issues
Fix:
- Verify you can access calendar.google.com
- Try creating event manually in Google Calendar
- If Google Calendar itself not working: contact Google support
- Once Google Calendar works: reconnect in rendevo
Duplicate Events in Google Calendar
Problem: Each rendevo appointment creates multiple Google Calendar events.
Cause: Multiple sync triggers or reconnection without cleanup.
Solution:
Clean up manually:
- Open calendar.google.com
- Find and delete duplicate events
- Keep only one per appointment
Reset integration:
- Settings → Integrations → Google Calendar
- Click Disconnect
- Wait 5 minutes (important for cleanup)
- Clear browser cache
- Click Connect
- Complete OAuth
Test with new appointment:
- Create test appointment
- Wait 1 minute
- Check Google Calendar
- Should see single event
- If still duplicating: contact support
Calendar Events Not Updating
Problem: Change appointment in rendevo but Google Calendar event doesn't update.
Expected behavior:
- Two-way sync: rendevo → Google Calendar
- Changes in rendevo should reflect in Google Calendar
- Changes in Google Calendar do NOT sync back to rendevo (one-way)
If changes not syncing:
1. Wait for sync:
- Sync may take 1-2 minutes
- Refresh Google Calendar page
- Check again
2. Check sync status:
- Settings → Integrations
- "Last synced" should be recent
- If old timestamp: sync may be stuck
3. Force resync:
- Edit appointment in rendevo again
- Make small change (add note)
- Save
- Triggers new sync
- Check Google Calendar
4. Reconnect:
- If persistent: disconnect and reconnect
- May lose some event links
- Future updates will sync correctly
Facebook Messenger Issues
"Page Not Found" Error
Problem: Can't connect Messenger, "Page not found" during setup.
Causes and fixes:
1. Not Page Admin
Requirements:
- You must be an Admin of the Facebook Page
- Not Editor, Moderator, or other roles
- Must be Admin specifically
Check your role:
- Go to facebook.com
- Navigate to your Page
- Settings → Page roles
- Check your role
- If not Admin: ask Page owner to make you Admin
2. Page Not Published
Requirements:
- Page must be published (public)
- Not draft or unpublished
Check and fix:
- Go to your Page
- Settings → General
- Find "Page visibility"
- Should say "Page published"
- If unpublished: click Publish Page
- Wait 5 minutes
- Retry connection in rendevo
3. Wrong Facebook Account
Problem:
- Logged into Facebook with personal account
- Page is under business account
Fix:
- Log out of Facebook
- Log into Facebook with account that owns the Page
- Return to rendevo
- Try connecting Messenger again
- Select correct Page from list
Messages Not Received in Inbox
Problem: Customer sends message on Facebook but doesn't appear in rendevo.
Diagnostic steps:
1. Test Message Flow
- From personal Facebook account: send message to your Page
- Wait 30 seconds
- Refresh rendevo Inbox
- Check "All" conversations
2. Verify Correct Page Connected
- Settings → Integrations → Messenger
- Check which Page is connected
- Ensure it's the correct Page
- If wrong: Disconnect and connect correct Page
3. Check Webhook Subscription
- Go to developers.facebook.com
- Select your app (if you have one, otherwise rendevo manages this)
- Webhooks section
- Should show subscription to messages
- If missing: disconnect and reconnect in rendevo
4. Check Page Permissions
- Settings → Integrations → Messenger
- Disconnect
- Reconnect
- Ensure you grant ALL permissions during OAuth
- Don't skip permission screens
5. Check Message Filtering
- In Facebook Page: Settings → Messaging
- Check if spam filtering is too aggressive
- May be filtering messages before rendevo receives them
Instagram Direct Issues
"Instagram Account Not Found"
Problem: Can't connect Instagram, account not found.
Requirements for Instagram integration:
Must be Professional Account
- Business or Creator account
- Not personal account
Must be linked to Facebook Page
- Instagram connected to a Facebook Page
- Can't be standalone
Converting to Professional Account:
- Open Instagram app on phone
- Go to your profile
- Tap menu (☰) → Settings
- Tap Account
- Tap "Switch to Professional Account"
- Choose Business or Creator
- Complete setup
- Wait 5 minutes for changes to propagate
Linking to Facebook Page:
- Instagram app → Profile
- Menu (☰) → Settings
- Account → Linked Accounts
- Tap Facebook
- Log in to Facebook
- Select Facebook Page to link
- Confirm connection
- Wait 5 minutes
- Retry connection in rendevo
Messages Delayed
Problem: Instagram messages take several minutes to appear in rendevo.
This is normal behavior:
Instagram webhook delivery:
- Often 1-2 minutes delayed
- Sometimes up to 5 minutes
- This is a Meta API limitation
- Not rendevo issue
What to do:
- Be patient
- Refresh Inbox periodically
- Messages will appear eventually
- Respond when you see them
If delay is over 10 minutes:
- Check integration status
- Reconnect if showing error
- Test with new message
Can't Reply to Instagram Messages
Problem: Reply button doesn't work or replies fail.
Common causes:
1. 24-Hour Window (Like WhatsApp)
- Can only reply within 24 hours of customer's last message
- OR customer must message first
- Instagram policy, not rendevo
2. Message Type Unsupported
- Instagram Stories mentions: not supported
- Instagram comments: not supported
- Only Direct Messages work
3. Account Restrictions
- Instagram account may be restricted
- Check instagram.com for warnings
- Follow Instagram Community Guidelines
4. Not Connected to Page
- If Instagram unlinked from Facebook Page: connection breaks
- Go to Instagram → Settings → Linked Accounts
- Verify Facebook connection
- Reconnect if needed
- Then reconnect in rendevo
General OAuth Connection Issues
"Authorization Failed" Error
Problem: OAuth flow fails during integration setup.
Solutions:
1. Clear All Sessions
- Log out of rendevo
- Log out of Facebook/Meta/Google
- Clear browser cache and cookies
- Close browser
- Reopen browser
- Log into rendevo
- Start OAuth flow fresh
2. Grant All Permissions
- During OAuth: don't skip permission screens
- Grant every requested permission
- Declining permissions causes connection to fail
- If unsure: grant all, can revoke later if needed
3. Use Supported Browser
- Recommended: Chrome, Firefox, Safari, Edge (latest versions)
- Update browser to latest version
- Disable browser extensions (especially privacy/ad blockers)
- Try incognito/private mode
4. Check Pop-up Blockers
- OAuth opens in pop-up window
- Pop-up blockers prevent this
- Allow pop-ups for rendevo domain
- Retry connection
5. Network/Firewall Issues
- Corporate networks may block OAuth
- VPNs may interfere
- Try from different network
- Or disable VPN temporarily
"Redirect URI Mismatch" Error
Problem: OAuth returns redirect URI error.
This is typically a configuration issue.
User fix:
- Clear browser cache
- Try different browser
- Ensure using rendevo's official domain
If persistent:
- This may be a platform issue
- Contact rendevo support
- Provide exact error message
When to Contact Support
Contact support if:
- Issue persists after trying all troubleshooting steps
- Integration shows "Connected" but definitively not working
- Receiving error messages not covered here
- Need help with complex multi-platform setup
- Integration was working, suddenly stopped, reconnection doesn't fix
Before contacting support, gather:
- Screenshots of error messages
- Integration status from Settings → Integrations
- Steps you've already tried
- Approximate time when issue started
- Which platform(s) affected
- Browser and operating system
How to contact:
- Click Get Help in rendevo sidebar
- Select "Integration Issue" category
- Provide details above
- Submit request
- Support responds within 24-48 hours
Preventive Maintenance
Regular Checks
Weekly:
- Check all integrations show "Connected" status
- Send test message on each platform
- Verify message appears in Inbox
Monthly:
- Test full message flow on all platforms
- Create test booking via AI (if applicable)
- Verify Google Calendar sync working
- Check "Last synced" timestamps
Quarterly:
- Review permissions in Facebook Business Manager
- Review permissions in Google Account settings
- Update any expired permissions
- Reconnect if showing any warnings
Best Practices
Don't revoke permissions externally
- If revoking: disconnect in rendevo first
- Then revoke in platform
- Otherwise integration breaks
Keep business accounts in good standing
- Follow platform policies
- Maintain quality ratings (WhatsApp)
- Respond to messages promptly
- Don't spam customers
Monitor for platform policy changes
- Facebook/Meta policies evolve
- Subscribe to platform updates
- Adjust usage accordingly
Update business info consistently
- Phone numbers should match everywhere
- Business names should match
- Addresses should match
- Prevents confusion and connection issues
Enable email notifications
- Settings → Notifications
- Turn on integration error alerts
- Get notified when integration breaks
- Fix proactively
Related Articles
- Which Integrations Available - Integration overview
- Connecting WhatsApp Business - Setup guide
- Google Calendar Setup - Calendar integration
- Messenger & Instagram Setup - Meta platforms
- AI Agent Not Responding - AI issues
Most integration issues are resolved by disconnecting, clearing cache, and reconnecting with full permissions! 🔌