Payload Referansı

Chattlebot'taki her webhook, varsayılan bir payload şablonuyla başlar — müşteri adayı, bot, konuşma ve bağlam hakkındaki tüm mevcut verileri içeren bir JSON yapısı. Bu şablon tüm platform şablonları (Zapier, n8n, Make ve Özel) tarafından paylaşılır. Varsayılan payload altı bölüm halinde düzenlenmiştir: üst düzey bir 'event' alanı (her zaman 'lead_captured'), bir 'timestamp' alanı ve beş iç içe nesne — 'lead' (ziyaretçi bilgileri), 'bot' (chatbot detayları), 'conversation' (mesaj sayısı, süre ve özet gibi sohbet verileri), 'context' (referrer, UTM parametreleri ve tarayıcı bilgisi) ve 'session' (oturum ve ziyaretçi kimlikleri). Bu şablonu yalnızca API'nizin ihtiyaç duyduğu alanları içerecek şekilde özelleştirebilir, yapıyı yeniden düzenleyebilir veya statik değerler ekleyebilirsiniz. Şablon, dinamik veriler için {{değişken}} sözdizimini kullanır — bu yer tutucular webhook tetiklendiğinde gerçek değerlerle değiştirilir.

Müşteri adayı değişkenleri, ziyaretçinin konuşma sırasında sağladığı tüm bilgileri içerir. {{lead.email}} müşteri adayının e-posta adresidir. {{lead.name}} müşteri adayının tam adıdır. {{lead.phone}} müşteri adayının telefon numarasıdır. {{lead.category}} otomatik algılanan veya manuel ayarlanan müşteri adayı kategorisidir (ör. 'pricing', 'support', 'demo'). {{lead.urgency}} aciliyet seviyesidir — 'low', 'medium' veya 'high' — konuşmanın AI analizi tarafından belirlenir. {{lead.sentiment}} algılanan duygudur — 'positive', 'neutral' veya 'negative'. Bot değişkenleri hangi chatbotun müşteri adayını oluşturduğunu tanımlar. {{bot.id}} benzersiz bot tanımlayıcısıdır. {{bot.name}} botun görünen adıdır. {{bot.url}} botun gömülü olduğu URL'dir.

Konuşma değişkenleri sohbet oturumunun kendisi hakkında veri sağlar. {{conversation.transcript}} tam konuşmayı mesaj dizisi olarak içerir, her mesajın bir rolü (user veya assistant) ve içeriği vardır. {{conversation.message_count}} toplam mesaj sayısıdır. {{conversation.duration_seconds}} konuşmanın saniye cinsinden ne kadar sürdüğüdür. {{conversation.started_at}} ve {{conversation.ended_at}} sohbetin ne zaman başladığı ve bittiği için ISO 8601 zaman damgalarıdır. {{conversation.summary}} konuşmanın AI tarafından oluşturulan kısa özetidir. Bağlam değişkenleri ziyaretçinin gezinme ortamını yakalar. {{context.referrer}} ziyaretçinin geldiği sayfa URL'sidir. {{context.user_agent}} tarayıcının user agent dizesidir. {{context.language}} tarayıcının dil ayarıdır (ör. 'tr-TR'). {{context.utm_source}} ve {{context.utm_campaign}} sayfa URL'sinden UTM izleme parametrelerini yakalar — müşteri adaylarını belirli pazarlama kampanyalarına atfetmek için kullanışlıdır.

Oturum değişkenleri belirli sohbet oturumunu tanımlar. {{session.id}} benzersiz sohbet oturumu tanımlayıcısıdır — webhook verilerini konuşma günlükleriyle ilişkilendirmek için kullanışlıdır. {{session.visitorId}} ziyaretçinin oturumlar arası kalıcı tanımlayıcısıdır — aynı ziyaretçi daha sonra geri döndüğünde aynı ziyaretçi kimliğine sahip olacak ancak yeni bir oturum kimliği alacaktır. Zaman damgası değişkenleri webhook'un tetiklendiği tam zamanı sağlar. {{timestamp}} geçerli zamanı ISO 8601 formatında verir (ör. '2025-01-15T10:34:05Z'). {{timestamp_unix}} aynı zamanı Unix zaman damgası olarak verir (epoch'tan beri geçen saniyeler) — sayısal zaman damgası bekleyen API'ler için kullanışlıdır. Toplamda, tüm kategorilerde 23 değişken mevcuttur. Tüm değişkenler URL, başlıklar ve payload şablonunda kullanılabilir.

Değişken ikamesi boşluk doldurma gibidir. Bir webhook tetiklendiğinde, Chattlebot payload şablonunuzu alır ve her {{değişken}} yer tutucusunu konuşmadaki gerçek değerle değiştirir. Örneğin {{lead.email}} 'jane@acme.com' olur ve {{lead.urgency}} 'high' olur. Değişkenler her yerde çalışır — URL'de (REST API'leri için kullanışlı, ör. /api/contacts/{{lead.email}}), özel başlıklarda (ör. X-Bot: {{bot.name}}) ve payload gövdesinde. Bir değişkenin değeri yoksa (örneğin ziyaretçi telefon numarası vermediyse), boş dizeye çözümlenir. Bu, JSON'unuzun {{değişken}} yer tutucusu yerine boş değer içereceği anlamına gelir — API'niz boş dizeleri düzgün şekilde ele almalıdır. Değişkenleri statik metin içinde de kullanabilirsiniz: '{{bot.name}} adlı bottan müşteri adayı, {{timestamp}}' şeklinde yazılır ve 'Sales Assistant adlı bottan müşteri adayı, 2025-01-15T10:34:05Z' olur.