API-behörigheter
För att låsa upp den fulla potentialen av AI SmartTalk — såsom att slå upp beställningar, uppdatera produktbeskrivningar eller hantera kunder — behöver du konfigurera en PrestaShop Webservice API-token med rätt behörigheter.
Detta steg är obligatoriskt om du vill använda AI Actions (SmartFlow). Utan det kan din AI-assistent fortfarande svara på frågor baserat på synkroniserad kunskap, men kommer inte att kunna få tillgång till realtidsbutiksdata.
1. Aktivera webbtjänsten
- Gå till Avancerade inställningar > Webbtjänst
- Aktivera PrestaShops webbtjänst
- Klicka på Spara
2. Skapa en API-nyckel
- På webbtjänstsidan, klicka på Lägg till ny webbtjänstnyckel
- Fyll i formuläret:
- Nyckel: Klicka på Generera för att skapa en säker token, eller ange din egen
- Nyckelbeskrivning:
AI SmartTalk - Status: Aktiverad
- Ställ in behörigheterna enligt beskrivningen nedan
- Klicka på Spara
Kopiera och spara API-nyckeln — du kommer att behöva den när du konfigurerar integrationen i AI SmartTalk.
3. Nödvändiga behörigheter
I behörighetsavsnittet för din API-nyckel, aktivera följande resurser:
| Resurs | GET | PUT | POST | Beskrivning |
|---|---|---|---|---|
| produkter | Ja | Ja | — | Läs produktdetaljer, uppdatera beskrivningar och SEO |
| beställningar | Ja | — | — | Slå upp beställningar efter referens eller kund |
| beställningsdetaljer | Ja | — | — | Visa produkter inom en beställning |
| beställningsstatusar | Ja | — | — | Läs etiketter för beställningsstatus |
| beställningshistorik | Ja | — | Ja | Läs statushistorik, lägg till statusändringar |
| kunder | Ja | Ja | — | Slå upp och uppdatera kundinformation |
| språk | Ja | — | — | Lista tillgängliga butiksspråk |
Kryssa endast för de behörigheter som anges ovan. Det finns ingen anledning att ge åtkomst till andra resurser.
4. Vad varje resurs används till
Produkter (läs + skriv)
- Läs: Hämta produktdetaljer — namn, beskrivning, kort beskrivning, pris, referens, lager, SEO-fält (meta titel, meta beskrivning, meta nyckelord)
- Skriv: Uppdatera produktbeskrivningar, korta beskrivningar och SEO-fält med full flerspråkig support
Beställningar (endast läsning)
- Slå upp en beställning med dess referensnummer
- Lista beställningar för en specifik kund (via e-post)
- Få den senaste beställningen för en kund
Beställningsdetaljer (endast läsning)
- Visa produkterna inom en beställning: namn, referens, kvantitet, styckpris
Beställningsstatusar (endast läsning)
- Hämta den läsbara etiketten för varje beställningsstatus (t.ex. "Betalning accepterad", "Skickad")
Beställningshistorik (läs + skapa)
- Läs: Visa statusändringshistorik för en beställning
- Skapa: Lägg till en ny statusändring till en beställning (t.ex. markera som skickad), med valfri e-postnotifikation till kunden
Kunder (läs + skriv)
- Läs: Slå upp en kund via e-post eller ID — hämta namn, e-post, registreringsdatum, nyhetsbrevsstatus, anteckningar
- Skriv: Uppdatera kundinformation (förnamn, efternamn, e-post, anteckningar)
Språk (endast läsning)
- Lista alla språk som är konfigurerade i din butik (används för flerspråkiga produktuppdateringar)
5. Ange API-nyckeln i AI SmartTalk
När din webbtjänstnyckel har skapats och konfigurerats:
- Gå till AI SmartTalk-modulens konfiguration i PrestaShop
- API-nyckeln överförs vanligtvis under OAuth-anslutningen
- Om du behöver uppdatera den, gå till din AI SmartTalk-instrumentpanel > Integration > PrestaShop och uppdatera webbtjänsttoken
För multi-site installationer kan varje webbplats ha sin egen webbtjänst API-nyckel konfigurerad oberoende.
Nästa steg
- Synkronisera dina butiksdata — Skicka din produktkatalog till AI
- Se vad AI kan göra — Fullständig referens för tillgängliga åtgärder