Troubleshooting ReplyRabbit

Most ReplyRabbit problems come down to one of three things: a missing or wrong API key, using a provider your plan tier does not allow, or a stale cache. Work through the matching section below, where each issue lists the symptom first and then the fix.

No draft is generated

Symptom: you open a conversation, but no AI draft appears and nothing seems to happen.

Fix: open the mailbox's ReplyRabbit settings (Mailbox → Settings → ReplyRabbit) and confirm a provider is selected and its API key is set. On the Free tier the only available provider is OpenAI, so if you picked a different one, switch back to OpenAI or upgrade. Then check that ReplyRabbit is enabled for the mailbox you are working in, since drafts only generate for enabled mailboxes.

Invalid API key or provider error

Symptom: you see an error mentioning an invalid key, authentication failure, or a provider that cannot be reached.

Fix: re-check the key for typos and stray spaces, confirm it is the key for the provider you actually selected (an OpenAI key will not work with Anthropic), and make sure the key still has credit and access on the provider's dashboard. A key with no remaining balance or revoked access produces the same error.

The ReplyRabbit menu is missing

Symptom: ReplyRabbit does not appear in the FreeScout menus or settings after installing it.

Fix: first make sure the module is activated under Manage → Modules. Then clear the cache from your FreeScout root:

php artisan freescout:clear-cache

If it is still missing, check the user's permissions: a user without access to the relevant mailbox or admin settings will not see the ReplyRabbit options.

Drafts stopped after a while

Symptom: drafts worked at first, then stopped generating later in the month.

Fix: the Free tier allows 10 drafts per month. Once you hit that limit, drafts pause until the next month. Upgrade to Pro or Team for unlimited drafts.

Linear tickets are not being created

Symptom: next actions are detected, but no Linear ticket is created.

Fix: in ReplyRabbit settings, check the Linear API key, the selected team, and whether tickets are sitting in a pending state waiting for confirmation. Also confirm your tier includes Linear: manual Linear ticket creation is a Pro feature, and automatic ticket creation is a Team feature.