Özel Fonksiyonlar #

Özel işlevler, yapay zeka botunuzun canlı görüşmeler sırasında diğer sistemlere bağlanmasını sağlar. Bot, “Kontrol edip size geri döneceğim” demek yerine, bir sipariş durumuna bakabilir, envanteri kontrol edebilir veya CRM’inizde (müşteri ilişkileri yönetimi sistemi - HubSpot veya Salesforce gibi potansiyel müşterileri ve müşterileri takip etmek için kullandığınız yazılım) bir kayıt oluşturabilir; üstelik tüm bunları müşteri beklerken gerçek zamanlı olarak yapar.

Özel Fonksiyonlar ve Webhook’lar #

Bu, en yaygın kafa karışıklığı noktasıdır, bu yüzden herhangi bir şey oluşturmadan önce bunu netleştirmekte fayda var.

Hangisinin seçileceği: Eğer başka bir sisteme sadece bir şeyin gerçekleştiğini bildirmeniz gerekiyorsa, bir webhook kullanın; bu, başka bir sisteme gönderilen tek yönlü otomatik bir mesajdır (bkz. Ayarlar → Entegrasyonlar → Webhook’lar). Eğer botun görüşmeye devam etmeden önce başka bir sistemden bir şey öğrenmesi gerekiyorsa, özel bir işlev kullanın.

Özel Fonksiyonların Sağladığı Olanaklar #

Yanıt doğrudan konuşmaya geri beslendiği için, özel fonksiyonlar webhook’ların yapamadığı şeylerin önünü açar:

• Canlı Shopify veya WooCommerce envanter sorgulama — Bot, müşteriye fiyat vermeden önce stokları gerçek zamanlı olarak kontrol eder ve “Kontrol edip size döneceğim” demek yerine “Evet, M beden 12 adet mevcut” şeklinde yanıt verir.
• Google E-Tablolar üzerinden dinamik fiyatlandırma — Satış ekibiniz fiyatları bir tabloda günceller; bot, konuşma sırasında en son satırı okur ve yapay zeka yapılandırmasına kimse dokunmadan güncel fiyatı sunar.
• Sesli yapay zeka geri arama temsilcisi — Bot bir potansiyel müşteriyi nitelendirdiğinde, dakikalar içinde müşteriyi geri araması için bir sesli temsilciyi (örneğin, ElevenLabs destekli bir arayıcı) tetikler ve müşteriye “Harika, önümüzdeki 5 dakika içinde bir arama bekleyin” şeklinde onay verir.
• Sohbet sırasında oluşturulan ve e-postayla gönderilen özel teklif PDF’i — Bot gereksinimleri toplar, teklif oluşturucunuzu çağırır, bir PDF URL’si alır ve müşteriye “Teklifinizi e-posta adresinize gönderdim, gelen kutunuzu kontrol edin” der.

Özel Fonksiyonlar Neler Yapabilir? #

Özel fonksiyonları, botunuza sadece sohbet etmenin ötesinde süper güçler kazandırmak olarak düşünün. İşte gerçek dünyadan örnekler:

• Sipariş takibi - Bir müşteri “Siparişim nerede?” diye sorduğunda bot e-ticaret sisteminizi kontrol eder ve gönderim durumu ile takip bağlantısını yanıt olarak iletir.
• Envanter kontrolü - “Bu ürünün 10 numarası var mı?” Bot stok sisteminizi kontrol eder ve gerçek zamanlı bir yanıt verir.
• CRM güncellemeleri - Bot bir potansiyel müşteriyi nitelendirdiğinde, HubSpot, Salesforce veya başka herhangi bir CRM’de otomatik olarak bir kayıt oluşturur veya günceller.
• Teklif oluşturma - Bot müşterinin gereksinimlerini toplar ve fiyatlandırma sisteminizden kişiselleştirilmiş bir teklif oluşturur.
• Rezervasyon - Bot harici rezervasyon sisteminizde bir randevu oluşturur.
• İndirim doğrulama - “Bu kupon kodu geçerli mi?” Bot kontrol eder ve onaylar.
• Hesap sorgulama - Geri dönen bir müşteri otomatik olarak tanınır ve hesap detayları getirilir.

Müşteri arka planda neler olduğunu asla görmez. Sadece sorularını gerçek ve güncel bilgilerle yanıtlayabilen bir bot deneyimi yaşar.

Özel Fonksiyonlar Nasıl Çalışır (Basit Versiyon) #

Bir konuşma sırasında özel bir fonksiyon tetiklendiğinde şunlar gerçekleşir:

