AI Actions Reference

Doğru API izinleri ile bağlantı kurulduğunda, AI asistanınız PrestaShop mağazanızda gerçek zamanlı olarak aşağıdaki eylemleri gerçekleştirebilir. Bu eylemler SmartFlow iş akışlarında mevcuttur ve AI, müşterilerinizle olan konuşmalar sırasında da kullanılabilir.

---

Ürünler

Ürün Al

Bir ürünün tam detaylarını ID'si ile alın.

• Girdi: Ürün ID'si
• Döner: İsim, açıklama, kısa açıklama, referans, fiyat, stok miktarı, aktif durum, SEO alanları (meta başlık, meta açıklama, meta anahtar kelimeler)
• API izni: products (GET)

Ürün İçeriğini Güncelle

Bir ürünün açıklamasını ve/veya kısa açıklamasını, tam çok dilli destek ile güncelleyin.

• Girdiler: Ürün ID'si, açıklama (isteğe bağlı), kısa açıklama (isteğe bağlı), dil ID'si (isteğe bağlı — varsayılan mağazanın birincil dilidir)
• Döner: Güncellenen alanların listesi ile onay
• API izni: products (GET + PUT)

ipucu

AI, belirli bir dili güncellerken diğer dillerdeki içeriği korur. Örneğin, Fransızca açıklamayı güncellemek, İngilizce versiyonu etkilemez.

Ürün SEO'sunu Güncelle

Bir ürünün SEO alanlarını, çok dilli destek ile güncelleyin.

• Girdiler: Ürün ID'si, meta başlık (isteğe bağlı), meta açıklama (isteğe bağlı), meta anahtar kelimeler (isteğe bağlı), dil ID'si (isteğe bağlı)
• Döner: Güncellenen SEO değerleri ile onay
• API izni: products (GET + PUT)

---

Siparişler

Referansa Göre Sipariş Al

Belirli bir siparişi referans numarası (örn., ABCDEF123) kullanarak arayın.

• Girdi: Sipariş referansı
• Döner: Tarih, durum, toplam tutar, ödeme yöntemi, gönderim bilgileri ve ürünler listesi dahil tam sipariş detayları
• API izni: orders (GET), order_details (GET), order_states (GET)

E-posta ile Siparişleri Al

Belirli bir müşteri tarafından verilen tüm siparişleri alın.

• Girdiler: Müşteri e-posta adresi, limit (isteğe bağlı — varsayılan 10)
• Döner: Tam detaylarla siparişlerin listesi, toplam sayısı
• API izni: orders (GET), order_details (GET), order_states (GET), customers (GET)

Son Siparişi Al

Belirli bir müşteri için en son siparişi alın.

• Girdi: Müşteri e-posta adresi
• Döner: Tam detaylarla en son sipariş veya sipariş bulunamazsa null
• API izni: orders (GET), order_details (GET), order_states (GET), customers (GET)

Sipariş Durumunu Güncelle

Bir siparişin durumunu değiştirin (örn., gönderildi olarak işaretle, teslim edildi olarak işaretle).

• Girdiler: Sipariş ID'si, yeni sipariş durumu ID'si, e-posta bildirimi gönder (isteğe bağlı — varsayılan hayır)
• Döner: Yeni durum ile onay ve e-posta gönderilip gönderilmediği
• API izni: order_histories (GET + POST)

uyarı

Bir sipariş durumunu değiştirmek, sendEmail seçeneği etkinse müşteri e-posta bildirimlerini tetikleyebilir. Doğru durumun uygulandığından emin olun.

---

Müşteriler

Müşteri Al

Bir müşteriyi e-posta adresi ile arayın.

• Girdi: Müşteri e-posta adresi
• Döner: Müşteri ID'si, adı, soyadı, e-posta, doğum tarihi, bülten durumu, kayıt tarihi, notlar
• API izni: customers (GET)

Müşteri Güncelle

Bir müşterinin profil bilgilerini güncelleyin.

• Girdiler: Müşteri ID'si, adı (isteğe bağlı), soyadı (isteğe bağlı), e-posta (isteğe bağlı), notlar (isteğe bağlı)
• Döner: Güncellenen alanların listesi ile onay
• API izni: customers (GET + PUT)

---

Konfigürasyon

Dilleri Al

PrestaShop mağazanızda yapılandırılmış tüm dilleri listeleyin.

• Girdi gerekmiyor
• Döner: ID, isim ve ISO kodu (örn., fr, en, de) ile dillerin listesi
• API izni: languages (GET)

bilgi

Bu eylem, doğru dil ID'sinin kullanıldığından emin olmak için AI tarafından çok dilli ürün güncellemeleri gerçekleştirirken dahili olarak kullanılır.

---

Özet Tablosu

Eylem	Kategori	Okuma	Yazma
Ürün Al	Ürünler	Evet	—
Ürün İçeriğini Güncelle	Ürünler	Evet	Evet
Ürün SEO'sunu Güncelle	Ürünler	Evet	Evet
Referansa Göre Sipariş Al	Siparişler	Evet	—
E-posta ile Siparişleri Al	Siparişler	Evet	—
Son Siparişi Al	Siparişler	Evet	—
Sipariş Durumunu Güncelle	Siparişler	—	Evet
Müşteri Al	Müşteriler	Evet	—
Müşteri Güncelle	Müşteriler	Evet	Evet
Dilleri Al	Konfigürasyon	Evet	—

---

İlgili

• API Permissions — Gerekli Webservis izinlerini yapılandırın
• Webhooks & Skills — Bu eylemleri mağaza olaylarında otomatik olarak tetikleyin