Workflow WebhooksWorkflow Webhooks
Customer.io'yu Shopify Flow'a nasıl bağlayabilirim?

Customer.io'yu Shopify Flow'a nasıl bağlayabilirim?

Sayfayı kopyala

Customer.io raporlama webhook'larını HMAC doğrulamasıyla Shopify Flow'a bağlayın. Bounce, açılma veya abonelik iptalinde etiket, not ve meta alan ekleyin.

Customer.io, gönderdiği mesajlarla ilgili bilgileri (teslimatlar, açılma sayıları, tıklamalar, geri dönen mesajlar, abonelik iptalleri) bir raporlama webhook’u aracılığıyla geri bildirir. Workflow Webhooks, bu çağrıyı bir Shopify Flow tetikleyicisine dönüştürür; böylece mağazanız buna tepki verebilir: bir müşteriye etiket ekleyebilir, sipariş notu ekleyebilir, dahili e-posta gönderebilir, meta alanı güncelleyebilir - kısacası Shopify Flow'un yapabileceği her şeyi yapabilir.

Bu kılavuz, tüm süreci ortaya koymaktadır: Customer.io gönderir, Workflow Webhooks alır ve doğrular, Shopify Flow harekete geçer; her istekte Customer.io’nun HMAC imzası kontrol edildiğinden, iş akışınızı yalnızca Customer.io başlatabilir.

Neler yapabileceğiniz

  • E-posta adresi “hard bounce” hatası veren bir Shopify müşterisini etiketleyin; böylece kampanyalar bu kişiyi hedef almayı durdursun.
  • Son işlem tarihini bir meta alan olarak müşteri kaydına girin.
  • Bir VIP müşteri aboneliğini iptal ettiğinde ekibinize e-posta gönderin.

Gönderilebilecek tipik olaylar: email_delivered, email_opened, email_bounced, customer_unsubscribed.

Başlamadan önce

  • Shopify mağazanıza kurulan Workflow Webhooks.
  • Shopify Flow, Shopify Uygulama Mağazasından ücretsiz olarak indirilip kuruldu.
  • Webhook oluşturma iznine sahip bir Customer.io hesabı.

1. Adım - Workflow Webhooks'ta webhook'u oluşturun

  1. Workflow Webhooks'u açın -> Webhooks -> Webhook oluştur seçeneğine tıklayın ve Shopify Flow'da kolayca tanıyabileceğiniz bir ad verin; örneğin Customer.io events gibi.
  2. Kimlik Doğrulama bölümünden HMAC'yi seçin.
  3. Signature provider (İmza sağlayıcısı) altında **Customer.io’**yu seçin. Uygulama, başlığı, algoritmayı, imzalanmış yükü ve tekrar oynatma süresini sizin için otomatik olarak doldurur; yapılandırmanız gereken başka bir şey yoktur.
  4. Şimdilik gizli alanı boş bırakın ve Kaydet'e tıklayın. Sayfada gösterilen webhook URL'sini kopyalayın.

Diğer kimlik doğrulama modları için Kimlik Doğrulama’a, hangi alanların Shopify Flow’a aktarılacağını seçmek için ise Yük haritalama ve Shopify Flow değişkenleri’a bakın.

2. Adım - Customer.io'ya uç noktayı ekleyin

Customer.io'da Ayarlar -> Çalışma Alanı Ayarları -> Raporlama Webhook'ları bölümünü açın, kopyaladığınız URL ile bir webhook ekleyin ve imzalama anahtarını kopyalayın.

Customer.io imza gizli anahtarınızı nasıl bulabilirsiniz?

Raporlama webhook’unun imza anahtarı.

Customer.io'nun webhook imzalarıyla ilgili kendi belgeleri, hesabınız için tam metni ve ekran görüntülerini içermektedir.

Bu gizli anahtarı, Workflow Webhooks'taki webhook'un Secret alanına yapıştırın ve kaydedin. O andan itibaren her Customer.io gönderimi, Shopify Flow'a ulaşmadan önce doğrulanır.

Bu kontrolün amacı

Ne Değer
İmza başlığı X-CIO-Signature
İmzanın bulunduğu yer Başlığın tamamı
Neyin imzalandığı v0:{timestamp}:{body}
İmza HMAC-SHA256, onaltılık kodlanmış
Zaman damgası X-CIO-Timestamp başlığı, Unix saniyesi cinsinden
Tekrar oynatma koruması Yok - bu gönderen zaman damgasını imzalamadığından, tüm geçerli imzalar geçerliliğini korur
Sır Düz metin olarak kullanılır. Göndericinin gösterdiği şekilde aynen yapıştırın.

