Shopify ve WhatsApp: Doğru Yapmamız 6 Ay Süren Entegrasyon

Entegrasyonun gerçekte neleri kapsadığı

Uygun bir Shopify-WhatsApp entegrasyonu tek bir şey değildir. Her iki yönde güvenilir şekilde çalışması gereken bir dizi veri akışıdır. Shopify'dan WhatsApp'a: sipariş onay mesajları, kargo güncellemeleri, teslimat bildirimleri, iade onayları ve terk edilmiş sepet tetikleyicileri. WhatsApp'tan Shopify'a: müşteri tarafından başlatılan sipariş aramaları, Shopify iade nesnesi oluşturması gereken iade talepleri ve canlı katalogdan çekilmesi gereken ürün sorguları.

Bunun yanı sıra, AI'nın "mavi kurtada hangi bedenler var?" sorusunu müşterinin WhatsApp'ı terk edip web sitesine gitmek zorunda kalmadan yanıtlayabilmesi için ürün katalogunun WhatsApp konuşmasında erişilebilir olması gerekir. Bu, stok değiştikçe güncel kalan bir katalog senkronizasyonu gerektirir.

Sizi yavaşlatan yaygın tuzaklar

Birinci tuzak webhook güvenilirliğidir. Shopify, sipariş olayları gerçekleştiğinde webhook'ları tetikler: sipariş verildi, sipariş gönderildi, sipariş teslim edildi, iade oluşturuldu. Ancak webhook'lar başarısız olabilir. Alıcı taraftaki teslimat sistemi yeniden denemeleri, tekilleştirmeyi ve hata günlüğünü işlemelidir. Çoğu geliştirici önce mutlu yolu oluşturur ve bir müşteri kargo bildirimini hiç almadığını şikâyet ettiğinde altı hafta sonra hata modlarını keşfeder.

İkinci tuzak sipariş numarası formatı uyuşmazlıklarıdır. Shopify sipariş kimlikleri sayısaldır. Markanız müşterilere #RL-2847 gibi biçimlendirilmiş bir sipariş numarası gösterebilir. Müşteriler önlerindeki hangi formatı kullanırlarsa kullansınlar, sistem her iki formatla aramayı işleyebilmelidir.

Üçüncü tuzak WhatsApp şablonu onay gecikmesidir. Bir müşteri mesajına doğrudan yanıt olmayan her giden WhatsApp mesajı önceden onaylanmış bir şablon gerektirir. Meta'nın onay süreci 24 ila 72 saat sürer ve ilk gönderimde reddedilmeler yaygındır. Bu bir planlama sorunudur: şablonları erken, lansmandan önceki hafta değil, göndermeniz gerekir.

İlk üç ay için üçüncü taraf bağlayıcı kullandık. Shopify API'sini her güncellediğinde bir şey bozuldu. Native entegrasyona geçtik ve bakım yükü neredeyse sıfıra düştü.

Üçüncü taraf bağlayıcılara karşı native entegrasyonun neden önemli olduğu

Shopify-WhatsApp entegrasyonu için üçüncü taraf bağlayıcılar boldur ve çoğunlukla ucuzdur. Basit kullanım durumları için iyi çalışırlar: sipariş onayı ve kargo bildirimi mesajları göndermek. Ancak daha karmaşık şeyler için çökerler.

Bağlayıcıların özel sorunu, tam Shopify veri modelini AI katmanına açmamasıdır. Bir bağlayıcı kargo bildirimi gönderebilir. "Geçen ay sipariş ettiğim ürün için iade penceresi nedir?" sorusunu yanıtlayamaz çünkü müşteri verilerine bağlı sipariş verilerine bağlı bağlamsal ürün verilerine sahip değildir.

Native entegrasyon, AI'nın tam sipariş nesnesine, müşteri nesnesine, ürün nesnesine ve yerine getirme nesnesine canlı erişime sahip olduğu anlamına gelir. Bu bağlam, yalnızca bildirim gönderimini değil, gerçekten yararlı konuşmaları mümkün kılan şeydir.

Katalog senkronizasyonu nasıl çalışır (ve ne ters gider)

WhatsApp Commerce, konuşmalarda erişilebilir bir ürün katalogu yüklemenize olanak tanır. Katalog, Meta Commerce API aracılığıyla senkronize edilir. Her ürün için bir başlık, açıklama, fiyat, görsel URL'si ve Shopify SKU'nuza eşleyen benzersiz bir içerik kimliği gerekir.

Senkronizasyon, stok değişikliklerinize ayak uyduracak bir programa göre çalışmalıdır. Çoğu D2C markası için iki ila dört saatte bir senkronizasyon yeterlidir. Flaş indirimler veya sınırlı sürümler yapan markalar için gerçek zamanlıya yakın senkronizasyon kritiktir. Üç saattir stokta olmayan bir ürünü sunan bir WhatsApp botundan daha hızlı güven zedeleyecek bir şey yoktur.

En yaygın katalog senkronizasyon hatası görsel URL çürümesidir. Shopify'daki ürün görsellerinin CDN URL'leri vardır. Shopify'da bir ürün görselini değiştirdiğinizde eski URL bozulur. Katalog senkronizasyonu yeni URL'yi almıyorsa WhatsApp katalogu bozuk görseller gösterir. Çözüm, URL'leri statik olarak depolamak yerine senkronizasyon zamanında Shopify ürün nesnesinden görselleri çekmektir.

Yeniden başlasaydık farklı yapacaklarımız

Mutlu yoldan önce hata işlemeyi inşa ederdik. Her webhook uç noktası, her API çağrısı, her katalog senkronizasyon işi üretime geçmeden önce günlük kaydı ve uyarıya sahip olmalıdır. Bir müşteri şikâyetinden üç gün sonra bir senkronizasyon hatasını keşfetmek çözülebilir bir sorundur, ancak bu, gerçekleştikten beş dakika sonra izleme panonuza yakalamaktan çok daha streslidir.

Ayrıca tüm WhatsApp şablonlarını projenin son haftasında değil, ilk haftasında gönderdik. Onay zaman çizelgesi sizin kontrolünüzde değildir. Diğer her şey bekleyebilir. Şablonlar bekleyemez.