Everything you need to ship a production-grade AI support agent on WordPress.

WP Replai is a skills-powered AI support agent for WordPress. It embeds a conversational chat widget on your site that can answer questions, collect leads, look up orders, send emails, walk users through troubleshooting, and much more: all automatically, in any language, around the clock.

Unlike basic chatbots that answer from a static FAQ, WP Replai's agent is dynamic. You give it Skills: modular instructions that define exactly what to do in any situation. The agent decides which skill to load based on the visitor's intent, follows the instructions, and takes action.

Key capabilities

• Responds to visitor questions instantly in any language
• Loads skills on demand to handle specific workflows
• Call tools like Sends emails, collects quotes: based on skill definitions
• Reads web pages from a link you or a visitor shares and responds using that content
• Escalates to your team with a full conversation summary
• Logs every conversation for admin review
• Collects visitor satisfaction ratings
• Works with GPT-4, Claude, Gemini, Llama, and more

When a visitor sends a message, WP Replai reads your settings and available skills, picks the most relevant one, and follows its instructions to respond. Conversations are saved automatically so returning visitors pick up where they left off.

Reading web pages

The agent can read web pages. If you or a visitor share a link to a source of information, such as a docs page, blog post, or product page, the agent fetches the content of that page and uses it to inform its response. There is no need to copy and paste the content into a skill first. Just provide the link in the conversation and the agent reads it and responds accordingly.

1. Download WP Replai and install it via WordPress Admin → Plugins → Add New → Upload Plugin.
2. Activate the plugin: you will be automatically redirected to the onboarding wizard.
3. Complete the 4-step setup (under 2 minutes).
4. Your agent is live on the frontend.

The wizard runs automatically after first activation and walks you through the essential configuration.

Step 1: Welcome

Introduction screen. Click Get started to proceed.

Step 2: Business profile

Tell the agent about your business. This context is injected into the system prompt so the agent understands what it's supporting.

Step 3: Setup agent

Step 4: Configuration complete

The wizard seeds your database with the built-in skills and shows you a live preview of the chat widget. Click Done to go to the Skills page.

Access via WP Replai → Settings in your admin dashboard.

Agent

Business

Widget

The chat widget appears as a floating button (bottom-right) on your site's frontend. It is enabled by default and can be disabled from Settings → Widget.

Widget features

• Launcher button: circular, colored with your primary color
• Agent header: shows avatar, agent name, "Online" status, and new chat button
• Message thread: scrollable conversation with user and agent bubbles
• Typing indicator: animated dots while the agent is thinking
• Input area: textarea with send button (Enter to send, Shift+Enter for newline)
• New chat button: appears after the agent's first reply; starts a fresh conversation
• Rating overlay: 1–5 star rating prompt when starting a new chat; visitor can skip

Markdown rendering

Agent responses support full Markdown including headings, bold, italic, lists, tables, code, and links. Rendered safely via Parsedown.

Conversation history

When a returning visitor opens the widget, their previous conversation is loaded automatically from the database: no re-introduction needed.

Session management

Each visitor's conversation is saved automatically. A new session starts when the visitor clicks "New chat". Previous conversations are preserved and visible in the admin Conversations page.

Multilingual support

The agent responds in any language the visitor writes in. No additional configuration required.

Branding

• Primary color: set in Settings, applied to launcher, user messages, send button, and star ratings
• Custom CSS: inject any CSS rules scoped to the widget via Settings
• Agent avatar: upload an image from your media library
• Agent name: set in Settings, shown in the widget header

All models are accessed via OpenRouter using a single API key. Switch models any time from Settings.

Default model: GPT-4o

Skills are the core of WP Replai. A skill is a set of instructions that tells your agent what to do in a specific situation, written in plain language, like a brief for a team member.

How skills work

1. The agent sees a list of all your enabled skills and their descriptions.
2. The full skill instructions are loaded into the conversation.
3. The agent follows the skill instructions exactly.

Skills page

