Docs / Troubleshooting · Fatti indicizzare dalle AI
Troubleshooting
Mappa error code → soluzione + problemi ricorrenti e come diagnosticarli.
Mappa error code → soluzione
| Error code | HTTP | Cosa fare |
|---|---|---|
| INVALID_LICENSE_KEY | 401 | Verifica di aver copiato la key correttamente. Se persa, richiedi reissue dal dashboard. |
| LICENSE_SUSPENDED | 403 | Licenza sospesa dall'admin (abuso o richiesta). Contatta support@geocite22.com. |
| LICENSE_EXPIRED | 403 | Abbonamento scaduto. Aggiorna il metodo di pagamento dal Customer Portal. |
| LICENSE_REVOKED | 403 | Abbonamento cancellato o revocato. Sottoscrivi di nuovo da /pricing. |
| SITE_LIMIT_EXCEEDED | 403 | Raggiunto il cap siti del piano. Disattiva un sito da /dashboard/sites o fai upgrade. |
| TIER_NOT_ALLOWED | 403 | Endpoint disponibile solo su Premium (es. /ai/generate). Upgrade o usa la tua API key BYOK. |
| INSUFFICIENT_CREDITS | 402 | Saldo crediti insufficiente. Acquista un top-up o attendi l'allocazione mensile. |
| RATE_LIMIT_EXCEEDED | 429 | Rate limit 60/min o 600/h superato. Implementa backoff nel plugin (il plugin lo fa nativamente). |
| IDEMPOTENCY_CONFLICT | 409 | Stesso idempotency_key con payload diverso. Il plugin rigenera la key a ogni tentativo. |
| PAYLOAD_TOO_LARGE | 413 | post_content oltre 60K char. Riduci il contenuto o usa un modello con context più grande. |
| AI_PROVIDERS_UNAVAILABLE | 503 | Tutti i provider in errore temporaneo. Riprova dopo retry_after_seconds. |
| AI_TOOL_USE_MALFORMED | 502 | Provider ha risposto in formato inatteso. Il plugin dovrebbe riprovare con provider alternativo. |
Problemi ricorrenti
Il plugin dice "License not recognized"
Controlla di aver incollato l'intera key comprensiva del prefisso GC22- (nessuno spazio, nessun trattino mancante). Se la key è corretta e l'errore persiste, potrebbe essere stata revocata o reemessa: chiedi al cliente (o a te stesso) la key attuale dal dashboard.
JSON-LD non appare nel <head>
Verifica che un altro plugin SEO (Yoast, RankMath) non stia rimuovendo gli schema custom. Dal pannello plugin, tab Diagnostics, trovi il debug del payload JSON-LD emesso per il post corrente.
AI generation lenta (> 30s)
Normale con post lunghi e Opus/GPT-4o. Considera GPT-4o-mini o Gemini Flash per generazioni veloci. Su Premium, il ProviderRouter può essere configurato per preferire modelli più veloci.
Voucher "non riscattabile" ma il codice è corretto
Controlla: hai una licenza Premium attiva? I voucher sono riservati al tier Premium. Se sì, verifica data di validità e limite utilizzi. Se il codice è multi-use ma esaurito, chiedi un voucher personale a support@geocite22.com.
Ancora bloccato?
Scrivi a support@geocite22.com con: license key_prefix (primi 4 blocchi), URL del sito, error code ricevuto, payload request se disponibile.