1. Müşteri bir şey sorar (örneğin, “Siparişim nerede?”) ve bu gerçek zamanlı veri gerektirir.
2. Bot, yanıt vermek için özel bir işlev kullanması gerektiğini algılar.
3. Bot, müşteriden eksik bilgileri toplar (örneğin, “Sipariş numaranız nedir?”).
4. Platform, sisteminize (web siteniz, CRM’iniz veya başka bir aracınız) ilgili ayrıntılarla birlikte bir istek gönderir.
5. Sisteminiz, verilerle yanıt verir (örneğin, sipariş durumu, takip numarası, teslimat tarihi).
6. Bot yanıtı okur ve doğal bir cevap hazırlar: “ORD-4582 numaralı siparişiniz kargoya verildi ve Cuma gününe kadar ulaşması bekleniyor!”

Özel bir işlev çağrısının maliyeti nedir #

Her özel işlev çağrısı, Ajanınızın Yapay Zeka Kalite seviyesi üzerinden ücretlendirilir:

Özel İşlev Kurulumu (Adım Adım) #

1. Ana kenar çubuğunda, AI Studio altında Custom Functions öğesine tıklayın.

2. Sağ üstteki yeşil + Add Function (veya New function) düğmesine tıklayın.

Özel işlevler listesi, aşağıdaki sütunları içeren bir tablo görüntüler:

Bu, işlevlerinize bir bakışta göz atmanızı ve ihtiyacınız olanı bulmanızı kolaylaştırır.

1. Adım: Bir Ad ve Açıklama Verin #

İpucu: Açıklama ve amaç konusunda çok spesifik olun. İşlevin ne zaman kullanılması gerektiği konusunda ne kadar net olursanız, bot onu doğru zamanda o kadar güvenilir bir şekilde kullanacaktır.

2. Adım: Bağlantıyı Kurun #

Uygulamaya isteği nereye göndereceğini söylemeniz gerekir:

Hangi yöntem seçilmeli:

Hangisini kullanacağınızdan emin değilseniz, geliştiricinize veya bağlandığınız sistemin belgelerine başvurun. GET (aramalar için) ve POST (kayıt oluşturmak için) en yaygın olanlarıdır.

Adım 3: Kimlik Doğrulama Başlıklarını Ekleyin #

Çoğu sistem istekleri kabul etmek için kimlik doğrulaması gerektirir. Gerekli tüm başlıkları ekleyin:

Güvenlik ipucu: Sınırlı izinlere sahip özel bir API anahtarı kullanın. Yönetici düzeyinde kimlik bilgileri kullanmayın.

API anahtarları nerede bulunur: Bağlandığınız sistemin (örneğin CRM’iniz, e-ticaret platformunuz veya rezervasyon aracınız) ayarlarını veya geliştirici bölümünü kontrol edin.

Adım 4: Girişi Tanımlayın (Botun Ne Gönderdiği) #

Giriş parametreleri, botun konuşmadan topladığı ve sisteminize gönderdiği bilgi parçalarıdır.

Her parametre için şunları belirtirsiniz:

Kullanılabilir parametre türleri:

Her parametrenin ayrıca isteğe bağlı bir İstek gövdesi yolu alanı vardır. Normalde bir parametre, istek gövdesinde üst düzey bir alan olarak (veya query_param türü için sorgu dizesi değeri olarak) gönderilir. Uç noktanız bunun yerine iç içe geçmiş bir yapı bekliyorsa — örneğin {"order": {"id": "ORD-123"}} — yolu order.id olarak ayarlayın; platform değeri sizin için oraya yerleştirecektir.

Örnek: Bir sipariş durumu sorgulaması için şunları tanımlayabilirsiniz:

• order_number (string, gerekli): “Müşterinin sipariş numarası. Genellikle ORD- ile başlar ve ardından rakamlar gelir. Müşteri belirtmediyse bunu isteyin.”
• email (string, isteğe bağlı): “Ek doğrulama için müşterinin e-posta adresi. Sadece sipariş numarası tek başına eşleşme bulamazsa gereklidir.”

Sisteminizin Otomatik Olarak Aldıkları #

Tanımladığınız giriş parametrelerine ek olarak, platform her istekle birlikte otomatik olarak sistem verilerini de dahil eder. Uç noktanız bunu bir system alanında alır:

Bu, sisteminizin kişiyi tanımlaması, işlevi hangi kampanyanın tetiklediğini kontrol etmesi veya test sırasında farklı davranması gerekiyorsa kullanışlıdır.

Sistem verilerine ihtiyacınız yok mu? İşlev oluşturucudaki Sistem Verilerini Atla (Skip System Data) düğmesini açın. Bot daha sonra yalnızca tanımladığınız giriş parametrelerini gönderecektir; kişi veya kampanya verisi gönderilmez. Uç noktanız beklenmeyen alanları reddediyorsa veya sadece daha yalın bir veri yükü istiyorsanız bunu kullanın.

Adım 5: Test Edin, Ardından Botun Yanıtı Okumasını Sağlayın #

