docs(tools): add OAuth Connect popup troubleshooting to Google Calendar/Sheets - #1177
docs(tools): add OAuth Connect popup troubleshooting to Google Calendar/Sheets#1177Mehayla wants to merge 2 commits into
Conversation
Why this changeGap type: Incomplete content — both pages document the happy-path Connect flow but have zero troubleshooting content for a failure mode that is currently the single largest recurring support driver in the help-center feedback review. Evidence (rolling customer-feedback review via Enterpret, support tickets + Ask AI chat + Discord):
Why docs now, regardless of the underlying fix: whether or not the root cause is a Vapi-side CSP/Nango bug, a documented checklist lets customers self-serve the common causes (extensions, third-party cookies, corporate network policy) and gives support a consistent diagnostic ask (console error text + browser/OS + Incognito repro) instead of every ticket starting from zero. It should reduce ticket volume and time-to-resolution immediately, independent of any product-side fix timeline. Ranking: This topic had the highest current-week volume among substantive (non-generic) topics and was persistent across the trailing 4 weeks, so it was picked over other recurring-but-declining topics (e.g. phone number setup, outbound calling API errors, SIP trunk transfer errors) per the top-gap selection method. |
What changed
Added a Troubleshooting section to two existing integration pages:
fern/tools/google-calendar.mdxfern/tools/google-sheets.mdxEach new section covers: "Connect button doesn't open the Google authorization popup", with a numbered checklist (check browser console for a Nango-related CSP error, allow pop-ups, disable ad blockers/privacy extensions, allow third-party cookies, try Incognito/another browser, allow
*.nango.devon managed networks), plus what to include when contacting support if it's still unresolved. The Google Calendar page also gets a short note on using a Custom Tool with a manually-supplied OAuth token as an alternative when the built-in Connect flow isn't viable.No other content on either page was modified.