Probleemoplossing ReplyRabbit
De meeste ReplyRabbit-problemen komen neer op een van drie dingen: een ontbrekende of verkeerde API-sleutel, het gebruik van een provider die je plantier niet toestaat, of een verouderde FreeScout-cache. Werk de bijbehorende sectie hieronder door, waarin elk probleem eerst het symptoom en daarna de oplossing vermeldt.
Er wordt geen concept gegenereerd
Symptoom: je een gesprek opent, maar er geen AI-concept verschijnt en er niets lijkt te gebeuren.
Oplossing: open de ReplyRabbit-instellingen van de mailbox (Mailbox > Instellingen > ReplyRabbit) en bevestig dat er een provider is geselecteerd en de API-sleutel ervan is ingesteld. Op het Free-abonnement is OpenAI de enige beschikbare provider, dus als je een andere hebt gekozen, schakel dan terug naar OpenAI of upgrade. Controleer daarna of ReplyRabbit is ingeschakeld voor de mailbox waarin je werkt, want concepten worden alleen gegenereerd voor ingeschakelde mailboxen.
Ongeldige API-sleutel of providerfout
Symptoom: je een fout ziet over een ongeldige sleutel, authenticatiefout of een provider die niet bereikbaar is.
Oplossing: controleer de sleutel op typefouten en losse spaties, bevestig dat het de sleutel is voor de provider die je daadwerkelijk hebt geselecteerd (een OpenAI-sleutel werkt niet met Anthropic) en zorg ervoor dat de sleutel nog tegoed en toegang heeft op het dashboard van de provider. Een sleutel zonder resterend saldo of met ingetrokken toegang geeft dezelfde fout.
Fouten na het upgraden van PHP
Symptoom: na een serverupgrade (bijvoorbeeld naar Ubuntu 26.04 met PHP 8.5), Verbinding testen mislukt of achtergrondtaken stoppen, en het FreeScout-log toont berichten die eindigen op is deprecated since 8.5.
Oplossing: houd ReplyRabbit en je andere modules up-to-date via Beheren > Modules, voer dan php artisan freescout:clear-cache en php artisan queue:restart. ReplyRabbit ondersteunt PHP 8.0 tot en met 8.5. Zie Los "deprecated since 8.5"-fouten op in FreeScout om te vinden uit welke module een bericht komt.
Het ReplyRabbit-menu ontbreekt
Symptoom: ReplyRabbit verschijnt niet in de FreeScout-menu's of instellingen na de installatie.
Oplossing: controleer eerst of de module is geactiveerd onder Beheren > Modules. Leeg vervolgens de cache vanuit je FreeScout-hoofdmap:
php artisan freescout:clear-cacheAls het nog steeds ontbreekt, controleer dan de rechten van de gebruiker: een gebruiker zonder toegang tot de relevante mailbox of beheerdersinstellingen ziet de ReplyRabbit-opties niet.
Concepten stopten na een tijdje
Symptoom: concepten werkten eerst, maar stopten later in de maand met genereren.
Oplossing: het Free-tier staat 10 conceptteksten per maand toe. Zodra je die limiet bereikt, pauzeren conceptteksten tot de volgende maand. Pro en Team hebben geen limiet op conceptteksten. Op elk plan pauzeren conceptteksten ook als de Maandelijks tokenbudget is opgebruikt, dus controleer ook die instelling (0 betekent geen budget).
Prompt-caching verandert de maandelijkse tokentelling niet
Symptoom: herhaalde conceptteksten lijken in aanmerking te komen voor prompt-caching van de provider, maar het tokengebruik van ReplyRabbit toont nog steeds het volledige totaal van invoer en uitvoer.
Oplossing: dit is verwacht. ReplyRabbit houdt maandbudgetten conservatief en telt totale tokens, zelfs wanneer een provider gecachte invoer anders factureert. Besparingen door provider-caching zijn afhankelijk van de provider, het model, herhaalde prompt-prefixen en rapportage door de provider. Anthropic cache control wordt alleen gebruikt voor geschikt herhaald conceptwerk en valt terug op normale generatie wanneer dit niet wordt ondersteund.
Linear-tickets worden niet aangemaakt
Symptoom: vervolgacties worden gedetecteerd, maar er wordt geen Linear-ticket aangemaakt.
Oplossing: controleer in de ReplyRabbit-instellingen de Linear API-sleutel, het geselecteerde team en of tickets in een wachtende status staan te wachten op bevestiging. Controleer ook of je tier Linear omvat: handmatig Linear-tickets aanmaken is een Pro-functie, en automatisch tickets aanmaken is een Team-functie.
Jira-issues worden niet aangemaakt
Symptoom: een gesprek engineeringwerk nodig heeft, maar er geen Jira-issue wordt aangemaakt.
Oplossing: bevestig in de ReplyRabbit-instellingen dat Jira is geselecteerd als issuetracker voor de mailbox. Controleer de Jira Cloud-site-URL, het account-e-mailadres, het API-token, het standaardproject en het standaard issuetype. Controleer ook of je tier het aanmaken van issues omvat: handmatig Jira-issues aanmaken is een Pro-functie, en automatisch issues aanmaken is een Team-functie. Zie voor het volledige installatiepad Jira-integratie.
Workflow-tags worden niet toegepast
Symptoom: je verwachtte tags zoals rr_priority_critical, rr_no_reply_needed, of rr_linear_issue_created, maar het gesprek heeft geen ReplyRabbit-tags.
Oplossing: open de ReplyRabbit-instellingen van de mailbox en bevestig Workflow-synchronisatie inschakelen en FreeScout-tags toepassen aan staan in de Workflow-tags sectie. Als signaaltags ontbreken, bevestig AI-signalen aan staat en het gesprek is geanalyseerd. Als Linear-tags ontbreken, controleer of het gesprek een door ReplyRabbit aangemaakt Linear-issue heeft.
Als FreeScout Workflows-recepten niet worden uitgevoerd, controleer dan eerst of ReplyRabbit de verwachte FreeScout-tag toevoegt. Test daarna of je geïnstalleerde Workflows-module reageert op programmatische tagwijzigingen. ReplyRabbit kan de tags toepassen, maar de Workflows-module bepaalt of een recept op basis van die tagwijziging wordt uitgevoerd.
Kennisbronnen: een concept gebruikte mijn helppagina's, Kennisbank, producten of eerdere antwoorden niet
Symptoom: een concept informatie negeerde waarvan je weet dat die in je hulppagina's, Knowledge Base, productlijst of eerdere antwoorden staat.
Oplossing: begin met de regel onder de concepttekst in de antwoordeditor. Deze toont wat de concepttekst heeft gebruikt, bijvoorbeeld "Included: 2 help pages, 1 Knowledge Base article, 3 earlier replies to this customer". Klik erop om links te zien, plus een notitie voor elke ingeschakelde bron die niets heeft toegevoegd:
- Ingeschakeld maar nog niets geïndexeerd: indexering is nog niet voltooid. Controleer de queue worker (zie hieronder) en wacht tot de indexering is voltooid.
- Geen goede match voor dit bericht: de bron is in orde, maar niets erin matchte nauw genoeg met het bericht van deze klant. Voeg inhoud toe of verbeter inhoud die dit soort vragen beantwoordt.
- Index boven de zoeklimiet: zodra de index meer dan 6.000 geïndexeerde secties passeert, draait alleen trefwoordmatching, niet matching op betekenis. Verwijder bronnen die je niet nodig hebt om weer onder de limiet te komen.
- Je plan bevat het niet: die bron is niet beschikbaar op je huidige plan.
- Kennisbank-module is niet geïnstalleerd of actief: installeer of activeer deze onder Beheren > Modules.
Waarschuwingen over installatiestatus
De installatiestatusbanner in mailboxinstellingen waarschuwt nu wanneer:
- De queue worker lijkt niet te draaien. Indexeren en automatische concepten worden nooit voltooid zonder dit. FreeScout voert de wachtrij uit via de cron-taak
php artisan schedule:runof eenqueue:workproces, dus zorg ervoor dat een van beide is ingesteld. - Er is geen kennisbron ingeschakeld. Zet er minstens één aan in Mailboxinstellingen, Kennisbronnen.
- Een bron is ingeschakeld maar nog niet geïndexeerd. Laat de indexering voltooien.
Websitebronnen
- De crawl stopt standaard bij 200 pagina's, en de bron vermeldt dit nu, met een knop om de limiet te verhogen. Sla je instellingen daarna op en crawl opnieuw.
- Pagina's die niet kunnen worden gelezen, worden met een reden geteld, bijvoorbeeld geblokkeerd door de site (403), niet gevonden (404), te veel verzoeken (429), een serverfout, te groot, of geen leesbare tekst (vaak een pagina die met JavaScript is gebouwd). Vraag je host de crawler door te laten, of richt de bron op pagina's die geen JavaScript nodig hebben.
- Zeer lange pagina's worden ingekort tot ongeveer 24.000 tekens. Wanneer semantische matching is ingeschakeld, toont de bron hoeveel pagina's zijn ingekort. Splits lange pagina's als het deel dat je nodig hebt bijna aan het einde staat.
Outline en matching op betekenis
- Outline-synchronisatie stopt bij 1.000 documenten. Documenten daarna worden niet gesynchroniseerd.
- Op betekenis gebaseerd (semantisch) matchen vereist een embeddings-provider. Sommige embeddingmodellen zijn nog niet gekalibreerd voor matches op alleen betekenis en tonen een waarschuwing, dus schakel over naar een ander embeddingmodel als je die ziet.
Nog steeds vast?