Skip to content

How to Configure Submission Review

Choose how submissions to your Inbox site are reviewed: automatically by an AI reviewer running on your own provider account, or by hand in your team's Review Queue. The switch between the two is the AI review panel on the Inbox tab in Wire settings.

Before You Begin

You must be an administrator of the Outlet or Group that operates your Inbox site, your newsroom's branded submission portal (see How Inbox Works). Members without admin permission won't see the settings described below. Ask your administrator if you're not sure which role you have.

You will need:

  • A set-up Inbox site (see How to Set Up Your Inbox Site)
  • For automated review: an API key from OpenAI or any OpenAI-compatible AI provider. The reviewer runs on your provider account and is billed to you by that provider.

Manual review is the default and needs no configuration: until an API key is added, every submission waits in your Review Queue for a person to approve or return it. That works fine at low volume; automated review becomes worth it when the queue does not keep up. For what each kind of review checks, see How Inbox Works.

Instructions

Open the AI Review Panel

  1. Go to Settings (https://wire.pluckyworks.org/settings/) on Wire and select the Outlet or Group that operates your Inbox site from the sidebar.

  2. Click the Inbox tab and scroll to the AI review panel.

    A status badge at the top shows where you stand: Active with "API key ending in [last four digits]", or Not configured with "Submissions will wait for your manual review until an API key is added."

Turn On Automated Review

Field Required? What to enter
API base URL Optional Any OpenAI-compatible endpoint. Leave blank to use OpenAI itself.
Model Optional The model name to use. Leave blank for the standard model.
API key Required Your provider API key. It is stored encrypted, verified against your endpoint when you save, and never shown again.
Review instructions Optional Extra instructions for the reviewer, such as local style rules or topics to flag. Blank uses the standard review policy, and the form notes that "the output format and decision rules are always enforced and cannot be changed here." Click Reset to standard review policy to discard your edits.

Click Save AI review settings. The key is checked against your endpoint as part of the save, so a typo fails immediately rather than silently.

Switch Back to Manual Review

  1. In the API key field's area, check Remove the stored API key (submissions will wait for manual review).

  2. Click Save AI review settings.

The badge returns to Not configured, and new submissions wait in your Review Queue.

What Happens Next

  • With automated review on, each incoming submission is checked within minutes for safety problems, editorial quality, and search-engine optimization. It either passes (often with optional suggested improvements) or comes back to the sender with specific findings to fix; the sender is notified either way, and nothing waits on your team.
  • With manual review, each submission waits in the Review Queue on your Operator Dashboard until someone on your team approves it or returns it with notes. Senders are told their submission is waiting for review.
  • Saving applies to submissions that arrive from then on. Anything already waiting in the Review Queue stays there for your team to handle.
  • Automated review calls your AI provider on your account, so your provider bills you for the usage.

Next Steps

Troubleshooting

  • I don't see the AI review panel: It appears only on the Inbox tab of the Outlet or Group that operates an Inbox site. Check that you selected the right Outlet or Group in the settings sidebar and that you have admin permission there.
  • Saving fails with a key error: The key is verified against your endpoint when you save. Check the key for typos, and check that the API base URL and Model (if you set them) are ones your provider actually serves.
  • I want automated review but my newsroom has no AI provider account: Ask your Plucky onboarding contact about options during the pilot, or create an account directly with a provider and bring its API key here.
  • Still stuck? Email support@pluckyworks.org.