Normalde yanıt alanlarını eşlemenize hiç gerek yoktur. Uç noktanız yanıt verdiğinde, bot tüm JSON yanıtını okur ve neyin önemli olduğunu belirleyip doğal bir şekilde sunmak için işlevinizin Açıklama ve Amaç (Yapay Zeka Eylemi) kısımlarını — artı her parametrenin kendi açıklamasını — kullanır. İşlevin kendisindeki net bir Açıklama (“Gönderim bilgileri ve takip dahil olmak üzere bir müşteri siparişinin mevcut durumunu alır”), alan bazlı eşlemenin yapacağından daha fazlasını burada gerçekleştirir.

Uç noktanız büyük bir yanıt döndürüyorsa ve botun yalnızca birkaç belirli değeri görmesini istiyorsanız, Yanıt eşleme bölümünü açın (varsayılan olarak daraltılmıştır, Test’in hemen üzerindedir). Her satır, yanıttan bir üst düzey alan seçer: Yanıt alanı, API’nizin JSON yanıtındaki alan adıdır ve Çıktı alanı, botun onu hangi adla alacağıdır. En az bir satır doldurulduğunda, bot tam yanıt gövdesi yerine yalnızca eşlediğiniz değerleri alır. Varsayılan tam yanıt davranışını korumak için bölümü boş bırakın.

Kaydetmeden önce, oluşturucunun alt kısmındaki Test bölümünü kullanarak isteği tam olarak yapılandırıldığı gibi gönderin ve uygulamadan ayrılmadan gerçek yanıtı görün:

Burada gördüğünüz yanıt, uç noktanın ham yanıtıdır. Yukarıda Yanıt eşleme ayarını yaptıysanız, gerçek bir sohbetteki bot yalnızca bu eşlenmiş alanları alır; test ise her zaman tam ham yanıtı gösterir, böylece eşlenebilecek verileri görebilirsiniz. Bir şeyler hatalı görünüyorsa (beklenmedik alan adları, fazladan iç içe geçme gibi), bunu uç noktanızda düzeltin veya eşlemenizi ayarlayın.

İşlevleri Bir Temsilciye Atama #

Özel bir işlev oluşturduktan sonra, her Temsilciye hangi işlevleri kullanabileceğini söylemeniz gerekir:

1. Yapay Zeka Stüdyosu → Yapay Zeka Temsilcileri altından Temsilci’yi açın.
2. Yapay Zeka Yetenekleri sekmesine gidin. (Kendi yapay zeka ayarlarını ayrı bir Temsilci yerine doğrudan barındıran bir kampanya için, aynı liste bunun yerine o kampanyanın kendi Yapay Zeka Yetenekleri adımında görünür.)
3. Oluşturduğunuz her özel işlevin listesini göreceksiniz. Bu Temsilcinin botunun çağırabilmesini istediğiniz her işlevi açın.
4. Alt kısımdaki Değişiklikleri kaydet’e tıklayın. Seçimler yalnızca kaydedildikten sonra geçerli olur.

Bot için yalnızca atanan işlevler kullanılabilir. Bu, botun yanlışlıkla ilgili olmayan işlevleri kullanmasını önler.

Özel İşlevlerinizi Test Etme #

Canlıya geçmeden önce kapsamlı bir şekilde test edin:

1. Yerleşik Testi çalıştırın - İşlev oluşturucunun içindeki Test bölümünü (yukarıya bakın) kullanarak uygulamadan ayrılmadan hızlı bir kontrol yapın — gerçekçi değerler girin ve Testi çalıştır’a tıklayın.
2. Sisteminizin uç noktasını doğrudan test edin - Aşağıdaki tam kontrol listesi için Postman gibi özel bir araç (veya geliştiriciniz) tek bir Testi çalıştır işleminden daha derinlemesine inceleme yapar.
3. Deneme sürümünde test edin - Müşterinin işlevi tetiklemesi gereken bir şey sorduğu bir konuşmayı simüle edin.
4. Yanıtı kontrol edin - Botun verileri doğru bir şekilde okuduğundan ve sunduğundan emin olun.
5. Hata senaryolarını test edin - Müşteri geçersiz bir sipariş numarası verirse ne olur? Sisteminiz geçici olarak kapalıysa ne olur?

Test 401 veya 403 hatası döndürdüğünde #

401 veya 403 hatası, uç noktanızın isteği aldığını ancak reddettiğini gösterir. Bunun en belirgin işareti kendi günlüklerinizde hiçbir şeyin görünmemesidir — çoğu araç, yetkisiz bir çağrıyı iş akışını başlatmadan önce reddeder, bu nedenle tarafınızda görülecek bir şey olmaz ve istek hiç ulaşmamış gibi görünür.

Bu durum neredeyse her zaman bir kimlik doğrulama uyuşmazlığından kaynaklanır: uç noktanız bir tür kimlik bilgisi beklerken işlev farklı bir tane gönderiyordur. 3. Adımda eklediğiniz başlığın sisteminizin beklediğiyle birebir aynı olduğundan emin olun.

