AI Web Agent – WordPress Plugin Installation Guide

A simple, step-by-step guide to adding AI chat + voice calls to your website.

Overview

The Call Agent AI Web Agent plugin adds a fully interactive AI chat & voice widget to your WordPress website. Once installed, your visitors can:

• Chat with your AI assistant in real time

• Start a natural, human-like voice call directly in the browser

• Receive instant answers, support, or booking assistance

• Convert into leads with automated follow-ups

This guide walks you through installation, configuration, and successful launch.

Requirements

Before installing the plugin, ensure you have:

Requirement	Details
WordPress	Version 5.0+
PHP	Version 7.4+
HTTPS / SSL	Required for microphone access & voice calls
Browsers	Chrome, Firefox, Safari, Edge (latest versions recommended)
Call Agent AI Account	Create one at https://admin.callagentai.com
Admin Access	Required for plugin upload & settings

---

1. Create Your Call Agent AI Account

1. Go to https://admin.callagentai.com

2. Click Sign Up

3. Complete the registration form

4. Confirm your email

5. Log into your dashboard

---

2. Set Up Your AI Assistant

1. Navigate to Assistants in the left sidebar

2. Click Create New Assistant

3. Fill in the required details:

   • Assistant Name

   • Greeting

   • Voice (optional if using chat-only)

   • Personality / Prompt

   • AI Model

4. Click Save

This assistant is what your website widget will use.

---

3. Get Your Plugin Credentials

To connect Wordpress → Call Agent AI, you need:

• API Token (User Token)

• Assistant ID

You’ll find these under your assistant’s Plugin Settings / Integration Settings.

Keep these values secure.

---

4. Install the Plugin on WordPress

1. Download the plugin ZIP file (ai-call-agent.zip).

2. Log into your WordPress admin:

   https://yourwebsite.com/wp-admin

3. Go to Plugins → Add New → Upload Plugin

4. Upload the ZIP file

5. Click Install Now

6. Click Activate

You will now see Call Agent AI Web Agent in your plugin list.

---

5. Configure the Plugin

Go to Settings → CallAgentAI or click Settings under the plugin name.

5.1 Enter Your Credentials

• API Token → paste from your CallAgentAI dashboard

• Assistant ID → paste from your dashboard

5.2 Choose Widget Behavior

You can customize:

Setting	Options
Widget Position	Bottom-right (recommended), bottom-left, top-right, top-left
Features	Chat only, Voice only, or Chat + Voice
Enable Widget	Turn the widget on / off

Click Save Settings.

---

6. Add Your Website URL (CORS Configuration)

This step is required for your website to securely communicate with Call Agent AI.

1. Go to admin.callagentai.com → Assistants

2. Select your assistant

3. Open Plugin Settings / CORS Settings

4. Add your domain:

   https://yourwebsite.com

   • Include HTTPS

   • No trailing slash

Click Save.

Without this step, your widget will not load.

---

7. Test Your Installation

7.1 Desktop Test

1. Visit your live website

2. Look for the floating widget

3. Test Chat

4. Test Voice Call (allow microphone access)

7.2 Mobile Test

Recommended for ensuring UI responsiveness.

---

Advanced Usage

Shortcodes

To place the widget only on specific pages:

Basic

[ai_call_agent_widget]

With custom options

[ai_call_agent_widget api_token="xxx" assistant_id="xxx" position="bottom-right"]

Theme Widgets

You may also add the widget via Appearance → Widgets.

Custom CSS

Developers/designers can override styling using Additional CSS.

---

Troubleshooting

Widget Not Appearing

• Ensure Enable Widget is checked

• Confirm API Token & Assistant ID

• Clear WordPress cache

• Add your domain in CORS settings

• Disable conflicting plugins temporarily

Microphone or Voice Issues

• HTTPS is required

• Ensure browser mic permission is allowed

• Test mic on your device settings

• Try another browser

Connection Errors

• Re-copy your API Token (no extra spaces)

• Check for active subscriptions

• Verify domain settings in CORS

---

FAQ

Do I need HTTPS?

Yes. Browsers block microphone access on non-secure sites.

Can I use the plugin on multiple domains?

Depends on your Call Agent AI plan.

Do I lose settings if I deactivate the plugin?

No — only deleting the plugin removes settings.

Can I customize my AI responses?

Yes. All tuning is done inside the CallAgentAI dashboard.

How do I update the plugin?

Upload a new ZIP → WordPress will replace the old version.

---

Support

If you need help:

Documentation https://callagentai.gitbook.io/docs/

Email [e-mail]

Dashboard https://admin.callagentai.com

---

Quick Setup Checklist

• Account created

• Assistant created

• API Token copied

• Assistant ID copied

• Plugin ZIP installed & activated

• Credentials added to WordPress

• Widget enabled

• Features selected

• CORS domain added

• Tested on desktop

• Tested on mobile

---

Done! 🎉

Your AI Web Agent is now live. Visitors can chat or talk to your assistant directly on your website — no phone lines, no friction, instant engagement.