Vai al contenuto

🔄 Rigenerazione delle Credenziali

Amazon ha aggiornato l'autenticazione delle Creators API passando a Login with Amazon (LwA). Le vecchie credenziali smettono di funzionare dopo l'11 settembre 2026: per continuare a usare le API sul BOT serve generare nuove credenziali (versione 3.0 o superiore) e riconfigurarle.

Chi ha già configurato le API riceve da Amazon una mail come questa:

Warning

Senza credenziali valide il BOT perde le funzioni legate alle Creators API: TAG {variations}, ottimizzazione della scadenza offerte e ottenimento prezzi. Le vecchie credenziali vanno sostituite prima della scadenza.

Note

La parte della mail su download e configurazione dell'SDK riguarda gli sviluppatori: al BOT non serve, ci pensa lui. A te servono solo ID, Segreto e Versione della nuova credenziale.

1. Genera le nuove credenziali

  1. Apri il pannello di affiliazione Amazon: https://programma-affiliazione.amazon.it/home.
  2. Dal menu laterale: Strumenti → CreatorsAPI.
  3. Sull'app esistente premi Aggiungi nuove credenziali (oppure Crea app se non ne hai).
  4. Copia ID, Segreto e versione mostrati.

Warning

Il Segreto è visibile una sola volta, al momento della creazione. Salvalo subito in un luogo sicuro: se lo perdi devi generare un'altra credenziale.

Note

Copia ID e Segreto per intero, a partire da amzn1 compreso.

Note

Annota la versione riportata accanto alle nuove credenziali (es. 3.1, 3.2, 3.3): serve nell'ultimo step di configurazione sul BOT.

2. Elimina le vecchie credenziali dal BOT

Il BOT tiene una sola credenziale per paese: prima di inserire le nuove devi rimuovere le vecchie.

  1. Vai in Impostazioni → API → Amazon Creators API.
  2. Premi ✏️ accanto alla bandiera del paese da aggiornare.
  3. Premi 🗑 Elimina configurazione API.
  4. Conferma l'eliminazione con 🗑 Elimina configurazione API.

Note

Finché la vecchia configurazione è presente, quel paese non compare nella lista di selezione del paese in fase di aggiunta.

3. Inserisci le nuove credenziali

  1. Sempre in Impostazioni → API → Amazon Creators API, premi ➕ Credenziali API.
  2. Seleziona il paese delle credenziali (deve coincidere con l'affiliazione su cui le hai generate).
  3. Invia come messaggio l'ID Credenziale.
  4. Invia come messaggio la Chiave Segreta.
  5. Invia il Partner ID (Store ID), quello in alto a destra nel programma di affiliazione, che termina con -numero (es. tag-21).
  6. Seleziona la Versione annotata al punto 1.

Se non compaiono errori, il BOT conferma con Configurazione Completata e riattiva le API per quel paese.

Passaggi in dettaglio nella guida di configurazione.

4. Verifica

  • Premi ✏️ accanto al paese e poi 🧪 Test API: deve rispondere senza errori.
  • Controlla che il pallino accanto alla bandiera sia verde (rosso = API in pausa per quel paese).
  • Ripeti la procedura per ogni paese in cui hai l'affiliazione configurata.

Note

Se gestisci più BOT, dopo aver inserito le nuove credenziali usa 📨 Copia su altri BOT... per replicarle senza rifare tutto a mano.

Problemi comuni

Messaggio Causa e soluzione
Configurazione Fallita Versione sbagliata, ID/Segreto incompleti o Partner ID non corrispondente al paese scelto. Ricontrolla i dati sul pannello Amazon.
Chiave Invalida ID o Segreto incollati parzialmente: devono partire da amzn1 e non contenere spazi.
Sessione Scaduta Procedura interrotta troppo a lungo: ricomincia da ➕ Credenziali API con le stesse credenziali.
Credenziali appena create che danno errore Amazon impiega qualche minuto ad attivarle: riprova più tardi.