API İzinleri
AI SmartTalk'ın tam potansiyelini açığa çıkarmak için — siparişleri sorgulamak, ürün açıklamalarını güncellemek veya müşterileri yönetmek gibi — doğru izinlerle bir PrestaShop Webservice API anahtarı yapılandırmanız gerekir.
Bu adım, AI Actions (SmartFlow) kullanmak istiyorsanız gereklidir. Bunun olmaması durumunda, AI asistanınız senkronize edilmiş bilgiye dayalı soruları yanıtlayabilir, ancak gerçek zamanlı mağaza verilerine erişemez.
1. Webservisi Etkinleştirme
- Gelişmiş Parametreler > Webservis bölümüne gidin
- PrestaShop'un webservisini etkinleştirin
- Kaydet butonuna tıklayın
2. API anahtarı oluşturma
- Webservis sayfasında, Yeni webservis anahtarı ekle butonuna tıklayın
- Formu doldurun:
- Anahtar: Güvenli bir token oluşturmak için Oluştur butonuna tıklayın veya kendi anahtarınızı girin
- Anahtar açıklaması:
AI SmartTalk - Durum: Etkin
- Aşağıda açıklanan izinleri ayarlayın
- Kaydet butonuna tıklayın
API anahtarını kopyalayın ve kaydedin — AI SmartTalk'taki entegrasyonu yapılandırırken buna ihtiyacınız olacak.
3. Gerekli izinler
API anahtarınızın izinler bölümünde aşağıdaki kaynakları etkinleştirin:
| Kaynak | GET | PUT | POST | Açıklama |
|---|---|---|---|---|
| ürünler | Evet | Evet | — | Ürün detaylarını oku, açıklamaları ve SEO'yu güncelle |
| siparişler | Evet | — | — | Siparişleri referans veya müşteri ile sorgula |
| sipariş_detayları | Evet | — | — | Bir siparişteki ürünleri görüntüle |
| sipariş_durumları | Evet | — | — | Sipariş durumu etiketlerini oku |
| sipariş_geçmişleri | Evet | — | Evet | Durum geçmişini oku, durum değişiklikleri ekle |
| müşteriler | Evet | Evet | — | Müşteri bilgilerini sorgula ve güncelle |
| diller | Evet | — | — | Mevcut mağaza dillerini listele |
Yalnızca yukarıda listelenen izinleri kontrol edin. Diğer kaynaklara erişim vermenize gerek yoktur.
4. Her bir kaynağın ne için kullanıldığı
Ürünler (okuma + yazma)
- Okuma: Ürün detaylarını al — isim, açıklama, kısa açıklama, fiyat, referans, stok, SEO alanları (meta başlık, meta açıklama, meta anahtar kelimeler)
- Yazma: Ürün açıklamalarını, kısa açıklamaları ve SEO alanlarını tam çok dilli destek ile güncelle
Siparişler (sadece okuma)
- Bir siparişi referans numarası ile sorgula
- Belirli bir müşteri için siparişleri listele (e-posta ile)
- Bir müşteri için en son siparişi al
Sipariş Detayları (sadece okuma)
- Bir siparişteki ürünleri görüntüle: isim, referans, miktar, birim fiyat
Sipariş Durumları (sadece okuma)
- Her sipariş durumu için insan tarafından okunabilir etiketi al (örneğin, "Ödeme kabul edildi", "Gönderildi")
Sipariş Geçmişleri (okuma + oluşturma)
- Okuma: Bir siparişin durum değişiklikleri geçmişini görüntüle
- Oluşturma: Bir siparişe yeni bir durum değişikliği ekle (örneğin, gönderildi olarak işaretle), isteğe bağlı olarak müşteriye e-posta bildirimi ile
Müşteriler (okuma + yazma)
- Okuma: Bir müşteriyi e-posta veya ID ile sorgula — isim, e-posta, kayıt tarihi, bülten durumu, notları al
- Yazma: Müşteri bilgilerini güncelle (isim, soyisim, e-posta, notlar)
Diller (sadece okuma)
- Mağazanızda yapılandırılmış tüm dilleri listele (çok dilli ürün güncellemeleri için kullanılır)
5. API anahtarını AI SmartTalk'a girme
Webservis anahtarınız oluşturulduktan ve yapılandırıldıktan sonra:
- PrestaShop'taki AI SmartTalk modül yapılandırmasına gidin
- API anahtarı genellikle OAuth bağlantısı sırasında iletilir
- Güncellemeniz gerekiyorsa, AI SmartTalk kontrol panelinize gidin > Entegrasyon > PrestaShop ve Webservis token'ını güncelleyin
Çoklu site kurulumları için, her site bağımsız olarak kendi Webservice API anahtarına sahip olabilir.
Sonraki adımlar
- Mağaza verilerinizi senkronize edin — Ürün kataloğunuzu AI'ye gönderin
- AI'nın neler yapabileceğini görün — Mevcut eylemlerin tam referansı