WordPress Integration

Add ASKGPT to Your
WordPress Site

Install the official ASKGPT WordPress plugin and have your AI chatbot live in under 5 minutes — no coding required.

WordPress 5.0+ · PHP 7.4+ · No coding required
Requirements

What You Need to Get Started

🌐
WordPress 5.0+
Classic or Block editor — both supported
⚙️
PHP 7.4 or Higher
Most modern WordPress hosts already meet this
🤖
ASKGPT Account
Free 7-day trial — no credit card required
ℹ️
Your Chatbot ID and API URL are found in your ASKGPT Dashboard under Settings → Widget Embed Code.
Installation Guide

Step-by-Step Setup

1
Download & Upload the Plugin
Get the ASKGPT plugin file and install it in WordPress

Download the ASKGPT WordPress plugin (askgpt-chat-widget.zip) and install it via your WordPress admin panel.

  • 1. Log into your WordPress admin: yourdomain.com/wp-admin
  • 2. Go to Plugins → Add New → Upload Plugin
  • 3. Click Choose File, select askgpt-chat-widget.zip
  • 4. Click Install Now, then Activate Plugin
✅
After activation, you'll see ASKGPT Widget appear under your WordPress Settings menu.
2
Configure Plugin Settings
Enter your Chatbot ID, API URL, and appearance options

Go to Settings → ASKGPT Widget in your WordPress admin. Fill in the required fields:

Chatbot ID (required)
your-chatbot-uuid-here
API / Webhook URL (required)
https://n8n.yourdomain.com/webhook/askgpt-chat
Chat Title
AI Assistant
Primary Color
#2563EB
Position
right
Icon Style
chat
Bottom Margin (px)
24
Side Margin (px)
24

Find your Chatbot ID and API URL in your ASKGPT dashboard:
Dashboard → Your Chatbot → Settings → Widget Embed Code

⚠️
Make sure your API URL (n8n webhook) is publicly accessible. The URL should start with https://.
3
Choose Where to Display the Widget
Show on all pages or target specific sections

The plugin lets you control exactly where the chat widget appears:

  • ▸ All Pages — chat appears on every page and post
  • ▸ Home Only — only on your homepage
  • ▸ Pages Only — on static pages (not blog posts)
  • ▸ Posts Only — on blog posts only
  • ▸ WooCommerce — on shop/product pages only

You can also exclude specific page IDs — enter comma-separated page IDs in the Exclude field:

# Example: exclude Contact page (ID 45) and About page (ID 12)
45, 12
💡
Find a page's ID by hovering over it in Pages → All Pages. The ID appears in the URL: ?post=45&action=edit
4
Save & Verify
Save settings and confirm the widget appears on your site

Click Save Settings in the plugin admin page. Then:

  • 1. Open your website in a new tab (or incognito window)
  • 2. Look for the chat button in the bottom corner (right or left, based on your setting)
  • 3. Click the button and send a test message
  • 4. Confirm the bot responds with your trained content
ℹ️
If the widget doesn't appear, try clearing your WordPress cache (W3 Total Cache, WP Super Cache, etc.) and your browser cache.
Reference

All Widget Attributes

If you prefer to embed the widget manually (without the plugin), add this script tag before your </body>:

HTML
<!-- Paste before </body> -->
<script
src="https://askgpt.asksol.pk/widget/widget.js"
data-client-id="YOUR_CHATBOT_ID"
data-api-url="https://n8n.asksol.pk/webhook/askgpt-chat"
data-title="AI Assistant"
data-color="#2563EB"
data-position="right"
data-icon="chat"
data-bottom="24"
data-side="24"
data-branding="true"></script>

Available Attributes

Attribute Required Default Description
data-client-idRequired—Your chatbot UUID from the ASKGPT dashboard
data-api-urlRequired—Your n8n webhook URL (chat pipeline endpoint)
data-titleOptionalAI AssistantName shown in the chat header
data-colorOptional#2563EBPrimary hex color for the widget theme
data-positionOptionalrightright or left — corner placement
data-iconOptionalchatIcon style: chat | robot | support | help | message | sparkle | headset
data-bottomOptional24Bottom offset in pixels (8–120)
data-sideOptional24Side (left/right) offset in pixels (4–120)
data-brandingOptionaltrueSet to false to remove "Powered by ASKGPT" footer
Troubleshooting

Common Issues

🙈
Widget doesn't appear on the site
  • ▸ Clear WordPress cache (W3 Total Cache, WP Super Cache, LiteSpeed, etc.)
  • ▸ Clear your browser cache (Ctrl+Shift+R or Cmd+Shift+R)
  • ▸ Confirm the plugin is Activated in Plugins → Installed Plugins
  • ▸ Check Visibility setting — ensure the current page type is included
  • ▸ Make sure the page ID isn't in the Exclude IDs list
💬
Widget opens but bot doesn't respond
  • ▸ Verify the API URL is correct and your n8n workflow is active
  • ▸ Open browser DevTools → Network tab and check for failed requests
  • ▸ Make sure CORS is enabled in n8n (Settings → Allowed Origins: *)
  • ▸ Confirm your Chatbot ID is the UUID from the ASKGPT dashboard (not the chatbot name)
  • ▸ Check if your n8n server is reachable from a browser: open the API URL directly
⚡
Widget loads slowly or conflicts with theme
  • ▸ Increase Load Delay in plugin settings (e.g., 3 seconds) to load after theme JS
  • ▸ The widget uses Shadow DOM — CSS conflicts are impossible by design
  • ▸ If another chat plugin is installed, disable it to avoid z-index conflicts
  • ▸ Use the Custom CSS field in plugin settings for position fine-tuning

Ready to Get Started?

Create your free ASKGPT account, train your bot, and have it live on WordPress in minutes.

Start Free Trial → ← Back to Integrations