Skip to content

Troubleshooting

Resolve common installation, knowledge, form, notification, and account problems.

Last reviewed
On this page

The launcher does not appear

Check that the script is present once and its workspace identifier is correct. In Installation, authorize the exact origin, including www, scheme, and port. Check the current page against the display rules. With no authorized website, no external page can show the chatbot.

Reload after saving. Check the browser's network and console for blocked script, configuration, or iframe requests. Ask the website maintainer to inspect Content Security Policy and privacy-extension effects. See Install on your website.

The assistant cannot answer a published fact

Check that the relevant URL lies within a configured source scope, is selected, and is Searchable. A published website change is not immediately indexed. Run Crawl now and inspect the resulting page status. Rediscover pages alone does not update an active source's answer content.

Check that the fact is readable text and that its qualifications are nearby. Image-only material, blocked pages, and unsupported documents may be unavailable. See Knowledge sources and Knowledge updates.

A source is blocked or its page list is incomplete

For robots denial, the site owner must allow CloudflareBrowserRenderingCrawler. Check for login screens, bot challenges, failed downloads, extraction limits, or the supported discovery URL ceiling.

Confirm Visible and Available for these languages. Availability considers observed visitor languages, interface language, and explicitly requested form language. Check Recommended for separately. An incorrect classification does not by itself make an otherwise available form inaccessible. See Forms.

An in-chat submission failed

Review field validation, the destination endpoint, exact field names and choice values, the connection, and reCAPTCHA setup. Check the receiving form's own required values and security response with its maintainer. A public form page URL is not the submission endpoint.

For an interrupted or uncertain request, inspect the current result and destination before confirming again. A missing notification is not proof that submission failed. See Connect Contact Form 7.

A translation changed a name or identifier

Check the original message or saved answer. In form configuration, use Plain text for exact names and identifiers. Free text can be translated when submission translation is enabled. Check configured public organization names and review all supported versions after settings changes. See Languages.

A notification email did not arrive

Check the conversation's classification, shared recipient or personal subscription, inactivity delay, and actual trigger. Clicking New chat without sending a message does not send an email. Check spam folders and recipient service behavior. See Notifications.

A conversation or draft did not return

Check that the visitor is using the same browser and storage context. Clearing storage, private browsing, another device, or browser restrictions can break restoration. Form-field edits and message drafts have different persistence behavior. See The visitor experience.

Check the workspace address and intended account. Password-reset and email-confirmation links expire after 30 minutes; request a fresh link when needed. A new reset replaces the previous reset link. Accounts in different workspaces are independent. See Team and account access.

Information to give your support contact

Describe the page or feature, approximate time, language, visible status, and steps that led to the problem. Share private transcripts, personal details, and configuration only through a channel your organization authorizes. Never include passwords or secret keys.