Troubleshooting
1. Error/Symptom:Deluge Editor not visible in the Writer document
Possible Cause: You are not using a supported template (Merge, Fillable, or Sign).
Recommended Solution: Ensure you’re working within one of the supported automation templates in Zoho Writer.
2. Error/Symptom:OAuth2 connection setup fails or throws an error
Possible Cause: Incorrect Client ID, Client Secret, or missing/invalid callback URL.
Recommended Solution: Double-check your authentication credentials and ensure the callback URL is registered correctly in the third-party service’s developer console.
3. Error/Symptom:Scopes-related authentication failure
Possible Cause: Required scopes are missing or incorrectly formatted.
Recommended Solution: Refer to the third-party API documentation for the exact scopes and use the correct delimiter (comma, space, or plus).
4. Error/Symptom:“Link name already exists” error during connection creation
Possible Cause: The provided Connection Link Name is not unique.
Recommended Solution: Use a new, unique link name that follows the naming rules (lowercase, alphanumeric, underscores, max 50 characters).
5. Error/Symptom:Connection appears under “My Connections” but data fetch fails in function
Possible Cause: The connection was not authorized properly, or the scope is insufficient.
Recommended Solution: Recreate the connection ensuring proper scope and successful authorization.
FAQs
Q1: Can I use the same connection in multiple custom functions?
Yes, once a connection is created, it can be reused across documents and functions.
Q2: What happens if I forget the scope?
If scope is required and not provided, authentication will fail. Always refer to the service’s API documentation.
Q3: What delimiter should I use for scopes?
By default, a comma (,) is used. If the API expects another format (space or plus), specify it in the Scope Delimiter field.
Q4: Can I edit a connection after it's created?
You cannot modify an existing connection. To change any parameter, you must create a new connection.