Docs
Docs / WordPress Integration

WordPress Integration

The Sidekick Forge Connect plugin bridges your WordPress user sessions with Sidekick Forge, enabling automatic authentication and content sync for your knowledge base.

On this page

Installing the Plugin Configuration How Authentication Works Knowledge Base Sync Developer Mode Troubleshooting

Installing the Plugin

1

Download

Download the latest version of Sidekick Forge Connect from your admin panel or ask your account manager for the plugin zip file.

2

Install via WordPress Admin

Go to Plugins → Add New → Upload Plugin in your WordPress admin. Select the zip file and click Install Now.

WordPress Admin — Plugin Upload
MyWebsite
Dashboard
Posts
Pages
Plugins
Installed
Add New
Settings
Sidekick Forge
Upload Plugin
Choose File
sidekick-forge-connect-v0.7.3.zip
Install Now
3

Activate

Click Activate Plugin. You'll see a new Sidekick Forge menu item in the WordPress sidebar.

Configuration

Navigate to Sidekick Forge in the WordPress admin sidebar to access the settings page.

Sidekick Forge — Settings Page
Sidekick Forge Connect v0.7.3
API Endpoint *
https://sidekickforge.com/api/v1/wordpress/bridge-session
Shared Secret *
••••••••••••••••••••
Allowed Origins *
https://sidekickforge.com
Optional
Invitation Message
Connect your account to access your personalized AI assistant.
Enable Terms & Conditions
Developer Mode
Save Settings

Required Settings

Setting Description
API Endpoint The Sidekick Forge backend URL for session exchange. This is provided in your WordPress Sites settings in the Sidekick Forge admin.
Shared Secret HMAC secret used to sign payloads. Must match the secret configured in Sidekick Forge for your WordPress site.
Allowed Origins Comma-separated list of Sidekick Forge embed origins (e.g., https://sidekickforge.com). Only embeds from these origins can request tokens.

Optional Settings

How Authentication Works

The bridge automatically authenticates logged-in WordPress users with your Sidekick Forge embed. Here's the flow:

User visits page with embed
WordPress detects the user is logged in and loads the bridge JS
Embed requests token via postMessage
The iframe sends SKF_REQUEST_TOKEN to the parent window
Bridge calls WordPress REST API
Builds HMAC-signed payload with user info, sends to Sidekick Forge backend
Session established
Supabase tokens returned to embed, user sees the chat interface automatically
First-time users see a "Connect Account" modal before authentication proceeds. Once accepted, the bridge remembers the choice per WordPress user and authenticates silently on subsequent visits.

For logged-out visitors, the bridge script is not loaded at all — they see the standard Sidekick Forge login screen in the embed.

Knowledge Base Sync

The plugin includes a built-in knowledge base sync tool that imports your WordPress content (posts and pages) into your sidekick's knowledge base.

Sidekick Forge — Knowledge Base Sync
WordPress Content
Select All Sync Selected (3)
Getting Started Guide
Page • Published Jan 15, 2025
Synced
Frequently Asked Questions
Page • Published Feb 3, 2025
Synced
Product Pricing & Plans
Post • Published Feb 10, 2025
Pending
About Our Team
Page • Published Dec 20, 2024
Not synced

How to Sync

  1. Navigate to Sidekick Forge → Knowledge Base in WordPress admin
  2. Click Load Content to see your published posts and pages
  3. Select the items you want to sync (or click Select All)
  4. Click Sync Selected to start the batch import

Content is sent to Sidekick Forge in batches, where it's chunked, embedded, and indexed for RAG retrieval. The sync status is shown per item so you can track what's been imported.

Developer Mode

Enable Developer Mode in the plugin settings to see real-time bridge activity below the embed. This is invaluable for debugging authentication issues.

Developer Mode — Debug Panel
Sidekick Forge Embed
Connected • Voice mode active
Sidekick Forge Bridge (Developer Mode)
[12:34:01]
Bridge initialized. Allowed origins: https://sidekickforge.com
[12:34:02]
Received SKF_REQUEST_TOKEN from iframe
[12:34:02]
Requesting Supabase session from WordPress REST API...
[12:34:03]
Received session payload.
[12:34:03]
Token sent to embed. ✓

The debug panel shows:

Troubleshooting

"Connect Now" appears for logged-out visitors

Update to plugin version 0.7.3 or later. Earlier versions loaded the bridge for all visitors. Version 0.7.3+ only loads the bridge when a WordPress user is logged in.

Bridge times out (no session established)

"Failed to create user" error

This typically occurs when the user lookup hits pagination limits. Update your Sidekick Forge backend to v2.9.4+ which includes paginated user lookup and automatic retry.

Embed shows login screen despite being logged into WordPress

Previous ← Embedding Your Sidekick