Access via WP Replai → Skills. The page has three sections:

• Custom skills: Skills you've created. Fully editable, deletable, and togglable.
• Built-in skills: Skills included with the plugin. Toggle on/off but cannot be edited or deleted.
• Templates: 16 pre-written skill templates ready to import and customise.

Each skill card shows: skill name (formatted), description, enable/disable toggle, edit or view button, and a delete button (custom skills only).

WP Replai ships with 2 built-in skills that are seeded into your database on first setup.

Support Email: what it does

• Collects the visitor's name, email, and issue description
• Determines priority (high / medium / low) based on severity
• Generates a conversation summary automatically
• Sends a formatted email to your support email address
• Visitor receives a confirmation

Troubleshooting: what it does

• Walks the visitor through diagnosis one step at a time
• Starts with the simplest, highest-impact fixes
• Uses plain, non-technical language
• Asks permission before suggesting technical steps
• If nothing works, escalates using the support-email skill

16 ready-made templates are available on the Skills page. Click Use Template → on any card to open it pre-filled in the skill editor. Customise and save as your own skill.

Creating a skill

Go to WP Replai → Skills → Add New Skill.

Writing skill instructions

Skills are written in plain Markdown. Use headings, bullet lists, and numbered steps. The agent follows these instructions exactly.

## Refund Policy

Use this skill when a visitor asks about refunds, cancellations, or money back.

### Eligibility
- Refunds available within 30 days of purchase
- Digital products are non-refundable

### How to Request
1. Ask the visitor for their order number
2. Confirm eligibility
3. Use the support-email skill to escalate the request

### Fallback
If the visitor is not eligible, explain the policy clearly and offer an alternative.

Enabling / disabling skills

Toggle any skill on or off from the Skills list page. Disabled skills are hidden from the agent's available skills list and will not be loaded.

Skills can do more than give instructions — they can trigger actions. A skill tool is a function your agent can call mid-conversation: to send an email, look up an order, collect a quote, or anything else you define.

How tools work

1. You define a tool inside a skill using a [TOOLS] block.
2. When the agent decides to use the tool, it calls it by name with the required parameters.
3. Your PHP handler receives the call, runs the action, and returns a result.
4. The agent uses the result to continue the conversation.

Built-in tools

WP Replai ships with two built-in tools you can use immediately without writing any code:

• send_support_email: collects visitor details and sends a formatted email to your support address
• send_web_design_quotation: collects a project brief and emails it to a configurable address (set via a comment at the top of the skill body)

Defining a tool in a skill

Add a [TOOLS] block at the bottom of any skill's instructions:

[TOOLS]
[
  {
    "type": "function",
    "function": {
      "name": "my_tool_name",
      "description": "What this tool does and when to call it.",
      "parameters": {
        "type": "object",
        "properties": {
          "param_one": {
            "type": "string",
            "description": "Description of this parameter"
          }
        },
        "required": ["param_one"],
        "additionalProperties": false
      }
    }
  }
]
[/TOOLS]

Registering the tool handler in PHP

Use the wpreplai_before_chat_call action hook to register a PHP function that handles the tool call:

add_action( 'wpreplai_before_chat_call', function( $agent ) {
    $agent->register_callable( 'my_tool_name', function( $params ) {
        // do something with $params
        return [ 'result' => 'done' ];
    });
});

Access via WP Replai → Conversations.

Conversations list

A table showing all chat sessions with:

Paginated at 50 sessions per page.

Conversation detail

Shows the full transcript for a session:

• Session meta: start date/time, message count, star rating
• Transcript: user messages (right-aligned) and agent replies (left-aligned, Markdown rendered)
• Tool call pills: small tags below each agent reply showing what the agent did (e.g. "⚙ Loaded skill: Troubleshooting", "⚙ Sent support email")
• Delete button: permanently removes the session and all its messages

Ratings

Visitors can rate the conversation 1–5 stars when starting a new chat. Ratings appear in the conversations list and detail view. Sessions with no rating show no value.