Harici ticaret senkronizasyonu

Genel Bakış

Kanallar ve entegrasyonlar → Harici ticaret (/tr/integrations/commerce), Shopify veya WooCommerce'da ödeme işlemini sürdürürken desteklenen verileri OrderInChat'e yansıtır. Widget, WhatsApp ve Instagram AI, otomasyonlar ve isteğe bağlı gönderim etiketleri yansıtılan verileri kullanır.

Bu entegrasyon, kaynak temayı klonlamaz ve harici ödeme işlemini değiştirmez.

Shopify Bağlantısı

OrderInChat, Shopify OAuth kullanır, böylece token'ları manuel olarak kopyalamanıza gerek kalmaz.

1. Shopify Partner kontrol panelinde Order in Chat adında bir uygulama oluşturun.
2. İzin verilen yönlendirme URL'leri kısmına https://app.orderinchat.com/api/store/commerce/shopify/oauth/callback geri çağırma URL'sini ekleyin.
3. Bu Yönetici API kapsamlarını verin: read_products, write_products, read_inventory, write_inventory, read_orders, read_customers, read_content, read_legal_policies, read_discounts, read_shipping, read_files, read_locales, read_locations, read_script_tags, write_script_tags.
4. OrderInChat'te Kanallar ve entegrasyonlar → Harici ticaret bölümüne gidin, Shopify'ı seçin, HTTPS mağaza URL'sini girin (örneğin https://your-store.myshopify.com) ve Shopify ile Bağlan butonuna tıklayın.
5. Shopify'da izinleri onaylayın. Otomatik olarak OrderInChat'e geri döneceksiniz. Ardından Bağlantıyı Test Et, Webhook'ları Kaydet ve Şimdi Senkronize Et butonlarına tıklayın.

Eğer OAuth kullanamıyorsanız, Manuel token ayarı bölümünü genişletin ve Yönetici API erişim token'ını ve özel uygulama API gizli anahtarını yapıştırın. API gizli anahtarı, Shopify webhook HMAC imzalarını doğrulamak için gereklidir. OrderInChat, kimlik bilgilerini şifreler ve bir daha asla göstermez.

Resmi kılavuzlar: Shopify özel uygulamaları ve Yönetici API erişim token'ları.

WooCommerce Bağlantısı

WordPress'te WooCommerce → Ayarlar → Gelişmiş → REST API bölümünü açın, yalnızca yansıtma senkronizasyonu için Okuma izni olan bir anahtar oluşturun veya Toplu Düzenleyici değişikliklerinin WooCommerce'e yazılması gerekiyorsa Okuma/Yazma izni verin ve HTTPS mağaza URL'sini, tüketici anahtarını ve tüketici gizli anahtarını girin. WordPress sayfalarını ve gönderilerini senkronize etmek için ayrıca bir WordPress kullanıcı adı ve Kullanıcılar → Profil bölümünden Uygulama Şifresi girin.

Resmi kılavuz: WooCommerce REST API.

Bazı barındırma hizmetleri HTTP Temel kimlik doğrulamasını reddeder. Bağlayıcı, WooCommerce isteklerini sorgu dizisi kimlik doğrulaması ile yeniden denemeyi deneyebilir; kimlik bilgileri günlüklerden gizlenir.

Senkronizasyon Davranışı

1. Bağlantıyı kaydedin ve test edin.
2. Webhook'ları Kaydet — harici mağazada ürün, sipariş ve müşteri değişikliklerini OrderInChat'e neredeyse gerçek zamanlı olarak bildiren abonelikler oluşturur. OrderInChat, bir webhook kaçırılma ihtimaline karşı değişiklikleri düzenli olarak da kontrol eder.
3. Yansıtılacak kaynakları seçin.
4. İlk senkronizasyonu başlatın.

Güvenlik için OrderInChat her webhook'u doğrular ve kaydetmeden önce verileri Shopify veya WooCommerce üzerinden yeniden kontrol eder. Düzenli kontroller, kaçırılan webhook'ları yalnızca Ticaret kaynağı olarak kullanma etkinleştirildiğinde yakalar. Webhook durumu bir hata gösteriyorsa ve bağlantı etkin değilse, kaynak mağazadaki değişikliklerden sonra Webhook'ları Kaydet ve Şimdi Senkronize Et kullanın; yalnızca Bağlantıyı Test Et ürünleri güncellemez. Tekrar eden güncellemeler kopya kayıtlar oluşturmaz.

