From abd335fbfea82f1389cee347dfc4df812011e50b Mon Sep 17 00:00:00 2001 From: Mehayla <68716877+Mehayla@users.noreply.github.com> Date: Mon, 31 Aug 2026 07:11:52 -0500 Subject: [PATCH 1/2] docs(tools): add OAuth Connect popup troubleshooting to Google Calendar integration --- fern/tools/google-calendar.mdx | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/fern/tools/google-calendar.mdx b/fern/tools/google-calendar.mdx index fba2cb110..320ff6fc0 100644 --- a/fern/tools/google-calendar.mdx +++ b/fern/tools/google-calendar.mdx @@ -80,6 +80,35 @@ Now, add your chosen calendar tool(s) to your assistant: /> +## Troubleshooting + +### Connect button doesn't open the Google authorization popup + +Some users report that clicking **Connect** on the Google Calendar integration closes the dialog or returns them to the Integrations page without ever showing the Google OAuth window. If you later create a calendar tool anyway, it may fail with an error like `Missing Nango configuration for tool type: google.calendar.availability.check`. + +This is most often caused by the browser blocking a script required to open the Google authorization popup, rather than a Vapi account issue. Work through this checklist in order: + +1. **Check the browser console** (F12 or right-click → Inspect → Console) for a Content Security Policy (CSP) error mentioning `nango.dev` (for example, `connect.nango.dev` or `api.nango.dev`). This confirms the popup script was blocked rather than silently failing. +2. **Allow pop-ups** for `dashboard.vapi.ai` in your browser settings. +3. **Disable ad blockers and privacy/script-blocking extensions** for `dashboard.vapi.ai`, then reload the page and try Connect again. +4. **Allow third-party cookies** for `dashboard.vapi.ai`, since the OAuth flow depends on them. +5. **Try an Incognito/private window or a different browser** to rule out a cached extension or profile setting. +6. **On a managed or corporate network**, ask your network/IT team to allow `*.nango.dev`, since some corporate proxies and firewalls block it by default. + + + If you already have a working Connect flow for one browser or account and a *new* one fails the same way, the checklist above still applies — mismatched extension or network settings are the most common cause of this symptom across otherwise-identical setups. + + +If the checklist doesn't resolve it, contact [support@vapi.ai](mailto:support@vapi.ai) or ask in the [Discord `#support` channel](https://discord.gg/pUFNcf2WmH) with: +- Your browser and OS +- The exact console error text, if any +- Whether the issue reproduces in Incognito/private mode +- Whether this is a first-time connection or a previously-connected account that stopped working + + + If you need calendar access tied to a specific end user or token rather than a single linked Google account for the whole assistant, or if Connect is blocked entirely on your network, you can bypass the built-in integration with a [Custom Tool](/tools/custom-tools) that calls the Google Calendar API directly using an OAuth token you manage. + + ## Tool Configurations ### Google Calendar Create Event Tool From 666a2e72bd34dc6782286cfc55898aec567deef6 Mon Sep 17 00:00:00 2001 From: Mehayla <68716877+Mehayla@users.noreply.github.com> Date: Mon, 31 Aug 2026 07:12:21 -0500 Subject: [PATCH 2/2] docs(tools): add OAuth Connect popup troubleshooting to Google Sheets integration --- fern/tools/google-sheets.mdx | 27 ++++++++++++++++++++++++++- 1 file changed, 26 insertions(+), 1 deletion(-) diff --git a/fern/tools/google-sheets.mdx b/fern/tools/google-sheets.mdx index b9c1ad5c9..8ab4fe62d 100644 --- a/fern/tools/google-sheets.mdx +++ b/fern/tools/google-sheets.mdx @@ -71,6 +71,31 @@ Now, add the Google Sheets tool to your assistant: 4. In the tools dropdown, select the Google Sheets tool 5. Click **Publish** to save your changes +## Troubleshooting + +### Connect button doesn't open the Google authorization popup + +Some users report that clicking **Connect** on the Google Sheets integration closes the dialog or returns them to the Integrations page without ever showing the Google OAuth window, with no visible error. + +This is most often caused by the browser blocking a script required to open the Google authorization popup, rather than a Vapi account issue. Work through this checklist in order: + +1. **Check the browser console** (F12 or right-click → Inspect → Console) for a Content Security Policy (CSP) error mentioning `nango.dev` (for example, `connect.nango.dev` or `api.nango.dev`). This confirms the popup script was blocked rather than silently failing. +2. **Allow pop-ups** for `dashboard.vapi.ai` in your browser settings. +3. **Disable ad blockers and privacy/script-blocking extensions** for `dashboard.vapi.ai`, then reload the page and try Connect again. +4. **Allow third-party cookies** for `dashboard.vapi.ai`, since the OAuth flow depends on them. +5. **Try an Incognito/private window or a different browser** to rule out a cached extension or profile setting. +6. **On a managed or corporate network**, ask your network/IT team to allow `*.nango.dev`, since some corporate proxies and firewalls block it by default. + + + If you already have a working Connect flow for one browser or account and a *new* one fails the same way, the checklist above still applies — mismatched extension or network settings are the most common cause of this symptom across otherwise-identical setups. + + +If the checklist doesn't resolve it, contact [support@vapi.ai](mailto:support@vapi.ai) or ask in the [Discord `#support` channel](https://discord.gg/pUFNcf2WmH) with: +- Your browser and OS +- The exact console error text, if any +- Whether the issue reproduces in Incognito/private mode +- Whether this is a first-time connection or a previously-connected account that stopped working + ## Tool Configuration ### Google Sheets Add Row Tool @@ -135,4 +160,4 @@ Here's how the tool can be used in your assistant's configuration: > View the complete API documentation for tools - +