FAQ e risoluzione dei problemi

Domande comuni e come risolvere i problemi più frequenti, approssimativamente in ordine di frequenza.

Generale

Perché non ho ricevuto un avviso quando la pagina è cambiata?

I motivi più comuni, in ordine:

L'LLM non ha considerato il cambiamento significativo data la tua descrizione. Apri i controlli recenti del monitor — vedrai che il diff è stato elaborato ma classificato come non degno di nota. Affina la descrizione (vedi Filtri e descrizioni).
La pagina non è cambiata nella parte che estraiamo. Rimuoviamo il boilerplate (nav, footer, annunci) prima dell'hashing. Se il cambiamento era nel contenuto rimosso, non lo vedremo mai.
Il monitor è in pausa. Controlla la pagina dei dettagli del monitor — la pausa automatica dopo 10 controlli falliti consecutivi è una sorpresa frequente.
Il canale è fallito. Una consegna può fallire (URL del webhook errato, destinatario email non verificato, un errore HTTP dal ricevitore). Le consegne vengono tentate una volta, senza riprova automatica.

Perché ho ricevuto un avviso per un cambiamento che non era significativo?

La tua descrizione è probabilmente troppo vaga o non menziona cosa ignorare. Modificala per aggiungere una clausola esplicita "ignora X" per qualsiasi cosa ti abbia disturbato. Il cambiamento si applica al controllo successivo.

Quanto sono recenti gli avvisi?

Una volta che un controllo rileva un cambiamento, l'avviso viene accodato per la consegna in pochi secondi. Il tempo totale (cambiamento della pagina → visualizzazione dell'avviso) dipende dalla frequenza con cui il monitor viene controllato, che è adattiva — le pagine che cambiano spesso vengono controllate più frequentemente e i piani superiori hanno una priorità di pianificazione maggiore. Usa Controlla ora se devi forzare un controllo immediato.

Memorizzate il contenuto della pagina?

Memorizziamo il testo estratto e gli screenshot renderizzati per ogni controllo, conservati per la finestra di conservazione del tuo piano (che varia in base al piano). I riepiloghi dei cambiamenti vengono conservati con ogni cambiamento rilevato. Gli screenshot sono serviti da Cloudflare R2.

Recupero e blocchi

Il monitor continua a fallire con lo stato "blocked".

Il sito sta rilevando e bloccando le nostre richieste. Il fetcher passerà automaticamente a un browser headless e poi a un proxy residenziale, ma alcuni siti bloccano tutti e tre. Soluzioni:

Passa al monitoraggio di un'API o di un feed che il sito pubblica (/feed.xml, /api/...) — questi di solito non sono protetti.
Monitora una sitemap se il sito ne ha una — le sitemap tendono a rimanere accessibili.
Per i siti protetti da autenticazione forte, crea la tua integrazione che invia un post a un webhook di Page Deltas quando il loro stato interno cambia.

Il monitor restituisce 403/429 a intermittenza.

Questi sono segni che il sito sta limitando o bloccando le richieste automatizzate. Il fetcher passa già dall'HTTP semplice a un browser headless e poi a un proxy residenziale; se una pagina blocca ancora a intermittenza, monitorare un feed, un'API o una sitemap pubblicata dal sito è solitamente più affidabile della pagina renderizzata.

API e integrazione

Come faccio a ruotare una chiave API?

Crea una nuova chiave, sostituiscila nel tuo client, quindi elimina quella vecchia. Le chiavi sono indipendenti — l'emissione di una nuova non invalida quelle esistenti.

La verifica del webhook continua a fallire.

Tre cose da controllare:

Stai eseguendo l'hash dei byte del corpo grezzi, not del JSON analizzato. I framework che analizzano automaticamente il JSON spesso scartano i byte originali.
Stai firmando solo il corpo grezzo — non c'è timestamp e nessun separatore. L'header è X-Signature: sha256=<hex>.
Stai confrontando in tempo costante (timingSafeEqual in Node, hmac.compare_digest in Python).

Account

Posso cambiare il nome della mia organizzazione?

Il nome dell'organizzazione viene impostato al momento della registrazione (derivato dalla tua email) e oggi non è modificabile in autonomia. I link utilizzano ID opachi ovunque, quindi nulla nell'app dipende dal nome. Se hai bisogno di cambiarlo, invia un'email al supporto.

How do I export my data?

Non esiste ancora un'esportazione con un solo clic. Puoi scaricare i tuoi monitor e i cambiamenti rilevati tramite l'API (vedi il Riferimento API), oppure invia un'email al supporto e ti aiuteremo.