İmzalı yükte, {body}, bayt bayt ham istek gövdesi; {timestamp} ise yukarıdaki zaman damgasıdır.

Bu koşullardan herhangi birini karşılamayan bir istek, 401 hatasıyla reddedilir, Geçmiş ve sorun giderme bölümüne kaydedilir ve hiçbir zaman bir iş akışını başlatmaz.

3. Adım - Shopify Flow iş akışını oluşturun

  1. Shopify Flow'da bir iş akışı oluşturun ve Workflow Webhooks tetikleyicisini seçin.
  2. Olayları Kaydet seçeneğine basın, ardından Customer.io’dan bir test olayı gönderin (veya Workflow Webhooks bölümündeki Test Gönder seçeneğini kullanın), böylece Shopify Flow verilerinizin yapısını öğrenebilir.
  3. Sahip olduğunuz her webhook aynı Shopify Flow tetikleyicisini çalıştırır; bu nedenle, bu iş akışını yalnızca Customer.io ile sınırlı tutmak için **webhook **kimliğine ilişkin bir ilk koşul ekleyin. Kimlik, webhook sayfasında gösterilir.
  4. İşlemlerinizi ekleyin - bir müşteriyi etiketleyin, bir not ekleyin, şirket içi bir e-posta gönderin, bir meta alanı güncelleyin.
Shopify Flow
Shopify Flow'da “Bir tetikleyici seç” seçeneğini seçin, Workflow Webhooks bölümünü açın ve “Webhook Tetikleyicisi”ni seçin.
Bir Shopify Flow koşulu: Webhook kimliği, bir webhook’un kimliğine eşittir
Her iş akışının ilk adımı: webhook kimliğine ilişkin bir koşul; böylece iş akışı yalnızca bu webhook için çalıştırılır.
Tamamlanmış iş akışı: Webhook Tetikleyicisi, webhook kimliğine ilişkin bir koşul, ardından “Doğru” dalında dahili e-posta gönderme
Tamamlanmış iş akışı: tetikleyici, webhook kimliğine dayalı koşul ve ardından “True” dalında gerçekleştirilecek eyleminiz.

4. Adım - Baştan sona test edin

Customer.io'da gerçek bir olayı tetikleyin. Workflow Webhooks → History bölümünde, durumu Success olan bir çağrı görmelisiniz. İmza yanlışsa, bunun yerine nedeni belirtilen bir hata kaydı alırsınız ve İmzalı webhook'ların doğrulanması, hangi adımın başarısız olduğunu tam olarak gösteren imza denetleyicisini açıklar.

Tarih bölümünde, istek başlıkları, veri yükü, durum, süre ve tanımlayıcılarıyla birlikte bir çağrı açıldı
Tarih bölümünde gerçekleştirilmiş bir olay: “Başarılı” durumu, Shopify Flow’un bunu kabul ettiği anlamına gelir.
İmza uyuşmuyor

Şu sırayla: gizli anahtar (en yaygın neden - fazladan bir boşluk ya da yanlış ortamdan gelen bir anahtar), gönderenin farklı bir uç noktanın gizli anahtarını kullanıp kullanmadığı ve Customer.io ile uygulama arasında gövdeyi yeniden yazan herhangi bir unsur olup olmadığı. İmzalar ham baytları kapsadığından, JSON’u yeniden biçimlendiren bir proxy bunları bozar. Webhook sayfasındaki imza test aracı, imzalanmış olan metnin tam halini gösterir.

Her istekte 401 hatası alıyorum

Webhook’un kimlik doğrulama ayarının HMAC olarak ayarlandığını, Customer.io sağlayıcısının seçili olduğunu, gizli anahtarın girildiğini ve Customer.io’nun, sondaki kod da dahil olmak üzere, uygulamanın gösterdiği şekilde tam olarak bu URL’ye veri gönderdiğini kontrol edin.

Geçmiş'te hiçbir şey görünmüyor

İstek hiç ulaşmadı. Customer.io'daki URL'yi tekrar kontrol edin ve Customer.io'nun kendi teslimat günlüğüne bakarak aldığı yanıtı inceleyin. 404 kodu, webhook'un yanlış veya silinmiş olduğunu; 429 kodu ise planınızın çağrı sınırını aştığınızı gösterir - bkz. Planlar ve kullanım.

İş akışı yanlış olaylar için çalışıyor

Mağazanızdaki her webhook, aynı Shopify Flow tetikleyicisini çalıştırır. İş akışının ilk adımı olarak **webhook **kimliğine bir koşul ekleyin ya da Customer.io’dan gönderdiğiniz olayları daraltın.

İlgili