Giizo'nun webhook'u gelen yöndedir: dış bir sistem (pazaryeri, e-ticaret altyapısı, destek yazılımı, kamera sistemi) Giizo'nun verdiği adrese bir istek atar, asistanınız o olayla çalışmaya başlar.
Bu ekran Ayarlar altında değildir. Webhook, Akıllı Otomasyon altındakiolay bazlı tetikleyicidir: sol menüdenAkıllı Otomasyon → Tetikleyiciler.
Zamanlı tetikleyiciler, görev ekleme ve otomasyonun geneli ayrı bir rehberde: Akıllı Otomasyon Nasıl Kullanılır? Bu sayfa yalnızca webhook tarafını anlatır.
Başlamadan önce
Tetikleyici oluşturmak için hesabınızda geçerli bir API anahtarı bulunmalıdır. YoksaYeni Tetikleyici düğmesine bastığınızda "API Anahtarı Gerekli" uyarısı çıkar ve sizi anahtar oluşturma ekranına yönlendirir. Anahtar yönetimi: API Anahtarı Oluşturma ve Kullanımı.
Tetikleyici sayısı ve webhook tetikleyici sayısı plana bağlıdır. Tetikleyiciler ekranındaki limit kartları mevcut kullanımınızı ve kalan hakkınızı gösterir.
Webhook tetikleyicisi oluşturma
- Sol menüden Akıllı Otomasyon → Tetikleyiciler ekranını açın veYeni Tetikleyici'ye basın.
- Temel Bilgiler bölümünde tetikleyiciye bir ad verin ve hangi asistanın çalışacağını seçin. Açıklama isteğe bağlıdır.
- Tetikleyici Türü bölümündeOlay Bazlı'yı seçin. Bunu seçtiğinizdeWebhook Ayarları bölümü açılır.
- Webhook Kaynağı'nı seçin — bu alan zorunludur.
- Bir Güvenlik Türü belirleyin (aşağıda).
- Gerekiyorsa Beklenen Yanıt Kodu veYeniden Deneme Sayısı alanlarını ayarlayın.
- Kaydet'e basın.
Webhook adresi ancak kaydettikten sonra üretilir. Formu ilk kez doldururken ekranda bir adres göremezsiniz; kaydedip tetikleyiciyi düzenlemeye döndüğünüzde Webhook Ayarları başlığının altında https://api.giizo.ai/webhook/<token> biçiminde çıkar ve yanındaki düğmeyle kopyalanır. Bu adresi dış sisteme siz tanımlarsınız.
Webhook kaynağı
Kaynak alanı, gelen verinin nasıl yorumlanacağını belirler; adres aynı olsa da payload'ın ayrıştırılması kaynağa göre değişir. Listedeki seçenekler: Trendyol, Shopify, Zendesk, Mailgun, Hikvision, WhatsApp, Instagram ve Diğer. Kendi yazdığınız bir sistemden istek atacaksanızDiğer'i seçin.
Güvenlik türü
Adres tahmin edilmesi zor bir token taşır, ama adresi bilen herkes tetikleyiciyi çalıştırabilir. Bu yüzden bir doğrulama yöntemi seçmeniz önerilir:
Tür
Ne girersiniz
Dış sistem ne gönderir
Yok
—
Doğrulama yapılmaz
API Key
Başlık adı (örn. X-Api-Key) ve değeri
Aynı başlığı ve değeri
Basic Auth
Kullanıcı adı ve şifre
HTTP Basic kimlik bilgisi
Özel Header
İstediğiniz sayıda ad/değer çifti
Aynı başlıkları
Tetikleyici çalıştığında ne olacağını tanımlayın
Tetikleyici tek başına yeterli değildir: çalıştığında asistanın ne yapacağını da söylemeniz gerekir. İki seçenek var ve en az birini doldurmanız zorunludur:
- Asistan Mesaj Ayarları altındakiKullanıcı Mesajı alanına asistana verilecek metni yazmak. İsterseniz birSistem Mesajı da ekleyebilirsiniz.
- Kaydettikten sonra açılan Görevler sekmesinden görev eklemek. Görev türleri Veri Çekme, Veri Gönderme ve LLM İşleme'dir; bir dış sisteme geri bildirim göndermek istiyorsanızVeri Gönderme görevi kullanılır. Ayrıntı: Görev Şablonları Nasıl Oluşturulur?
İkisi de boşsa tetikleyici çalıştığında hata verir; form bu durumda sizi uyarır.
Bildirim Ayarları bölümü müşteriye değil size bakar: tetikleyici çalıştığında mobil bildirim, e-posta veya web bildirimi alabilirsiniz. Gerek yoksaYok'ta bırakın.
Son olarak sayfanın üstündeki Durum anahtarınıAktif konumuna alın; pasif bir tetikleyici gelen isteklerle çalışmaz.
Dış sistem ne göndermeli
Adrese Content-Type: application/json başlığıyla bir POST isteği atılır. Gövde JSON'dur ve panelin varsayılan örneği şu biçimdedir:
curl -X POST "https://api.giizo.ai/webhook/<token>" \
-H "Content-Type: application/json" \
-d '{"event_type":"test_event","message":"Test mesajı","data":{"key1":"value1"}}'
event_type olayın adı, message asistana iletilecek metin, data ise olayla ilgili ek alanlardır. Güvenlik türü seçtiyseniz ilgili başlığı da eklemeniz gerekir.
İstek başarılı olduğunda uç nokta 200 ve bir oturum kimliği döner. Token tanınmazsa 404, işleme sırasında hata olursa 500 alırsınız. Uç noktada hız sınırı vardır; art arda çok istek gönderen sistemler geçici olarak kısıtlanır.
Test etme
Testi tetikleyicinin detay sayfasından yapın: Tetikleyiciler listesinden tetikleyiciye girin, sayfadakiWebhook Test Aracı bloğunu bulun. Burada adres hazır durur, JSON gövdesini düzenleyipTest Et'e basarsınız; altta dönen durum kodu ve yanıt gövdesi görünür. Aynı sayfada çalışma geçmişi de listelenir.
Test aracı güvenlik gereği yalnızca Giizo webhook adreslerine istek gönderir; dış bir URL'yi buradan test edemezsiniz.
Düzenleme formundaki "Webhook'u Test Et" düğmesini kullanmayın — bu düğme henüz bir işlem yapmıyor. Çalışan test aracı detay sayfasındadır.
Çalışmıyorsa
- Tetikleyicinin durumu Aktif mi?
- Adresi tam kopyaladınız mı? Token'ın tamamı adresin sonundadır.
- Güvenlik türü seçtiyseniz dış sistem ilgili başlığı gönderiyor mu?
- Gövde geçerli bir JSON mu? Bozuk JSON'da istek işlenmez.
- Görev veya kullanıcı mesajı tanımlı mı? İkisi de boşsa çalıştırma hata verir.
- Detay sayfasındaki çalışma geçmişi ne diyor? İstek Giizo'ya ulaştıysa orada bir kayıt görürsünüz — kayıt yoksa sorun dış sistem tarafındadır.
Ne aramayın
- Ayarlar → Webhook'lar diye bir sekme yok; webhook'lar Akıllı Otomasyon altındadır.
- Konuşma başladığında dışarıya otomatik bildirim yayınlayan genel bir olay aboneliği yok. Dışa doğru çağrı, bir tetikleyiciye bağlı Veri Gönderme göreviyle yapılır.
- Webhook adresini IP listesiyle kısıtlama ekranı yok; erişimi güvenlik türü ile denetlersiniz.
İlgili sayfalar
- Akıllı Otomasyon — zamanlı tetikleyiciler ve genel akış
- Görev şablonları — tetikleyiciye bağlanan görevler
- MCP entegrasyonları — asistanın dış sistemlerle konuşmasının diğer yolu