Skip to main content
The WordPress integration allows you to publish content directly from ChatFeatured, track AI crawler activity on your WordPress site, and automatically submit new URLs to search engines.

​
Features

Content Publishing

Publish content created in ChatFeatured directly to WordPress with full control over post status, categories, and featured images.

Agent Analytics

Track which AI bots (GPTBot, ClaudeBot, etc.) are crawling your site and which pages they’re accessing.

Index Submissions

Automatically submit new and updated URLs to search engines for faster discovery.

​
Setup Requirements

  • WordPress 5.0 or higher
  • Administrator access to your WordPress site
  • PHP 7.4 or higher

​
Installation

​
Step 1: Download the Plugin

  1. Log in to ChatFeatured
  2. Go to Integrations → WordPress
  3. Click Download Plugin to get chatfeatured-wordpress.zip

​
Step 2: Install on WordPress

  1. Log in to your WordPress admin dashboard at yourdomain.com/wp-admin
  2. Go to Plugins → Add New → Upload Plugin
  3. Click “Choose File” and select the downloaded zip file
  4. Click Install Now, then Activate

​
Step 3: Generate API Token

  1. In WordPress admin, go to ChatFeatured → Publishing
  2. Click Generate New Token
  3. Copy the generated token (it starts with cf_)
Keep this token secure—it grants publish access to your WordPress site. You can regenerate it at any time if compromised.

​
Step 4: Connect in ChatFeatured

  1. In ChatFeatured, go to Integrations → WordPress
  2. Enter your WordPress site URL (e.g., https://yourblog.com)
  3. Paste the API token you copied from WordPress
  4. Click Connect WordPress
Once connected, you’ll see a “Connected” status and can enable the features you want to use.

​
Enabling Features

After connecting WordPress, you’ll see toggles for each feature on the WordPress integration page. Enable the features you want to use:

​
Agent Analytics

Track which AI bots are crawling your WordPress site:
  • GPTBot (OpenAI/ChatGPT)
  • ClaudeBot (Anthropic)
  • Google-Extended (Google AI)
  • PerplexityBot (Perplexity)
  • Googlebot and other crawlers
How it works:
  1. Enable the Agent Analytics toggle
  2. The plugin automatically captures HTTP request logs from your site
  3. AI crawler visits flow to ChatFeatured for analysis
  4. View analytics in your Agent Analytics dashboard
The plugin is designed for minimal performance impact with queue-based batch sending and automatic filtering of admin pages and static assets.

​
Content Publishing

Publish content directly from ChatFeatured to WordPress:
  1. Enable the Publishing toggle
  2. Create content (manually or with the Content Agent)
  3. Click Publish to WordPress
  4. Configure post settings:
    • Status: Draft, Publish, or Scheduled
    • Categories: Select or create categories
    • Tags: Add relevant tags
    • Author: Map to a WordPress user
    • Featured Image: Upload or provide URL
  5. Click Publish
StatusDescription
DraftSaved but not visible to visitors
PublishLive on your site immediately
ScheduledWill publish at a specified date/time

​
Index Submissions

Automatically submit new and updated URLs to search engines for faster indexing:
  1. Enable the Index Submissions toggle
  2. The plugin automatically submits URLs when you publish or update posts
  3. View submission history in your Index Submissions dashboard
Index Submissions requires verification. After enabling, you may see a “Pending Verification” status while the key is verified with your site.

​
Troubleshooting

​
Connection Issues

“Could not connect to WordPress”
  1. Verify the WordPress URL is correct (include https://)
  2. Check that the ChatFeatured plugin is activated in WordPress
  3. Ensure the API token is correct (should start with cf_)
  4. Verify your site is publicly accessible
“Authentication failed”
  1. Go to ChatFeatured → Publishing in WordPress
  2. Generate a new API token
  3. Update the token in ChatFeatured and reconnect

​
Publishing Issues

“Failed to create post”
  1. Check that the WordPress user has publish permissions
  2. Verify the Publishing feature is enabled (toggle on)
  3. Check WordPress error logs for details
“Featured image not appearing”
  1. Ensure the image URL is publicly accessible
  2. Check that the image format is supported (JPG, PNG, GIF, WebP)
  3. Verify WordPress has write permissions to the uploads directory

​
Analytics Issues

“No crawler data appearing”
  1. Verify the Agent Analytics toggle is enabled
  2. Allow 24-48 hours for data to accumulate
  3. Crawler visits depend on your site’s visibility to AI bots
  4. Check that your site isn’t blocking bot traffic

​
Index Submissions Issues

“Pending verification” status
  1. The key file needs to be accessible at your site root
  2. The plugin should create this automatically—check if it exists
  3. Try disabling and re-enabling Index Submissions

​
WP-CLI Commands

For advanced users, the plugin includes WP-CLI commands: 
# Show plugin status
wp chatfeatured status

# Process the analytics queue manually
wp chatfeatured process-queue

# Send a test event
wp chatfeatured test-event

# Generate a new publishing token
wp chatfeatured generate-token

# Clear the analytics queue
wp chatfeatured clear-queue --yes

​
Best Practices

​
Content Publishing

  • Test with draft posts first before publishing live
  • Set up appropriate author mappings
  • Use categories and tags consistently
  • Review posts in WordPress after publishing

​
Agent Analytics

  • Enable analytics before making major content changes
  • Use data to understand which content AI models access
  • Correlate crawler activity with visibility improvements

​
Index Submissions

  • Enable for all sites where you want faster search engine indexing
  • Works automatically when you publish or update posts
  • Monitor the Index Submissions dashboard to verify URLs are being submitted

​
Security Considerations

​
API Token Security

  • Treat your API token like a password (it starts with cf_)
  • Regenerate tokens if compromised
  • The token grants publish access to your WordPress site

​
Plugin Permissions

The plugin requires:
  • Read/write access to posts
  • Access to categories and tags
  • Media upload permissions
  • Ability to log HTTP requests (for Agent Analytics)
These are standard WordPress capabilities for content management.