Bunun en yaygın versiyonu, Basic Auth ile korunan bir web kancasıdır (n8n, Make ve çoğu kendi kendine barındırılan araç bunu web kancasının üzerinde bir onay kutusu olarak sunar), ancak işlev X-My-Secret gibi özel bir gizli başlık gönderir. Basic Auth yalnızca Authorization başlığını kabul eder, bu nedenle özel bir başlık göz ardı edilir ve çağrı reddedilir. İki seçeneğiniz vardır:

• Web kancasında Basic Auth’u kapatın ve bunun yerine iş akışınızın içindeki özel başlığınızı kontrol edin.
• Basic Auth’u açık tutun ve işleve, değeri Basic kelimesini ve ardından base64 ile kodlanmış username:password değerini içeren bir Authorization başlığı ekleyin.

Her ikisi de işe yarar; sadece her iki tarafın da anlaştığından emin olun.

Test 404 hatası döndürdüğünde #

Uç nokta URL’si yanlıştır veya iş akışı yayınlanmamıştır. Özellikle n8n’de her web kancasının ayrı bir Test URL’si ve Production (Üretim) URL’si vardır ve Test URL’si yalnızca düzenleyici açıkken dinleme yapar. Production URL’sini kopyalayın ve iş akışının aktif olduğundan emin olun.

Deneme ve Sohbetlerde hataları görme #

Yapay zeka bir konuşma sırasında özel bir işlevi çağırdığında ve çağrı başarısız olursa — yanlış kimlik bilgileri, uç nokta kapalı, zaman aşımı — konuşma artık bunu gösterir: hem temsilcinin Deneme sekmesinde hem de Sohbetler içindeki gerçek konuşmalarda iş parçacığında kırmızı bir “(işlev adı) başarısız oldu” işareti görünür. Ayrıntıları genişletmek için işarete tıklayın: uç noktanızın döndürdüğü durum kodu ve genellikle neyi düzeltmeniz gerektiğini söylemek için yeterli olan yanıt gövdesi (bir “yetkisiz” mesajı içeren 401, kimlik doğrulama başlığı anlamına gelir, zaman aşımı ise uç noktanızın 30 saniyeden uzun sürdüğü anlamına gelir).

Başarılı çağrılar da bir işaret gösterir; uç noktanızın gerçekte ne gönderdiğini görmek için üzerine tıklayın. Bu, bir entegrasyonda uçtan uca hata ayıklamanın en hızlı yoludur: Deneme’de test konuşmasını yapın, ardından sayfadan ayrılmadan gerçek istek sonucunu görmek için işlev işaretine tıklayın.

Tam Örnek: Sipariş Durumu Sorgulama #

İşte şablon olarak kullanabileceğiniz tam yapılandırılmış bir örnek:

Temel Bilgiler:

• Ad: check_order_status
• Açıklama: “Müşteri siparişinin mevcut durumunu, gönderim bilgileri ve takip dahil olmak üzere getirir”
• Yapay Zeka Eylemi: “Müşteri sipariş durumunu, paketinin nerede olduğunu veya ne zaman geleceğini sorduğunda bunu çağırın. Her zaman önce sipariş numarasını isteyin.”

Bağlantı:

• URL: https://api.mystore.com/orders/lookup
• Yöntem: POST

Başlıklar:

• Authorization: Bearer sk_live_abc123
• Content-Type: application/json

Giriş Parametreleri:

• order_number (metin, zorunlu): “Müşteri tarafından sağlanan sipariş numarası”
• customer_email (metin, isteğe bağlı): “Ek doğrulama için müşterinin e-posta adresi”

Yanıt eşlemesi gerekmez — yukarıda halihazırda ayarlanmış net bir Açıklama ve Yapay Zeka Eylemi ile bot, uç noktanızın döndürdüğü her türlü JSON’u (durum, takip numarası, teslimat tarihi, ürünler) okur ve bunun hakkında nasıl konuşacağını belirler.

Konuşma nasıl görünür:

Müşteri: Hey, siparişim nerede?

Bot: Merhaba! Siparişinizi kontrol etmekten memnuniyet duyarım. Sipariş numaranızı benimle paylaşabilir misiniz?

Müşteri: ORD-78234

Bot: Sizin için hemen bakıyorum…

ORD-78234 numaralı siparişiniz kargoya verildi ve yolda! Tahmini teslimat tarihi 10 Mart. Paketinizi buradan takip edebilirsiniz: https://tracking.example.com/1Z999AA1

Size başka bir konuda yardımcı olabilir miyim?

Tam Örnek: Shopify Sipariş Durumu #

Mağaza Shopify üzerinde çalışıyorsa, bir arama uç noktası oluşturmak için geliştiriciye ihtiyacınız yoktur; Shopify’ın kendi sistemi sipariş sorularını doğrudan yanıtlayabilir. (Bir Shopify mağazasındaki ürün ve stok soruları için özel bir işleve hiç ihtiyacınız yoktur: bunun yerine mağazanın yerleşik sunucusunu bağlayın — bkz. Bir Shopify mağazasını bağlayın.)

