Troubleshooting

Loopt iets vast? Hieronder de meest voorkomende issues. en de oplossing.

Agent reageert niet op nieuwe mails

Mogelijke oorzaken:

1. E-mail niet in juiste label/folder
   • Check: Dashboard → Connectors → Gmail/Outlook → Labels
   • Stuur jezelf een test-mail in het ingestelde label
2. OAuth-token verlopen
   • Vaak na wachtwoord-wijziging of langer dan 90 dagen inactief
   • Fix: Dashboard → Connectors → [e-mail] → Verbind opnieuw
3. Agent staat op pauze
   • Check: Dashboard → Agents → [agent]. zie statusbadge
   • Fix: klik "Activeer"

Moneybird-sync geeft fouten

Symptomen: facturen verschijnen niet in Moneybird of krijgen verkeerde grootboek.

1. Sync-foutmelding bekijken in Dashboard → Connectors → Moneybird → Logs
2. Common errors:
   • 400: invalid_ledger_account. productcategorie zonder gekoppeld grootboek. Fix in Moneybird-instellingen.
   • 403: insufficient_scope. OAuth-scopes niet volledig goedgekeurd. Verbind opnieuw.
   • 429: rate_limited. te veel requests tegelijk. Sync wacht automatisch en herstelt.

Webhook bereikt mijn endpoint niet

1. Endpoint moet HTTPS zijn. HTTP-endpoints worden geweigerd
2. Endpoint moet binnen 30 seconden 2xx returnen. anders wordt 't als failed beschouwd
3. Check retries in Dashboard → Webhooks → [endpoint] → Logs
4. Signature-fout? Zie Webhooks → Signature verificatie

Mollie-betaling niet gesynct naar Corlega

Mogelijke oorzaken:

• Webhook URL in Mollie staat verkeerd → Corlega registreert deze automatisch bij verbinden, maar bij re-key moet je opnieuw verbinden
• Mollie test-mode actief terwijl je live verwacht → check API-key prefix (live_ vs test_)
• Payment status nog pending of open → Corlega markeert pas bij paid

Bij twijfel: Dashboard → Connectors → Mollie → Sync nu.

Offerte krijgt verkeerde prijzen

De agent werkt 100% vanuit je productenlijst. Als prijzen niet kloppen:

1. Productenlijst checken in Moneybird (Corlega haalt deze elke nacht op, of Dashboard → Connectors → Moneybird → Sync nu)
2. Custom-pricing-regels. zie Dashboard → Agents → Offerte → Regels. BTW-tarieven of kortingen kunnen hier afwijken.
3. Voorbeeld-offertes uploaden. als de agent een specifiek patroon mist, laat 'm leren van 2-3 vergelijkbare cases.

Klantenservice-agent escaleert te veel

Bedoeld gedrag: liever te veel escalaties dan een verkeerd antwoord.

Tunen:

1. Kennisbank uitbreiden. Dashboard → Agents → Klantenservice → Kennisbank
2. Escalatie-thresholds verlagen in instellingen (bv. boze klant alleen bij sentiment-score < -0.7)
3. Tone-templates aanvullen met 5-10 voorbeeld-replies per veelvoorkomende intent

Planning maakt verkeerde slots

• Werkuren check. zit lunchpauze juist?
• Reistijd-buffer. standaard 15 min, voor steden vaak meer nodig
• Skills-matching. heeft monteur de juiste skill voor deze klusclass?

Dashboard → Agents → Planning → Instellingen voor alles.

Krijg "401 Unauthorized" op API

1. API-key correct? Begint met cor_live_ of cor_test_
2. Header correct? Authorization: Bearer cor_live_... (let op spatie)
3. Key niet geroteerd? Check Dashboard → API-keys. geroteerde keys werken niet meer
4. Scope toereikend? Een read-only key kan geen POST doen

"429 Too Many Requests"

Je bent over je rate-limit. Wacht het aantal seconden in de Retry-After header, of upgrade je plan.

Implementeer in je client een exponential backoff:

async function withRetry(fn, maxAttempts = 5) {
  for (let i = 0; i < maxAttempts; i++) {
    try {
      return await fn();
    } catch (err) {
      if (err.status !== 429 || i === maxAttempts - 1) throw err;
      const retryAfter = parseInt(err.headers["retry-after"] ?? "1");
      await new Promise(r => setTimeout(r, retryAfter * 1000));
    }
  }
}

Nog steeds vast?

• Check de FAQ. misschien staat je vraag erbij
• Mail hello@corlega.com. antwoordtijd 1 werkdag (Enterprise 4 werkuren)
• Voor P1-incidenten (platform down): 040 304 1951 (24/7)