Yanıt Eşleme

Yanıt eşleme, webhook'un JSON yanıtından belirli değerleri çıkarmanıza ve bunları adlandırılmış değişkenler olarak saklamanıza olanak tanır. Tüm ham yanıtla çalışmak yerine, yalnızca ihtiyacınız olan alanları seçersiniz. Örneğin, API'niz orderId, status, tracking number, estimated delivery, internal notes ve metadata içeren tam bir sipariş nesnesi döndürür. Yanıt eşleme ile üç basit kural yapılandırırsınız: 'data.orderId'yi 'orderId' olarak çıkar, 'data.status'u 'status' olarak çıkar ve 'data.eta'yı 'eta' olarak çıkar. Artık sisteminizin geri kalanı — iş akışları, AI yanıtları, sonraki eylemler — tüm JSON blobu yerine yalnızca bu üç temiz değeri görür. Bu, büyük veya derin iç içe geçmiş yanıtlar döndüren API'lerle çalışırken özellikle kullanışlıdır. Tam olarak ihtiyacınız olanı alırsınız, fazlasını değil.

Yanıt eşleme üç senaryoda gereklidir. İlk olarak, iş akışı adımlarında webhook verilerini kullanırken: bir webhook iş akışında yürütüldükten sonra, sonraki adımlar eşlenen değerlere değişken olarak erişebilir. Örneğin, bir müşteri adayı zenginleştirme API'sini çağırabilir ve ardından döndürülen şirket büyüklüğüne göre müşteri adayını yönlendirebilirsiniz. İkinci olarak, AI çağrılabilir webhook yanıtlarından belirli alanları çıkarırken: eşlenen veriler AI'ın kullanıcının sorusuna yanıt vermek için kullandığı şeydir. Hassas eşleme, AI'ın tam olarak ihtiyaç duyduğu veriyi alması anlamına gelir — ne fazla ne eksik. Üçüncü olarak, eylemleri zincirlerken: bir webhook'tan gelen veriyi diğerine aktarın. Örneğin, ilk webhook'la sipariş kimliği alın, ardından o sipariş kimliğini gönderim durumunu kontrol eden ikinci bir webhook'a iletin. Yanıt eşleme olmadan, çıkarılan değerler akış aşağı kullanım için yapılandırılmış değişkenler olarak kullanılamaz.

Her yanıt eşlemesinin üç alanı vardır. JSONPath alanı, yanıttan hangi değerin çıkarılacağını belirtir — kök olarak '$' ile başlayan JSONPath sözdizimini kullanır (ör. '$.data.orderId', data içinde iç içe geçmiş orderId alanını çıkarır). Değişken Adı alanı, çıkarılan değere atamak istediğiniz addır — bu, iş akışlarında ('webhook_' önekiyle) veya AI yanıtlarında kullanılabilir değişken adı olur. Kısa ve açıklayıcı tutun. Varsayılan Değer alanı isteğe bağlıdır — JSONPath hiçbir şeye çözümlenmezse (alan eksik veya null), bu yedek değer kullanılır. Bu, akış aşağı mantıkta null hatalarını önler. Tek bir webhook'a birden fazla eşleme ekleyebilirsiniz. Her biri aynı yanıttan farklı bir değer çıkarır. Örneğin, üç eşlemeniz olabilir: biri sipariş kimliği, biri durum ve biri tahmini teslimat tarihi — hepsi aynı API yanıtından çıkarılır.

JSONPath, JSON yanıtlarında gezinme sözdizimidir. İşte en yaygın kalıplar. '$.status' üst düzey bir alanı çıkarır — basit düz yanıtlar için kullanın. '$.data.results[0].id' iç içe bir nesneye girer, ardından dizideki ilk öğeyi alır ve 'id' alanını çıkarır — sonuçları data zarfına saran API yanıtları için kullanışlıdır. '$.items[*].name' dizideki her öğeden 'name' alanını çıkarır — değerler listesi döndürür. '$.meta.pagination.total' belirli bir değere ulaşmak için derin iç içe nesnelerde gezinir. '$' her zaman yanıtın kökünü temsil eder. Nesnelere girmek için noktalar, diziler için köşeli parantezler ve indeksler kullanın. '[*]' joker karakteri 'bu dizideki tüm öğeler' anlamına gelir. Çoğu API verileri tahmin edilebilir yapılarda döndürür, bu nedenle kalıbı belirledikten sonra eşleme basit hale gelir. İpucu: gerçek yanıt yapısını görmek için test webhook özelliğini kullanın, ardından gerçek verilere dayalı JSONPath ifadelerinizi yazın.

Eşlenen veriler bağlama göre farklı kullanılır. İş akışlarında, tüm eşlenen değişkenler otomatik olarak 'webhook_' öneki alır. Yani 'orderId' adlı bir değişkeni eşlediyseniz, sonraki iş akışı adımlarında 'webhook_orderId' olarak kullanılabilir hale gelir. Bu değişkenleri koşullarda (ör. webhook_revenue > 1000000 ise kurumsal satışa yönlendir), mesajlarda veya diğer eylemlere giriş olarak kullanabilirsiniz. AI çağrılabilir webhook'larda, yanıt eşleme yanıt filtrelemeyle birlikte çalışır. Dizi sonuçlarını daraltmak için önce filtre uygulanır, ardından eşlenen değerler AI'ın gördüğü ve yanıtını formüle etmek için kullandığı şeydir. Varsayılan değerler AI çağrılabilir webhook'lar için özellikle önemlidir — bir alan eksikse, varsayılan AI'ın null veri almasını önler, bu da kafa karıştırıcı yanıtlara yol açabilir. Pratik bir örnek: 'status' değişkenini 'bilinmiyor' varsayılanıyla eşlersiniz. API bir status alanı döndürmezse, AI yine de kullanıcıya hata vermek yerine 'Mevcut durum bilinmiyor' diyebilir.