# Amazon Creators API

Il BOT utilizza le Amazon Creators API configuate per migliorare l'ottenimento delle info dei prodotti, popolare l'eventuale TAG `{variations}` all'interno dei Post e migliorare la scadenza delle offerte.<br>

Si consiglia quindi di configurare sui BOT l'accesso API per migliorare l'esperienza d'uso: in questa guida si vedranno i passaggi necessari.

### Generazione delle credenziali

Il primo passo è generare le credenziali delle Amazon Creators API da utilizzare sui BOT:<br>

1. Collegarsi al pannello di affiliazione Amazon all'indirizzo <https://programma-affiliazione.amazon.it/home><br>

2. Dal menu laterale selezionare *Strumenti -> CreatorsAPI*<br>

3. Selezionare il pulsante "*Crea app*" ed inserire un nome a piacere per l'applicazione (ad esempio "api")<br>

4. Selezionare il pulsante "*Aggiungi nuove credenziali*", verranno visualizzate le credenziali da inserire sul BOT:

   <figure><img src="/files/ut49DRVW6Kx1x35vrEJ3" alt=""><figcaption></figcaption></figure>

5. Copiare le credenziali (ID, Segreto e versione) in un luogo sicuro per l'inserimento sul BOT.\
   **Nota:** assicurarsi di copiare l'ID e il segreto per intero, quindi a partire da "amzn1" compreso.

{% hint style="info" %}
Le stesse credenziali possono essere utilizzate su più BOT, ma sono valide solamente per il paese Amazon per le quali sono state generate.
{% endhint %}

### Configurazione sul BOT

Una volta generate le credenziali per le Creators API spostiamoci sul BOT per procedere alla sua configurazione:<br>

1. Dal BOT navigare in Impostazioni -> API -> Amazon Creators API<br>

2. Selezionare il pulsante "➕ Credenziali API"<br>

3. Selezionare il paese per il quale si stanno aggiungendo le credenziali\
   **IMPORTANTE:** il paese deve coincidere con il paese dell'affiliazione da dove si sono generate le credenziali<br>

4. Inviare come messaggio l'ID credenziale generato nella sezione precedente<br>

5. Inviare poi come messaggio il Segreto generato nella sezione precedente<br>

6. Inviare poi lo Store ID associato all'account dal quale si sono generate le credenziali\
   **Nota:** lo Store ID è visibile nella pagina del programma di affiliazione Amazon in alto a destra (*nello screenshot sotto è "tag-21"*)<br>

   <figure><img src="/files/DQZfNOMmKTXz1ooF9D91" alt=""><figcaption></figcaption></figure>

7. Selezionare la Versione delle API come riportata nella sezione precedente (*per l'Italia e l'Europa selezionare **3.2** o comunque il valore riportato accanto alla credenziale generata sul portale Amazon*)<br>

8. Fatto! Se non vengono visualizzati errori allora le API sono pronte per l'utilizzo.\ <br>

{% hint style="warning" %}
Assicurarsi che il pallino accanto alla bandiera del paese corrispondente sia **verde**: selezionandolo e facendolo diventare rosso è possibile mettere in pausa l'utilizzo delle API per il paese.
{% endhint %}

{% hint style="info" %}
E' possibile configurare le stesse credenziali su BOT diversi, gli utenti che dispongono di più BOT vedranno il pulsante "*Copia su altri BOT...*" disponibile nella tastiera per una copia veloce delle impostazioni
{% endhint %}

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dealsbot.io/amazon-creators-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.