WebChatAgent Logo

WordPress Plugin

The easiest way to put your chatbot on a WordPress site. You install a free plugin, paste your Chatbot ID, and turn it on. The plugin handles the embed for you, so there's no theme code to edit and no script to copy. Everything else — design, AI behavior, live chat, WhatsApp — stays in your WebChatAgent dashboard.

Step 1: Install the plugin

  1. In your WordPress admin, go to Plugins → Add New.
  2. Search for WebChatAgent.
  3. Click Install Now, then Activate.

You can also install it directly from the WordPress Plugin Directory. The plugin is free, and updates arrive through the normal WordPress update system.

Step 2: Get your Chatbot ID

  1. Log in to your WebChatAgent dashboard and open your chatbot.
  2. Go to the Widget Integration tab.
  3. Copy your Chatbot ID. (It's the long string shown there, and the same ID that appears in your dashboard URL.)

Step 3: Connect and enable

  1. In WordPress, open WebChatAgent in the left admin menu. It's a top-level menu item with a chat icon — not under Settings.
  2. Paste your Chatbot ID into the field.
  3. Turn on the Enable toggle.
  4. Click Save.

The chat widget now appears automatically on every page of your site. Visit your homepage in a new tab to see the floating chat button.

What the plugin does (and doesn't)

The WordPress plugin only needs two things from you: the Chatbot ID and the Enable toggle. Everything else — colors, avatar, welcome message, persona, position, behavior — is read live from your WebChatAgent dashboard. The plugin's admin page shows a live preview of your current widget so you can confirm the connection without leaving WordPress.

For the floating widget there's no shortcode to place — once enabled, it loads site-wide in the page footer. If you want the chat inside a specific page instead, use the inline shortcode or block below.

Embed the chat inside a page (shortcode & block)

Since plugin version 1.1.0 you can place the chat directly inside your content — on a product page, a contact page, or a news article — instead of (or in addition to) the floating button.

Shortcode (Classic Editor, page builders, text widgets):

[webchatagent_inline]

Gutenberg block: In the block editor, add the WebChatAgent Inline Chat block (search for "WebChatAgent" or "chat").

Both use the Chatbot ID from the plugin settings. To use a different chatbot on a single page, pass an override:

[webchatagent_inline chatbot-id="YOUR_OTHER_ID"]

For the block, set the Chatbot ID in the block's sidebar settings.

A few things worth knowing:

  • The inline embed works even when the Enable toggle is off — that toggle only controls the floating widget.
  • The inline widget script loads only on pages that contain the shortcode or block.
  • Height, theme, welcome message and all other inline-widget options come from your dashboard — see the Inline Widget guide.

Features

  • No code editing — Connect with a Chatbot ID; the plugin injects the widget for you.
  • Automatic updates — Delivered through the standard WordPress update system.
  • Live preview in admin — See your current widget design right in the WebChatAgent settings screen.
  • Site-wide by default — The floating widget loads on every page once enabled.
  • Inline embed — Place the chat inside any page or post via the [webchatagent_inline] shortcode or the WebChatAgent Inline Chat block.
  • GDPR-conscious — IP addresses are stored anonymized; old conversations are cleaned up after a retention period you control in the dashboard.

Troubleshooting

  • Widget not showing? Confirm the Enable toggle is on and the Chatbot ID is filled in. Then clear any caching plugin (WP Rocket, W3 Total Cache, LiteSpeed, etc.) and reload in a private window.
  • Still nothing? Some optimization plugins defer or strip third-party scripts. Add web-chat-agent.js (and chat-widget-inline.js if you use the inline embed) to your plugin's script exclusion list.
  • Conflicts with another chat plugin? Deactivate other chat or popup plugins temporarily to rule out a clash.