EchoAI for WordPress

Installation

Get the plugin installed on your WordPress site.

From the Plugin Directory

Manual Upload

Download the zip file, go to Plugins > Add New > Upload Plugin, select the file and activate.

Requirements

Setup & Connection

Connect your WordPress site to EchoAI after activating the plugin. Go to EchoAI > Setup.

Option A: Connect with EchoAI (Recommended)

Option B: Use an Existing Assistant ID

Already have an assistant? Copy its ID from your EchoAI dashboard, paste it into the "Use Existing Assistant" field, and click "Validate & Save".

Floating Button

A chat button that appears on every page of your site. Active by default after setup.

To customize, go to EchoAI > Config. To disable, select "No floating button" in the position selector.

new EchoSDK({
  assistantIdentifier: 'your-assistant-id',
  floatingButton: {
    enabled: true,
    position: 'bottom_right',
    icon: 'https://your-site.com/icon.svg',
    tooltip: 'Get quick answers',
    width: 350,
    height: 500
  }
});

Gutenberg Block

Embed the chat directly into any page or post using the block editor.

Shortcode

Use [echo_ai] in any post, page, or widget area.

[echo_ai]

Examples

[echo_ai height="600" backgroundcolor="#ffffff"]

[echo_ai assistant_id="12345ABCDE" height="500"]

Configuration

All settings are at EchoAI > Config in your WordPress admin.

Assistant Settings

Floating Button Settings

Content Integration

Choose which post types are synced to your AI knowledge base. Only public post types with REST API support are shown. Default: Posts and Pages.

Content Sync

Your content is automatically synced to the AI knowledge base via webhooks whenever you publish, update, or delete a post.

How It Works

• Automatic — Every time you save a post, a webhook fires within seconds
• Smart filtering — Only enabled post types with REST API support are synced
• Draft-safe — Auto-drafts and revisions are ignored, only published content is sent

{
  "postId": "123",
  "action": "save",
  "postType": "posts",
  "websiteUrl": "https://your-site.com",
  "integration": "WordPress",
  "assistantId": "your-assistant-id"
}

What Gets Synced

• Post content — Title, body, author, date, permalink
• Featured image — Auto-detected from thumbnails, blocks, or content
• Taxonomies — Categories, tags, and custom taxonomies as flat labels

What's NOT Synced

• Draft or private content
• Password-protected posts
• User credentials or admin data

Troubleshooting

Common issues and how to fix them.

"EchoAI is not functional on localhost"

The AI needs to reach your site's REST API over the internet. Deploy to a publicly accessible server.

"Could not validate your Assistant ID"

• Check your internet connection
• Verify the assistant ID exists on app.echoaichat.com
• This is a warning only — your saved ID is preserved

Floating button not appearing

• Check EchoAI > Config — position must not be "No floating button"
• Verify an assistant is connected
• Check browser console for SDK errors

Content not syncing

• Check that the post type is enabled in EchoAI > Config > Content Integration
• The post type must have show_in_rest enabled
• Only published content triggers webhooks — drafts are ignored
• Bulk imports may need a manual sync from the EchoAI platform

Debug Mode

// Enable debug mode in wp-config.php
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);

// Then visit:
// admin.php?page=echoai_setup&debug=1

This logs API requests and responses to wp-content/debug.log and stores the last 10 errors in plugin options.