> For the complete documentation index, see [llms.txt](https://callagentai.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://callagentai.gitbook.io/docs/account-setup/voice-and-chatbot-web-agent/wordpress.md).

# WordPress

### **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**](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**\
<accounts@callagentai.com>

**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.