Documentation

Getting started

Answyr installs like any WordPress plugin and is doing useful work within a few minutes. Requires WordPress 6.0+ and PHP 8.0+.

  1. 1. Install & activate

    Install Answyr from WordPress.org (or upload the answyr folder to /wp-content/plugins/) and activate it. Activation creates the ticket tables and seeds sensible defaults.

  2. 2. Connect an AI provider

    Go to Answyr → Settings → AI, choose Anthropic or OpenAI, and paste your API key. Keys are encrypted at rest, and no AI calls are made until a key is set. Use Test to verify, then Save Changes.

  3. 3. Add your knowledge

    Write articles in the built-in Knowledge base, or point Answyr at content you already publish (any post types you choose). This is what grounds every AI answer and draft.

  4. 4. Turn on Chat & the portal

    Enable the Chat widget (sitewide or via the [answyr_chat] shortcode) and publish a customer portal page with [answyr_portal]. One-click buttons in Settings → Pages create these for you.

  5. 5. Handle tickets with AI drafts

    New requests land in Answyr → Tickets. Open one, click Suggest reply (AI) for a grounded draft with cited sources, edit it, and send. The AI never sends on its own.

Bring-your-own-key, by design

Answyr only contacts your chosen AI provider when you enable an AI feature and add a key. It sends the relevant ticket/conversation text plus excerpts of your own content used for grounding. See the privacy page and the plugin's readme for the full external-services disclosure.

Need a hand? Ask in the WordPress.org support forum.