WordPress integration
Connect your WordPress site to LuluDesk and your posts, pages, and custom post types stay in sync automatically. Publish a new post and it is indexed within seconds — no manual re-crawl required.
How it works
The integration has two parts that work together:
- LuluDesk WordPress plugin — installed on your WordPress site. On activation it performs a full initial sync, and thereafter fires a webhook to LuluDesk whenever a post is published, updated, or deleted.
- LuluDesk webhook receiver — a secure endpoint on the LuluDesk platform that verifies the HMAC signature on each incoming webhook, then upserts or removes the affected content chunks in your knowledge base.
Both parts are already available — no additional plan required beyond having an active workspace.
Connect your WordPress site in LuluDesk
Open your dashboard → Integrations tab and click Connect WordPress site. Enter your WordPress site URL (must be HTTPS) and click Connect site.
LuluDesk will generate two credentials you will need in the next step:
- API Key — a secret key the plugin uses to authenticate itself when making REST API calls back to LuluDesk.
- Webhook URL — the endpoint on LuluDesk that WordPress will POST to when content changes.
Copy both values — the modal will show them once. If you lose them, disconnect and reconnect the site to generate new ones.
Install the LuluDesk WordPress plugin
In your WordPress admin, go to Plugins → Add New → Upload Plugin. Upload the LuluDesk plugin zip, then click Install Now → Activate.
After activation, navigate to Settings → LuluDesk → Knowledge Base and paste in the credentials from Step 1:
API Key: ld_wp_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
Webhook URL: https://luluclaw.com/api/integrations/wordpress/webhookClick Save settings. The plugin will immediately begin a full sync of your existing published content.
Choose which post types to sync
By default the plugin syncs post and page post types. To add custom post types, go to Settings → LuluDesk → Sync settings and tick the types you want included. The change triggers a re-sync for any newly included types.
Excluded post types — drafts, private posts, and password-protected pages — are never sent to LuluDesk regardless of the setting.
Verify the sync
Back in your LuluDesk dashboard, open the Integrations tab. Your connected WordPress site will appear with a sync state indicator:
- Syncing — initial full sync is in progress. Chunk count updates in real time.
- Ready — sync is complete. The chunk count shows how many content pieces were indexed.
- Error — something went wrong. Check the troubleshooting section below.
Try asking your widget a question about content from your WordPress site. If the answer is accurate, the integration is working.
Live updates
After the initial sync, the integration keeps your knowledge base current automatically:
- Publish or update a post — LuluDesk re-chunks and re-embeds the content within a few seconds.
- Delete or trash a post — LuluDesk removes the corresponding chunks from your knowledge base.
- Change a post from published to draft — treated as a delete. The content is removed until the post is re-published.
Troubleshooting
Sync state shows "Error"
The most common cause is a credentials mismatch. Verify that the API Key and Webhook URL in Settings → LuluDesk → Knowledge Base exactly match the values from the LuluDesk dashboard. There should be no trailing spaces or line breaks.
If your WordPress site is behind a firewall or a WAF (e.g. Cloudflare), confirm that outbound webhook requests to luluclaw.com are not being blocked.
Chunk count is 0 after full sync
Check that your WordPress site is publicly accessible. LuluDesk fetches content via the WordPress REST API (wp-json/wp/v2/posts). If the REST API is disabled or restricted by a plugin, content cannot be fetched.
To verify, visit https://yoursite.com/wp-json/wp/v2/posts in a browser. You should see a JSON array of your published posts.
New posts are not appearing in the widget
Confirm the webhook is firing. In your WordPress admin, go to Settings → LuluDesk → Webhook log — it shows the last 20 webhook dispatches with status codes. A 200 response means LuluDesk received and accepted the update.
If you see a 401 response, regenerate your credentials by disconnecting and reconnecting the site in the LuluDesk dashboard.