Öncelikle, Shopify’da bir erişim belirteci (access token) oluşturun. Shopify bunu 2026 yılında değiştirdi: uygulamalar artık Shopify yöneticisi içinde oluşturulamıyor ve yeni uygulama ekranı size hazır bir belirteç yerine bir İstemci Kimliği (Client ID) ve İstemci gizli anahtarı (Client secret) veriyor. Aşağıdaki adımlar bunları kalıcı bir belirtece dönüştürür. Mağaza başına yaklaşık on dakikanızı ayırın. (Mağazada eski yöntemle oluşturulmuş daha eski bir uygulama zaten varsa, mevcut belirteci çalışmaya devam eder; doğrudan aşağıdaki özel işleve geçin.)

1. dev.shopify.com adresindeki Shopify Geliştirici Paneline gidin, kuruluşunuzu açın ve Apps → Create app seçeneğine tıklayın. Order lookup gibi bir ad verin.
2. Uygulamaya read_orders izni verin, bir sürüm yayınlayın ve uygulamayı mağazaya yükleyin.
3. Uygulamanın Settings kısmını açın ve mağazanın kendi web adresini (örneğin https://www.yourstore.com/) izin verilen yönlendirme URL’lerine ekleyin. Kaydedin.
4. Yine Settings içinde, Client ID ve Client secret bilgilerini kopyalayın.
5. O mağazanın Shopify yöneticisinde oturum açtığınız bir tarayıcıda, mağaza adını, istemci kimliğini ve yönlendirme adresini kendinizinkiyle değiştirerek aşağıdaki adresi açın: https://YOUR-STORE.myshopify.com/admin/oauth/authorize?client_id=YOUR-CLIENT-ID&scope=read_orders&redirect_uri=https://www.yourstore.com/&state=12345 Görünen ekranı onaylayın. Tarayıcı yönlendirme adresinize ulaşacaktır ve adres çubuğu artık code= ve ardından uzun bir değer içerecektir — bu değeri kopyalayın. Sadece birkaç dakika geçerlidir, bu yüzden doğrudan bir sonraki adıma geçin.
6. Bu kodu, Your AI Connector içinde yapabileceğiniz şekilde belirteçle değiştirin. Özel fonksiyon oluşturucuda Method kısmını POST ve URL kısmını https://YOUR-STORE.myshopify.com/admin/oauth/access_token olarak ayarlayın, client_id, client_secret ve code adında üç metin giriş parametresi ekleyin, ardından Test’e tıklayın, üç değeri girin ve çalıştırın. Yanıt access_token içerir — bu sizin kalıcı belirtecinizdir. Güvenli bir yere kopyalayın, ardından oluşturucuyu temizleyin ve aşağıdaki gerçek fonksiyonu kurun.

Ardından özel işlevi ayarlayın:

Temel Bilgiler:

• Ad: check_shopify_order
• Açıklama: “Mağazanın Shopify sistemindeki bir siparişi arar ve durumunu, takibini ve ürünlerini döndürür”
• Yapay Zeka Eylemi: “Bir müşteri sipariş durumu veya teslimat hakkında soru sorduğunda bunu çağırın. Her zaman önce sipariş numarasını isteyin.”

Bağlantı:

• URL: https://YOUR-STORE.myshopify.com/admin/api/2026-01/orders.json?status=any — YOUR-STORE kısmını mağazanın .myshopify.com adıyla değiştirin (bu adres, mağazanın özel alan adını değil, teknik Shopify alan adını kullanır)
• Yöntem: GET

Üstbilgiler:

• X-Shopify-Access-Token: shpat_... (yukarıdaki belirteç)

Giriş Parametreleri:

• name (query_param, gerekli): “Müşterinin sipariş onayında göründüğü şekliyle, # işareti dahil olmak üzere tam sipariş numarası — örneğin #1001. Müşteri belirtmediyse ondan isteyin.”

Yanıt eşlemesi gerekmez — bot, döndürülen siparişi (ödeme durumu, gönderim durumu, takip, ürünler) okur ve doğal bir şekilde yanıtlar.

Bilmekte fayda var: bu şekilde oluşturulan bir belirteç, son 60 gündeki siparişleri görebilir; bu, günlük destek soruları için yeterlidir ancak tam bir sipariş geçmişi değildir.

Tam Örnek: Randevu Oluşturma #

Temel Bilgiler:

• Ad: create_booking
• Açıklama: “Randevu sistemimizde yeni bir randevu oluşturur”
• Yapay Zeka Eylemi: “Bunu, tarih, saat ve iletişim bilgilerini müşteriyle doğruladıktan sonra kullanın. Müşteri randevu almak istediğini açıkça onaylamadan çağırmayın.”

Bağlantı:

• URL: https://booking.mycompany.com/api/appointments
• Yöntem: POST

Giriş Parametreleri:

• date (metin, zorunlu): “YYYY-AA-GG formatında randevu tarihi”
• time (metin, zorunlu): “SS:DD formatında randevu saati”
• name (metin, zorunlu): “Müşterinin tam adı”
• phone (metin, zorunlu): “Müşterinin telefon numarası”
• service_type (metin, zorunlu): “Randevu alınan hizmet türü”

Tam Örnek: CRM’inize Bülten Abonesi Ekleme #

Çok yaygın bir senaryo: bot yanıtlamayı bitirir, bülteninizi önerir, kişi e-posta adresiyle yanıt verir ve bu adresin doğrudan e-posta aracınıza ulaşması gerekir. Çoğu CRM (FluentCRM, ActiveCampaign, MailerLite, Brevo ve diğerleri) tam olarak bunun için basit bir POST isteğini kabul eder, bu nedenle arada herhangi bir otomasyon platformuna gerek kalmaz.

Bu örnek, WordPress üzerinde FluentCRM kullanmaktadır. Yapı, size “gelen webhook” veya “abone oluştur” uç noktası sağlayan diğer tüm araçlar için aynıdır.

Öncelikle, CRM’inizden URL’yi alın. WordPress’te FluentCRM → Ayarlar → Gelen Webhook’lar kısmını açın ve bir webhook oluşturun. Yeni kişilerin alması gereken listeyi, etiketleri ve abonelik durumunu seçin, ardından oluşturulan webhook URL’sini kopyalayın. Burada ayarladığınız her şey otomatik olarak uygulanır, bu nedenle botun sadece e-posta adresini göndermesi yeterlidir.

Ardından özel işlevi ayarlayın:

Temel Bilgiler:

• Ad: add_newsletter_subscriber
• Açıklama: “Sohbet sırasında verdikleri e-posta adresini kullanarak birini bülten listemize ekler”
• Yapay Zeka Eylemi: “Bunu, kişi bültene abone olmayı kabul ettiği ve e-posta adresini verdiği anda kullanın. Adresi gerçekten vermeden önce çağırmayın ve aynı kişi için iki kez çağırmayın.”

Bağlantı:

• URL: CRM’inizden kopyaladığınız webhook URL’si
• Yöntem: POST

Giriş Parametreleri:

• email (dize, gerekli): “Kişinin konuşma sırasında verdiği e-posta adresi”
• first_name (dize, isteğe bağlı): “Kişinin belirttiği takdirde adı”

Sistem Verilerini Atla: bunu açık konuma getirin. CRM’iniz yalnızca yukarıdaki alanlara ihtiyaç duyar ve daha yalın bir veri yükü, beklenmedik alanları reddeden araçlardan kaynaklanabilecek hataları önler.

Yanıt eşleme: burada gerekli değildir. Botun devam etmesi için geri bir şey gelmesine gerek yoktur.

Fonksiyonu, konuşmayı yürüten Temsilci için açmayı unutmayın (bkz. Temsilciye Fonksiyon Atama). Bu, doğru oluşturulmuş bir fonksiyonun asla çalışmamasının en yaygın nedenidir.

Güvenilir Özel İşlevler İçin İpuçları #

1. Tekrarlanan isteklerin güvenli olduğundan emin olun. Aynı istek yanlışlıkla iki kez gönderilirse, yinelenen kayıtlar oluşturmamalıdır. Ağ kesintileri bazen buna neden olabilir.

2. Net hata mesajları döndürün. Sisteminizin tarafında bir sorun oluşursa, insan tarafından okunabilir bir hata döndürün. Bot, bunu müşteriye nazik bir şekilde iletecektir.

3. Yanıt sürelerini 10 saniyenin altında tutun. Sisteminiz daha uzun sürüyorsa, önce hızlı bir onay döndürmeyi düşünün.

4. Süresi dolmuş veya geçersiz kimlik bilgilerini yönetin. API anahtarınızın süresi dolarsa, botun yeniden denemek yerine bir insana haber vermesi gerektiğini anlaması için hata mesajının net olduğundan emin olun.

5. Ayrıntılı açıklamalar yazın. Yapay zeka, işlevi ne zaman çağıracağını ve konuşmadan doğru bilgiyi nasıl çıkaracağını anlamak için açıklamalarınızı kullanır. Belirsiz açıklamalar hatalara yol açar.

6. Gerçek görüşmelerle test edin. Deneme, ilk testler için harikadır ancak her şeyin gerçek müşteri sorgularıyla çalıştığından emin olmak için ilk birkaç canlı görüşmenizi izleyin.

7. Kendi tarafınızda günlük tutun. Geliştiricinizden, uygulamadan gelen istekleri günlüğe kaydetmesini isteyin, böylece sorunları hızlı bir şekilde giderebilirsiniz.

8. Herkese açık bir nihai URL kullanın. İşlev URL’niz herkese açık bir web (HTTP/HTTPS) adresi olmalıdır. Dahili, localhost ve özel ağ adresleri güvenlik nedeniyle reddedilir ve platform yönlendirmeleri takip etmez; işlevi yönlendirme yapan bir URL’ye değil, doğrudan nihai URL’ye yönlendirin.

Yürütme Sınırları #

Her özel işlevin düzenleyicinin altında isteğe bağlı bir Yürütme sınırları bölümü bulunur. Bu bölüm, yapay zekanın işlevi ne sıklıkla çalıştırabileceğini ve daha önceki bir sonucun yeniden kullanılıp kullanılamayacağını kontrol eder. Buradaki her şey isteğe bağlıdır; hepsini boş bırakırsanız işlev eskisi gibi davranmaya devam eder.

Salt okunur işlev. İşleviniz yalnızca veri okuyorsa (hisse senedi sorgulama, fiyat kontrolü, sipariş durumu arama gibi) ve hiçbir şey oluşturmuyor veya değiştirmiyorsa bunu açın. Geçici bir ağ kesintisi yapay zekayı yanıt sırasında bölerse, platform müşteriyi cevapsız bırakmak yerine konuşma sırasını güvenle yeniden deneyebilir. Yalnızca işlev gerçekten hiçbir şey yazmıyorsa etkinleştirin: kayıt oluşturan bir işlev kapalı kalmalıdır, böylece bir yeniden deneme onu yanlışlıkla iki kez çalıştıramaz.

Tekrarlanan çağrılarda önbelleğe alınmış sonucu sun. Yapay zeka işlevi aynı girdilerle tekrar çağırdığında (örneğin, müşteri aynı soruyu iki kez sorduğunda), uç noktanızı tekrar çağırmak yerine önceki sonuç yeniden kullanılır. Önbelleğe alınan sonuçlar 24 saate kadar saklanır ve farklı girdilerle yapılan bir çağrı her zaman uç noktanıza taze bir şekilde gider.

Konuşma başına maksimum çalışma. Bir konuşma içinde işlevin kaç kez çalışabileceğine dair kesin bir sınır. Teklif oluşturma, geri arama tetikleme, otomasyon başlatma gibi her sohbette yalnızca bir kez çalışması gereken işlevler için bunu 1 olarak ayarlayın. Sınıra ulaşıldığında, yapay zekaya işlevin zaten çalıştığı söylenir ve en son sonuç verilir, böylece sessiz kalmak yerine müşteriye cevap vermeye devam edebilir.

Zaman aralığı başına maksimum çalışma. Zaman içinde bir hız sınırı: örneğin, 60 dakika içinde en fazla 5 çalışma. Ücretli üçüncü taraf hizmetlerini çağıran veya daha ağır otomasyonları tetikleyen işlevler için kullanışlıdır. Her iki kutu da birlikte doldurulmalıdır (çalışma sayısı ve 7 güne kadar dakika cinsinden bir pencere).

Bilmeniz gereken birkaç şey:

• Sınırlar yalnızca başarılı çalışmaları sayar. Uç noktanız tarafında başarısız olan bir çağrı bütçeyi tüketmez.
• Bir çalışma sınır tarafından engellendiğinde, müşteri asla cevapsız bırakılmaz; yapay zekaya neden engellendiği söylenir ve elindeki bilgilerle çalışmaya devam eder.
• Sınırlar, işlevin çalıştığı her yerde geçerlidir: her kanaldaki normal sohbetler ve bir otomasyon tarafından yönetilen işlevler. Deneme (Try Out) kısmındaki test konuşmaları sayılmaz ve sınırlandırılmaz.

Yerleşik Bot Araçları #

Kendi oluşturduğunuz özel işlevlere ek olarak, platform, yapay zeka botunun bir konuşma sırasında kullanabileceği önceden oluşturulmuş araçlardan oluşan bir kütüphane ile birlikte gelir. Bunlar, bir botun yapması gereken en yaygın şeyleri (bir ekip üyesini uyarma, randevu alma, bir kişiyi etiketleme, web sitenizde arama yapma, takip planlama ve daha fazlası) kapsar, böylece bunları sıfırdan bağlamak zorunda kalmazsınız.

Bot, her aracı ne zaman kullanacağına görüşmede neler olduğuna ve Temsilcinizin (ve bağlı kampanyasının) nasıl yapılandırıldığına bağlı olarak karar verir. Bu araçların çoğu, ilgili özellik etkinleştirildiğinde otomatik olarak açılır (örneğin, rezervasyon araçları yalnızca bir takvim bağlayıp rezervasyonları etkinleştirdiğinizde kullanılabilir hale gelir).

Kredi maliyeti: Her araç çağrısı, Ajanınızın Yapay Zeka Kalite seviyesi üzerinden ücretlendirilir ve kendi oluşturduğunuz özel işlevler de aynı şekilde ücretlendirilir:

Ekip ve Görev Araçları #

Kişi Araçları #

Randevu & Rezervasyon Araçları #

Bu araçlar yalnızca Temsilcinize bağlı kampanyada rezervasyonlar etkinleştirildiğinde ve bir takvim etkinliği türü yapılandırıldığında kullanılabilir.

Bilgi & Web Araçları #

Takip Araçları #

Bu araçlar, Temsilcinize bağlı kampanyada takip işlemlerinin etkinleştirilmesini gerektirir.

Özel İşlev Çalıştırıcı #

Restoran Rezervasyon Araçları (Zenchef ve Formitable) #

Bu araçlar yalnızca bir Zenchef veya Formitable entegrasyonu bağlı olduğunda kullanılabilir. Botun restoran rezervasyonlarını uçtan uca yönetmesini sağlarlar.

Araçları Açma ve Kapatma #

Çoğu araç, Temsilcinin Yapay Zeka Yetenekleri sekmesinden (veya hala klasik bir kampanya üzerinde çalışıyorsanız, kampanyanın Yapay Zeka Yetenekleri adımından) kontrol edilir:

• Rezervasyon araçları, rezervasyonları etkinleştirip bir takvim bağladığınızda açılır — bu şimdilik kampanya bazlı bir ayar olarak kalır ve Temsilcinin kendi Yapay Zeka Yetenekleri sekmesinden doğrudan o kampanyanın adımına giden bir bağlantı bulunur
• Takip araçları, takip işlemlerini etkinleştirdiğinizde açılır
• Restoran araçları, bir Zenchef veya Formitable hesabı bağladığınızda açılır
• Web araması, SSS ve Bilgi sekmesinde kendi açma/kapama düğmesine sahiptir
• Görev araçları, Yapay Zekanın görev oluşturmasına izin ver düğmesi ile Temsilci bazında kapatılabilir (varsayılan olarak açıktır; Ayarlar → Profil → Özellikler altındaki hesap genelindeki Görevler anahtarı, tüm görev sistemini her yerde kapatır)
• İletişim güncelleme araçları, aynı Yapay Zeka Yetenekleri sekmesinden kontrol edilir — yapay zekanın kişileri yeniden adlandırıp adlandıramayacağı veya toplanan ek bilgileri onlar üzerinde kaydedip kaydedemeyeceği buradan belirlenir
• Uyarı araçları her zaman kullanılabilir; etiketleme her bot yanıtından sonra otomatik olarak çalışır (botun çağırmayı seçtiği bir araç değildir)

Botun belirli bir yerleşik aracı kullanmasını durdurmak istiyorsanız, en temiz yol temel özelliği devre dışı bırakmaktır (örneğin, tüm rezervasyon araçlarını devre dışı bırakmak için rezervasyonları kapatın).

Bir Otomasyon Tarafından Yönetilen İşlevler #

Özel İşlevler sayfanızdaki bazı girdiler Otomasyon tarafından yönetiliyor rozeti taşıyabilir. Bunlar burada oluşturulmamıştır; dış bir web adresine yönlendirmek yerine adımlarını otomasyon tuvali üzerinde görsel olarak oluşturduğunuz bir yeteneği temsil eden, Yapay Zeka Ajanı İşlevi tetikleyicisine sahip bir otomasyondan gelirler.

Yönetilen bir işlev sizin yerinize takip edilir: adı, açıklaması ve alanları her zaman otomasyonun tetikleyicisinde ayarlananları takip eder, bu nedenle bu sayfadan düzenlenemez veya silinemez; bunun yerine Otomasyonu aç bağlantısını kullanın ve otomasyonun kendisini değiştirin. Yine de hangi temsilcilerin bu işleve sahip olacağını normal yolla seçebilirsiniz: bir temsilcinin Yapay Zeka Yetenekleri sekmesinde, temsilcinin diğer yeteneklerinin yanında normal bir açma/kapama düğmesiyle görünür (otomasyonu duraklatılmışsa, satır bunu belirtir; otomasyon açıldığında yetenek canlı hale gelir). Bununla ilgili diğer her şey, diğer tüm özel işlevler gibi davranır: Yapay Zeka onu ne zaman çağıracağına karar verir, tanımladığınız ayrıntıları toplar ve otomasyonun yanıtını aynı konuşmada kullanabilir.

İkisi arasında seçim yapıyorsanız: normal bir özel işlevi, zaten çağrılacak bir adresi olan bir sisteme yönlendirin; işi adımlardan oluşturmayı tercih ediyorsanız (bir elektronik tabloda veya veritabanında arama yapma, bir koşula göre dallanma, kayıt oluşturma gibi) kendi sunucunuzu çalıştırmadan bir Yapay Zeka Ajan İşlevi tetikleyicisi ile otomasyon oluşturun. Bkz. Otomasyonlar.

Plan Gereksinimleri #

Özel işlevler, özel işlevler özelliğini içeren planlarda mevcuttur. Kullanılabilirliği doğrulamak için aboneliğinizi kontrol edin.

Sonraki Adımlar #

• MCP Sunucularını Botunuza Bağlayın — tek tek işlevler yerine hazır bir araç paketi.
• Yapay Zeka Ajanları — Özel İşlevler grubunun bulunduğu ana sayfa ve özel işlevlerin bir bota atandığı yer.