Descripción
Promptwatch connects your WordPress site to your Promptwatch project. It does three things:
- Publishes content you write in Promptwatch as standard WordPress posts. You can stage a post as a WordPress draft first, then publish it live. Re-publishing updates the same post instead of creating a duplicate, and a live post keeps its original publish date.
- Optionally adds the Promptwatch analytics tag to your public pages, so visits referred by AI assistants show up in your project’s visitor analytics. Off by default, and it can skip logged-in administrators.
- Optionally sends a log of visits that reach your site (for example visits from AI crawlers) to Promptwatch. Off by default, and it requires a Promptwatch API key.
You need a Promptwatch account to use this plugin. The full setup and publishing guide, including staging drafts, categories and author matching, and headless setups, is at promptwatch.com/docs/academy/wordpress.
How connecting works
There is no password or API key to paste in for publishing. In Settings Promptwatch you generate a one-time sync token, then paste your site URL and that token into Promptwatch. Promptwatch tests the connection before saving it, so a wrong token or an unreachable site fails immediately with a specific error. Your site never keeps a readable copy of the token, so it cannot be stolen from your database.
External services
This plugin connects to the Promptwatch service. What is sent, and when, depends on which features you enable:
-
Content publishing (required for the core feature). Promptwatch’s servers write content into your site over authenticated REST routes (
promptwatch/v1/sync,promptwatch/v1/publish,promptwatch/v1/config,promptwatch/v1/options), authorized by the sync token you generate. This is an inbound connection: the plugin receives content; it does not send your content out./optionsonly returns this site’s categories and users who can edit posts, so Promptwatch can show them in the connection settings. -
Visitor analytics,
ingest.promptwatch.com(only when you enable “Visitor analytics”). The plugin adds a small script to public pages. That script loadshttps://ingest.promptwatch.com/js/client.min.jsin the visitor’s browser and sends analytics events (such as page views), tagged with your Promptwatch project ID, to Promptwatch. No analytics are sent while this feature is off. -
AI-crawler logs,
logs.promptwatch.com(only when you enable “Crawler logs” and set an API key). For public requests that reach WordPress, the plugin collects request metadata (timestamp, request path and method, response status, content type, user agent, referrer, client IP, and hostname) and sends it in batches tohttps://logs.promptwatch.com/event, authorized by your Promptwatch API key. Nothing is sent while this feature is off or no key is set. -
Featured images (during content publishing). When a document published from Promptwatch includes a featured image, the plugin downloads that image from the URL Promptwatch sends (a token-authenticated sync request) and stores it in your media library as the post thumbnail. No image is fetched outside of a publish.
By using these features you send the data described above to Promptwatch. Please review the Promptwatch Terms and Conditions and Privacy Policy.
Instalación
The step-by-step guide with screenshots is at promptwatch.com/docs/academy/wordpress. The short version:
- Install the plugin from Plugins Add New (search for “Promptwatch”), or upload the ZIP, and activate it.
- Go to Settings Promptwatch and click Generate token.
- In Promptwatch, open Project Settings CMS Integrations and click Connect on the WordPress card.
- Paste your site URL and the token. Promptwatch tests the connection before saving it.
Pretty permalinks must be enabled (Settings Permalinks, anything except “Plain”). The plugin’s settings page warns you if they are off.
Preguntas frecuentes
-
Do I need a Promptwatch account?
-
Yes. This plugin is a connector for the Promptwatch service and does nothing on its own.
-
Do I have to paste an API key to publish content?
-
No. Publishing uses a sync token you generate in the plugin. An API key is only needed if you enable AI-crawler logs.
-
Is my token stored safely?
-
Yes. Your site never keeps a readable copy of the sync token, and the token is never shown again after you generate it. The optional crawler-logs API key is stored encrypted.
-
Will this create duplicate posts?
-
No. Each Promptwatch document maps to a single post. Re-publishing updates the same post.
-
Can I review a post before it goes live?
-
Yes. Promptwatch can push a document as a WordPress draft first, so your team can review it in wp-admin. Publishing it live later changes only that post’s status; it never touches the rest of your site.
-
Yes. Pick categories and an author in the WordPress connection settings in Promptwatch. Leave categories empty to keep the post’s existing categories. The author is matched against your WordPress users; if nothing matches, new posts fall back to the first administrator, and updates keep the post’s current author. Details are in the WordPress guide.
-
My WordPress runs on a different domain than my website. Does that work?
-
Yes. For headless setups, where WordPress lives at for example
cms.example.combut your site isexample.com, Promptwatch publishes through the CMS host and tracks the content on your website. See the WordPress guide for how to set the content path. -
The connection stopped working. What do I do?
-
Generate a new token in Settings Promptwatch and paste it into the reconnect dialog in Promptwatch. Tokens become invalid when you regenerate them or when your site’s WordPress security keys change. Reconnecting keeps your publish history.
-
What happens when I uninstall?
-
Uninstalling removes everything the plugin stored: its settings and its background data. Posts published from Promptwatch stay on your site as normal posts.
-
Where can I get help?
-
The full guide is at promptwatch.com/docs/academy/wordpress. For anything else, contact Promptwatch support at promptwatch.com/contact-us.
Reseñas
No hay reseñas para este plugin.
Colaboradores y desarrolladores
“Promptwatch” es un software de código abierto. Las siguientes personas han colaborado con este plugin.
ColaboradoresTraduce “Promptwatch” a tu idioma.
¿Interesado en el desarrollo?
Revisa el código , echa un vistazo al repositorio SVN , o suscríbete al log de desarrollo por RSS .
Registro de cambios
1.3.0
- Apply categories and author chosen in Promptwatch when creating or updating posts.
- Let Promptwatch list this site’s categories and authors, so you can pick them in the connection settings.
- Crawler-log forwarding retries right away after you save or remove the API key, instead of waiting out an earlier failure.
1.2.0
- Load all scripts and styles the standard WordPress way.
1.1.0
- Fix empty paragraphs showing up in themes, feeds, and headless frontends.
1.0.0
- Initial release: content publishing, optional visitor analytics, and optional AI-crawler log forwarding.