Shopify varyant gönderim ağırlığı, Shopify'daki varyant ağırlığından alınır; ürün düzenleyici bunu mağazanın yapılandırılmış ağırlık biriminde gösterir. length, width veya height adındaki boyut metafield'ları santimetreye dönüştürülür. Shopify ürün açıklamaları ürünün kendi açıklamasından gelir, paylaşılan tema bölümleri veya afişlerden değil; tema metni, ürün özelinde bir açıklama haline gelmez. Taslak ve arşivlenmiş ürünler müşterilere gösterilmez.

Mağazanız harici ticaret kullandığında, müşteriler kaynak ürün URL'si üzerinden satın alır. OrderInChat sepet ödemesi ve WhatsApp ödeme akışları o mağaza için kapatılır.

Envanter Lokasyonları

Shopify lokasyonları ve varyant başına envanter seviyeleri, OrderInChat depo/lokasyon kayıtlarına yansıtılır. Ürün ve varyant stokları, sohbet ve ödeme için tüm lokasyonların toplamını gösterir. WooCommerce çekirdek, toplam bir stok değerini açığa çıkarır, bu nedenle varsayılan sanal bir lokasyona yansıtılır; WooCommerce eklentilerinden gelen çok lokasyonlu stok, desteklenen bir eklenti gerektirir.

Katalog → Envanter altında kendi OrderInChat lokasyonlarınızı ekleyebilirsiniz. Toplu Düzenleyici stok hücreleri, lokasyona göre genişler. Shopify'a envanter göndermek yalnızca seçilen lokasyonu günceller ve write_inventory kapsamını gerektirir. Kilitli stok alanları, daha sonraki bir envanter senkronizasyonu ile üzerine yazılmaz.

Gönderim Etiketleri

OrderInChat gönderim etiketleri varsayılan olarak kapalıdır. Yalnızca etiketlerin tek bir yerden, OrderInChat'ten oluşturulmasını istiyorsanız etkinleştirin. Etkinleştirilse bile, harici sipariş zaten bir yerine getirme veya takip bilgisine sahipse OrderInChat etiket satın almaz.

Widget Snippet'i

Shopify: Webhook'ları Kaydet, ayrıca sohbet widget'ını Shopify mağazanıza otomatik olarak yüklemeye çalışır. Gerekirse, snippet'i Özel Liquid'e yapıştırabilirsiniz. Otomatik yükleme başarısız olursa özel uygulamada write_script_tags izni verin.

WooCommerce: REST API tema betiklerini enjekte edemez. Entegrasyon sayfasından JavaScript veya PHP snippet'ini tema altbilgisine veya functions.php dosyasına kopyalayın.

Sayfalar → Bilgi Tabanı

Sayfalar ve gönderiler etkinleştirildiğinde, Shopify sayfaları/makaleleri/politikaları ve WooCommerce sayfaları/gönderileri OrderInChat Bilgi Tabanı'na eklenir ve AI yanıtları için kullanılabilir. Eşleşen Shopify politika başlıkları, iade/şartlar vitrin alanlarını da doldurur. Bu, tam bir tema/CMS klonu değildir.

API Sınırlamaları

Entegrasyon, değerleri icat etmek yerine desteklenmeyen veya mevcut olmayan verileri rapor eder. Yaygın sınırlamalar şunlardır:

• Shopify, Yönetici API aracılığıyla tüm ödeme ayarlarını açığa çıkarmaz.
• Taşıyıcı hesaplamalı gönderim fiyatları, harici ödeme işleminde hesaplanmaya devam eder.
• WooCommerce REST, bir WordPress Uygulama Şifresi olmadan WordPress sayfalarını içermez.
• İncelemeler ve rezervasyonlar, bu kaynakları açığa çıkaran bir platform veya uygulama API'si gerektirir.
• Ürün eklentileri, yalnızca kaynak API gerçek bir eşdeğerine sahip olduğunda yansıtılır.