Shopier

Bu rehberde: Shopier hesabınızı bir kişisel erişim anahtarı (PAT) ile bağlarsınız. Her yeni sipariş bir iş akışı başlatır (teşekkür mesajı, dijital ürün teslim e-postası, değerlendirme isteği); akış içinden siparişleri ve ürünleri okuyabilirsiniz.

⏱ 10 dakika

Kimlik kartı#

Ne işe yarar?#

Tetikleyici: Order created – mağazanızda yeni sipariş oluştuğunda. Akış şu alanlarla başlar:

orderId, status (ödeme durumu: paid / unpaid), paymentStatus, fulfillmentStatus (unfulfilled / fulfilled), total, subtotal, shippingTotal, discountTotal, currency, buyerName, buyerEmail, buyerPhone (+90… biçiminde), city, district, items (name, quantity, price, type – digital / physical), productName (ilk ürün), paymentMethod, note, createdAt, raw.

Shopier kutusunun işlemleri (hepsi okuma):

Ön koşullar#

• Bir Shopier satıcı hesabı.
• Hesapta iki adımlı doğrulama (2FA) açık olmalı; Shopier 2FA olmadan erişim anahtarı üretmez.

Adım adım kurulum#

A) Shopier'de kişisel erişim anahtarı#

1. Shopier hesabınıza girin → Hesap → Kişisel Erişim Anahtarı (Personal Access Token) bölümü.
2. Anahtara bir ad verin (OrqLabs) → Oluştur.
3. Anahtar yalnızca bir kez gösterilir; hemen kopyalayın. Bu anahtar hesabınıza tam erişim verir – yalnızca OrqLabs'a girin, başkasıyla paylaşmayın.

B) OrqLabs'ta bağlama#

1. Entegrasyonlar → Shopier → Bağla → Proje seçin.
2. Kişisel erişim anahtarı (PAT) alanına anahtarı yapıştırın → Bağla.

Bağlantı kurulunca OrqLabs, Shopier API'si üzerinden order.created webhook'unu kendi adresine otomatik kaydeder ve Shopier'in döndürdüğü imza anahtarını saklar. Shopier panelinde ayrıca bir şey yapmanız gerekmez. Kayıt başarısız olursa entegrasyon kartında Webhook kaydı başarısız: … uyarısı görünür; anahtarı kontrol edip entegrasyonu silerek yeniden bağlayın.

Örnek iş akışları#

1) Sipariş sonrası teşekkür (WhatsApp)#

1. Entegrasyon olayı – SHOPIER · Order created.
2. Eğer – {{ $json.paymentStatus }} eşittir paid.
3. Metin üret – {{ $json.buyerName }} adlı müşterimize {{ $json.productName }} siparişi için samimi, kısa bir teşekkür mesajı yaz.
4. Mesaj gönder – WhatsApp, alıcı {{ $node["Entegrasyon olayı"].json.buyerPhone }}, onaylı sipariş şablonuyla.

2) Dijital ürün teslim e-postası#

Entegrasyon olayı (SHOPIER · Order created) → Eğer ({{ $json.items[0].type }} eşittir digital) → E-posta gönder (alıcı {{ $json.buyerEmail }}, indirme bağlantısı ve kullanım notları).

3) Değerlendirme isteği#

Entegrasyon olayı → Bekle (10 gün) → E-posta gönder ("Siparişinizden memnun kaldınız mı?" + Shopier ürün sayfası bağlantısı – Shopier → List products çıktısındaki url).

İYS ve izin: Sipariş onayı, teslimat ve teşekkür mesajları işlemseldir. Kampanya, indirim kodu veya yeni ürün duyurusu içeren mesajlar ticari elektronik ileti sayılır; Türkiye'de tüketicilere göndermeden önce alıcının onayı alınmış ve İYS'ye kaydedilmiş olmalıdır (İYS kutusunun Query consent işlemiyle akışta kontrol edebilirsiniz). WhatsApp'ta pencere dışı mesajlar için Meta onaylı şablon gerekir.

Tetikleyici nasıl çalışır?#

• Shopier teslimatları webhook oluşturulurken verilen anahtarla imzalar (Shopier-Signature, HMAC-SHA256). İmza doğrulanırsa sipariş gövdesi doğrudan kullanılır.
• İmza doğrulanamazsa OrqLabs teslimatı reddetmez; siparişi Shopier API'sinden yeniden okur (GET /orders/{id}) ve yalnızca API'nin döndürdüğü veriyi kullanır. Bu yolda yalnızca son 3 gün içinde oluşturulmuş siparişler akış başlatır (eski siparişlerin tekrar gönderilmesine karşı).
• Shopier 5 saniye içinde 200 bekler; alamazsa 72 saate yayılan 9 denemeyle yeniden gönderir. Aynı sipariş için tekrar gelen teslimatlar ikinci kez akış başlatmaz.

Limitler#

Bağlantıyı test etme#

Bağlantıyı test et mağaza sahibi bilgisini (GET /shop/owner) okur ve hesap adını gösterir. Webhook'u denemek için mağazanızda küçük tutarlı bir test siparişi verin ve iş akışının Çalıştırmalar sekmesine bakın.

Kimlik bilgilerini yenileme#

Shopier'de yeni bir PAT üretin → OrqLabs'ta ayrıntı panelinde Kimlik bilgileri → Güncelle → yeni anahtar → Kaydet. Eski anahtarı Shopier'den silin. Webhook'u yeniden kaydetmek için entegrasyonu silip yeniden bağlayın.

Sık karşılaşılan hatalar#

Sonraki adım#

• iyzico
• ikas
• Entegrasyonlara genel bakış