WordPress Integration Guide
Add the KaiCalls chat widget to your WordPress site in minutes. Visitors can talk to your AI assistant directly from any page on your website.
Getting Started
KaiCalls provides an embeddable chat widget that lets website visitors interact with your AI assistant without leaving your site. The widget loads asynchronously so it will not slow down your pages.
Before you begin, make sure you have:
- A KaiCalls account with at least one agent configured
- Admin access to your WordPress dashboard
- Your KaiCalls widget embed code (found in your dashboard under Business Settings)
Installation
There are two ways to add the widget to WordPress. Choose whichever method works best for your setup.
Option 1: Using a Header/Footer Plugin (Recommended)
- Install and activate a plugin like Insert Headers and Footers (by WPCode) from the WordPress plugin directory
- Go to Settings → Insert Headers and Footers in your WordPress admin
- Paste your KaiCalls widget embed code into the Footer section
- Click Save
Option 2: Editing Your Theme Directly
- Go to Appearance → Theme Editor in your WordPress admin
- Open the footer.php file (or header.php depending on your theme)
- Paste the KaiCalls widget embed code just before the closing
</body>tag - Click Update File
Note: If your theme updates, manual edits to theme files may be overwritten. Using a child theme or a plugin (Option 1) avoids this problem.
Your Embed Code
Your embed code looks something like this:
<script src="https://yourdomain.com/widget.js" data-agent-id="your-agent-id" async></script>
Find your exact embed code in the KaiCalls dashboard under Business Settings → Widget.
Configuration
After installing the widget, you can customize its appearance and behavior from your KaiCalls dashboard. No additional WordPress changes are needed.
- Widget Position: Choose where the chat button appears on your site (bottom-right is the default)
- Brand Colors: Match the widget colors to your website theme
- Welcome Message: Set what visitors see when they first open the chat
- Agent Assignment: Choose which AI agent handles conversations from the widget
- Business Hours: Optionally show the widget only during certain hours
All configuration changes are saved in your KaiCalls dashboard and take effect immediately on your WordPress site without needing to update any code.
Testing Your Widget
After installation, verify everything is working correctly:
- Visit your WordPress site in a new browser tab (or incognito window)
- Look for the chat widget icon in the corner of the page
- Click the icon to open the chat window
- Send a test message and confirm you get a response from your AI agent
- Check your KaiCalls dashboard to verify the conversation appears in your call/chat history
If the widget does not appear or something is not working as expected, see the Troubleshooting Guide.
Next Steps
- Set up your AI agent to customize how it handles conversations from your website
- Read the FAQ for answers to common questions
- Troubleshooting if you run into any issues
- Need help? Contact us at support@kaicalls.com