Zendesk Help Center

The CrawlDesk Ask AI widget enhances your Zendesk Help Center by adding an interactive AI-powered assistant that allows users to ask natural language questions directly within your help center. The widget is integrated via a lightweight script embed, hosted at Crawldesk CDN.

This guide details how to deploy the Ask AI widget in a Zendesk Help Center using the script embed method, including configuring a CrawlDesk project and embedding the widget script.

Prerequisites:

Active CrawlDesk account
Zendesk Help Center set up with access to the Guide Admin panel.
CrawlDesk widget API key (obtained from the CrawlDesk dashboard).

Follow these steps to deploy the CrawlDesk Ask AI widget in your Zendesk Help Center using the script embed method.

Access Zendesk Guide Theme Editor
From your Zendesk dashboard, navigate to Guide Admin.
Click on the Customize design tab.
Choose the theme you're using (or want to modify) and click Edit Code.
Add the Widget Script
In the theme code editor, find the file named document_head.hbs.
Paste the following script tag at the bottom of this file:
```
<script
  src="https://cdn.crawldesk.com/widget.iife.js"
  onload="initAIWidget({
    key: 'YOUR_CRAWLDESK_WIDGET_KEY'
  })"
></script>
```
Replace YOUR_CRAWLDESK_WIDGET_KEY with your actual CrawlDesk API key (e.g., wk_live_*******).
Save & Preview
Click Save.
Preview your help center to ensure the widget loads properly.
Publish Changes
Once you're satisfied with the preview, click Publish to make your changes live.
Customize the Widget
Visit your CrawlDesk dashboard to tailor the widget to your brand. You can adjust settings such as colors, logos, and other styling options to create a seamless, branded experience for your users.

Caution
Always back up your theme before making changes. This ensures you can revert to a previous version if needed. Follow Zendesk’s security best practices for custom scripts to keep your widget key secure and avoid exposing sensitive information.

info

After adding the script, ensure the changes are published to make the widget live. Test the widget in your help center to confirm it functions as expected.

Deploying the Ask AI Widget​

Deploying the Ask AI Widget