Troubleshooting Automazioni

L'automazione non funziona come previsto? Questa guida ti aiuta a identificare e risolvere i problemi più comuni.

Diagnosi Rapida

Segui questo flusso per capire cosa non va:

L'automazione è ATTIVA?
├─ NO → Attivala dal toggle
└─ SÌ
   │
   Ha eseguito di recente? (controlla "Ultima esecuzione")
   ├─ NO → Aspetta il prossimo ciclo
   └─ SÌ
      │
      Ha pubblicato deal? (controlla "Deal pubblicati")
      ├─ SÌ → Funziona! Il problema è altrove
      └─ NO → Continua sotto ↓

Problemi Più Comuni

1. Canale Disconnesso

Sintomo: L'automazione gira ma non pubblica nulla. Stato canale: rosso/offline.

Cause:

• Il bot è stato rimosso dal canale Telegram
• Il bot non è più admin
• Il token del bot è scaduto

Soluzione:

2. Tag Amazon Mancante

Sintomo: Errore "MISSING_AMAZON_TAG" nei log o nessun deal pubblicato.

Cause:

• Non hai configurato il tag affiliato
• Il tag è stato eliminato
• Credenziali corrotte

Soluzione:

1. Vai su Impostazioni → Credenziali
2. Aggiungi o aggiorna il tuo Tag Amazon Affiliato
3. Formato corretto: tuonome-21
4. Salva e riattiva l'automazione

3. Nessun Deal Trovato

Sintomo: L'automazione gira ma "Esecuzioni vuote" aumenta.

Cause:

• Filtri troppo restrittivi
• Categoria con pochi prodotti
• Tutti i deal già pubblicati (deduplicazione)
• Score minimo troppo alto

Soluzione:

Se hai 3+ esecuzioni vuote consecutive, riceverai una notifica.

4. Limite Token Raggiunto

Sintomo: Messaggio "Monthly Keepa token limit exceeded".

Cause:

• Hai esaurito i token mensili per verificare i prodotti
• Ogni prodotto costa ~4 token per la verifica

Soluzione:

1. Controlla l'uso token in Dashboard → Uso Token
2. I token si resettano il 1° del mese
3. Riduci i deal per esecuzione per consumare meno
4. Considera l'upgrade del piano per più token

5. Troppi Automazioni Attive

Sintomo: Non riesci ad attivare una nuova automazione.

Limiti per piano:

Soluzione:

• Disattiva automazioni non necessarie
• Elimina quelle obsolete
• Fai upgrade del piano

6. Filtri Non Disponibili

Sintomo: Alcuni filtri sono bloccati o non funzionano.

Filtri per piano:

Soluzione: Fai upgrade per sbloccare filtri avanzati.

Errori di Connessione Telegram

"Invalid bot token"

Il token del bot non è valido.

Soluzione:

1. Vai su Telegram e parla con @BotFather
2. Usa /mybots → seleziona il tuo bot → API Token
3. Copia il nuovo token
4. Aggiornalo in Afflyt: Impostazioni → Canali → Modifica

"Bot not admin in channel"

Il bot non ha i permessi necessari.

Soluzione:

1. Apri il canale Telegram
2. Vai su Gestisci canale → Amministratori
3. Aggiungi il bot come admin
4. Abilita "Pubblica messaggi"

"Failed to send message"

Il canale potrebbe essere stato eliminato o ristretto.

Soluzione:

1. Verifica che il canale esista ancora su Telegram
2. Controlla che non sia stato ristretto
3. Riconnetti il canale in Afflyt

Errori di Validazione Wizard

Step 1: Setup

Step 2: Categorie

Step 3: Filtri

Step 4: Schedule

Step 5: Destinazione

Monitorare lo Stato

Ogni automazione mostra:

• Ultima esecuzione — Quando ha girato l'ultima volta
• Prossima esecuzione — Quando girerà di nuovo
• Esecuzioni totali — Quante volte ha girato
• Deal pubblicati — Totale deal inviati
• Esecuzioni vuote — Cicli senza pubblicazioni

Segnali di Allarme

Notifiche Email

Il sistema invia email automatiche per:

Checklist Pre-Lancio

Prima di attivare un'automazione, verifica:

• Tag Amazon configurato in Impostazioni
• Canale connesso e testato
• Bot è admin del canale Telegram
• Almeno 1 categoria selezionata
• Score minimo ragionevole (consigliato: 35-60)
• Preset schedule selezionato
• Piano supporta il numero di automazioni

Reset e Ricominciare

Se nulla funziona:

Contattare il Supporto

Se hai seguito tutti i passaggi e il problema persiste:

1. Prendi nota dell'ID automazione (visibile nell'URL)
2. Screenshot dello stato e degli errori
3. Descrivi cosa hai già provato

• Email: support@afflyt.io
• Community: Gruppo Telegram
• Aggiornamenti: Canale Afflyt