AI Agent for WordPress

1. Introduction

AI Agent is a chat assistant for WordPress powered by Anthropic’s Claude. It answers visitors based on what you define in the system prompt — your services, prices, business hours, and contact details — 24 hours a day, in the visitor’s language.

You pay for the model directly to Anthropic through your own API key (you control the cost and the data). media-met only charges for the plugin license, not for AI usage.

2. Installation

1. In the WordPress admin, go to Plugins → Add New → Upload Plugin and upload the ZIP.
2. Activate the plugin. AI Agent appears in the menu.
3. Open AI Agent → Settings for further configuration.

3. License activation

1. Open AI Agent → Settings.
2. Paste the license key you received by email and click Activate.

Key format: AAGT-XXXX-XXXX-XXXX-XXXX

License terms:

• The license is valid for 12 months from activation and is verified through the media-met license server.
• The number of domains depends on the plan: Starter (1 domain), Business (3 domains), Agency (unlimited).
• You can deactivate the license and move it to another domain (Settings → Deactivate → Activate on the new one).

4. Anthropic API key

Each user uses their own Anthropic API key.

1. Sign up at console.anthropic.com and open Settings → API Keys.
2. Create a key and copy it.
3. Paste it into AI Agent → Settings and save.
4. Add credit under Billing in the Anthropic console.

Cost: The recommended model is Claude Haiku — fast and economical. For a site with ~50 visits per day, the typical cost is just a few euros per month, paid directly to Anthropic based on usage.

5. System prompt

The system prompt is the most important setting — it’s where you describe what your site offers, the tone of communication, and contact details. The richer it is, the more accurate the answers.

Example for an agency:

“You are the assistant of the digital agency [name]. You inform potential clients about services (web design, SEO, branding), prices, and the collaboration process. Contact: info@agency.com.”

Note: The agent answers solely based on what you give it. If it gives incomplete or inaccurate answers, expand the system prompt with more detail.

6. Widget and appearance

• Enable the Widget active option in the settings so the chat shows to visitors.
• You can display the widget automatically across the whole site, or insert it with a shortcode or block at a specific location.
• Customize the assistant’s colors, name, and avatar to match your brand.

7. Language

The agent automatically answers in the visitor’s language. If you want it to always answer in a specific language, add this to the system prompt: “Always answer in English, regardless of the language of the question.”

8. GDPR and privacy

You become the data controller: By installing the plugin, you become the controller of the personal data of visitors who use the chat. Make sure your privacy setup is compliant.

• Update the Privacy Policy on your site and enter its URL in AI Agent → Settings → GDPR.
• Keep the Privacy notice enabled in the chat.
• The IP address is not stored. Conversations are automatically deleted after a set period (default 12 months).
• You manage conversations in AI Agent → Conversations — “Delete all” or, for a single session, “Delete session (GDPR)”.

9. Troubleshooting

“Network problem” — the chat doesn’t work

Possible cause	Solution
API key not entered or invalid	AI Agent → Settings → check the API key
No credit on the Anthropic account	console.anthropic.com → Billing → add credit
License not active	AI Agent → Settings → activate the license key
Hosting blocks the REST API	Ask your host to allow access to /wp-json/aagt/v1/
ModSecurity / WAF blocks the requests	Disable ModSecurity for your domain in cPanel

The widget doesn’t appear

• Check that “Widget active” is enabled and the license is active (green status).
• Reload the page with a hard refresh (Ctrl/Cmd + Shift + R).
• Temporarily disable other plugins to check for a conflict.

The agent answers in the wrong language or inaccurately

Expand the system prompt — for language, add an instruction to always answer in your preferred language; for accuracy, add more detail about services, prices, and contacts.

10. License renewal

The license is valid for 12 months from activation. You can see the expiry date in AI Agent → Settings; the plugin checks the license status once a day.

After expiry: the chat widget keeps working for your visitors, and your settings and conversations stay untouched. Only automatic updates and support stop — the admin shows a “License expired” notice. The widget is hidden only if the license has not been activated or the license server has rejected it (e.g. a revoked license or the wrong domain).

Renewal: email info@media-met.hr with the subject “AI Agent license renewal”, pay for the renewal, then deactivate the old key in Settings and activate the new one.

11. Technical requirements

• 5.8+ WordPress (6.x tested)
• 7.4+ PHP (8.x recommended)
• Claude Anthropic API key
• EN / HR + multilingual chat
• per domain license + verification

12. FAQ

Do I need my own Anthropic API key?

Yes. Each user uses their own key and pays Anthropic directly based on usage. media-met only charges for the plugin license.

How much does using the AI cost?

It depends on traffic and model. With Claude Haiku, for a site with ~50 visits per day, the cost is usually just a few euros per month.

How many domains does the license cover?

It depends on the plan: Starter 1 domain, Business 3 domains, Agency unlimited. You can deactivate the license and move it to another domain.

Does it answer only about my content?

Yes — the agent answers based on the system prompt you give it. The more detail you provide, the more precise the answers.

What data does it collect?

The conversation content, the page URL, and optionally the visitor’s email. The IP address is not stored, and conversations are automatically deleted after a set period.

Does it work in other languages?

Yes. The agent answers in the visitor’s language, and with an instruction in the system prompt you can force it to always answer in a specific language.

13. Contact and support

For questions and help, email info@media-met.hr (include your site URL, a description of the problem, and a screenshot of the error). More about products and services at media-met.hr.