Eylemler ve Araçlar

Eylemler sekmesi, ajanınızın konuşmanın ötesinde yapabileceği her şeyi yönettiğiniz yerdir — ajanın canlı konuşma sırasında çağırdığı araçlar, çağrı başlamadan önce çalışan ön çekme kancaları ve çağrı sona erdiğinde tetiklenen çağrı sonrası eylemler. Çekme Değişkenleri (ajanın her konuşmadan çıkardığı veri alanları) aynı sekmede yer alır.

Tüm Planlar

Tüm araçlar, eylemler ve yeni ön çekme kancası Free dahil her planda mevcuttur.

Üç Aşama

Eylemler sekmesindeki her giriş üç yaşam döngüsü aşamasından birine aittir. Araç Ekle açılır menüsü onları gruplandırır, böylece her şeyin ne zaman tetiklendiği net olur:

Aşama	Ne Zaman	Örnekler
Önceden çek	Ajan merhaba demeden önce	CRM'nizde arayanı telefonla arayın, en son siparişi çekin, arka uçtan kişiselleştirilmiş bir karşılama getirin
Canlı çağrı	Konuşma sırasında, AI tarafından doğru anda tetiklenir	Çağrıyı insana yönlendirin, takvim müsaitliğini kontrol edin, başka bir ajana aktarın, veri için harici API sorgulayın
Çağrı sonrası	Çağrı sona erdikten sonra	Bir özet e-posta gönder, bir SMS onayı tetikle, çağrı yükünü CRM'nize ilet

Açılır menü, en üstte Önceden çek ile açılır çünkü diğer her aşamanın zaten çok seçeneği vardır — yeni ön çekme girişi, en olası aradığınız şeydir.

Önceden Çek

Ön çekme kancaları ajanınızın kimin aradığını zaten bilerek çağrıya başlamasını sağlar. Çağrı kurulumuyla paralel olarak çalışırlar ve yanıtı henüz ilk kelime söylenmeden ajanın sistem komut dosyasına enjekte ederler.

Ne zaman kullanılır

Geri dönen müşteriyi telefon numarasıyla tanıyın ve adıyla karşılayın
Arayanın açık siparişini, son randevusunu veya üyelik kademesini çekin
Hangi hattın arandığına bağlı iş bağlamını önceden yükleyin
Ajanın potansiyel müşterinin aşamasını ve geçmişini bilmesi için CRM notlarını enjekte edin

Nasıl çalışır

Platform, arayanın telefonunu çözer (gelen için SIP'den, giden için arama hedefinden).
Her aktif Önceden çek eylemi, istek başına sıkı 1,5 sn zaman aşımı ve 2 sn genel bütçe ile paralel olarak tetiklenir.
Başarılı yanıtlar, ajanın sistem komut dosyasına adlandırılmış bloklar olarak birleştirilir — ajan bunları ilk turunda okur.
Hatalar sessizdir — yavaş veya bozuk bir uç nokta asla karşılamayı engellemez. Ajan o blok olmadan konuşmaya başlar.

Yapılandırma

Alan	Açıklama
Ad	Gerekli. Komut dosyasındaki dahili etiket ve blok adı — kısa ve açıklayıcı tutun (örn. `crm_lookup`, `vip_check`).
API URL	Gerekli. Çekilecek uç nokta. `{phone}`, `{direction}`, `{agent_id}`, `{user_id}`, `{call_id}` yer tutucularını destekler.
HTTP Yöntemi	`GET` varsayılan ve en iyi uyumdur. `POST` / `PUT` / `PATCH` / `DELETE` de çalışır.
Başlıklar	İsteğe bağlı. Statik veya şablonlu (yer tutucular burada da çalışır).
Sorgu Parametreleri	İsteğe bağlı. Yeni ön çekme eylemleri için `phone={phone}` ile önceden doldurulur.

Mevcut değişkenler

Bu token'lar, istek anında URL, başlıklar ve sorgu/gövde parametrelerinde değiştirilir:

Değişken	Kaynak	Örnek değer
`{phone}`	Arayanın telefonu (E.164) — giden için, hedef numara	`+431234567890`
`{direction}`	`inbound` veya `outbound`	`inbound`
`{agent_id}`	Dahili ajan kimliği	`65f1a2b3c4...`
`{user_id}`	Çalışma alanı sahibi kimliği	`65e0b1c2d3...`
`{call_id}`	Çağrı kimliği (arka ucunuzun daha sonra çağrı sonrası yükü ilişkilendirmesini sağlar)	`65f1f2c4d5...`

Bilinmeyen yer tutucular olduğu gibi bırakılır — kötü şablonlama asla bir çağrıyı çökertmez.

Komut dosyasına ne girer

Uç noktanız https://crm.example.com/lookup?phone={phone} şunu döndürürse:

{ "name": "Sarah Johnson", "tier": "Gold", "open_orders": 1 }

Ajanın sistem komut dosyasına eylem adıyla adlandırılmış XML sarılmış bir blok eklenir:

<call_context>
  <block name="crm_lookup">
  { "name": "Sarah Johnson", "tier": "Gold", "open_orders": 1 }
  </block>
</call_context>

Ajana nasıl kullanılacağını söylemeniz gerekmez — LLM bağlamı doğal olarak alır. İsteğe bağlı olarak, sistem komut dosyanızda ön çekmeden bahsedin: "<call_context> bir müşteri adı içeriyorsa, onları adıyla karşılayın."

Önemli kısıtlamalar

Yalnızca telefon çağrıları. Ön çekme widget (web) çağrıları için çalışmaz — şablonlamak için bir telefon numarası yoktur.
Yanıt gövdesinde 8 KB üst sınır — daha uzun olan herhangi bir şey enjeksiyondan önce kesilir. Üst sınır komut dosyası token bütçenizi korur ve kötü amaçlı bir uç noktanın etki alanını sınırlandırır.
condition değerlendirmesi yok — ön çekme aktif olduğunda her zaman tetiklenir. Değerlendirilecek henüz transkripsiyon yok.

ipucu

Telefon anahtarlı arama uç noktasıyla GET kullanın. Yanıtları küçük ve yapılandırılmış tutun (3-5 alanlı JSON nesnesi). Ajanın tüm müşteri kaydınıza ihtiyacı yoktur — yalnızca konuşmayı değiştiren parçalar yeterlidir.

Canlı Çağrı Araçları

Bunlar konuşma sırasında çalışır. AI, açıklamasına ve mevcut diyaloğa dayanarak her aracı ne zaman çağıracağına karar verir.

Mevcut Araçlar

Araç	Amaç	Ne zaman kullanılır
Çağrı Yönlendirme	İnsan operatöre aktarma	Müşteri bir kişi ister, karmaşık konular
Google Calendar	Müsaitliği kontrol et ve randevu al	Müşteri toplantı planlamak ister
Outlook Calendar	Aynı, Microsoft Outlook üzerinden	Müşteri toplantı planlamak ister
API Tool RAG	Harici API'den canlı veri çekme	Gerçek zamanlı bilgi gereklidir (siparişler, stok, hesap durumu)
Ajan Aktarımı	Başka bir AI sesli ajana aktarma	Arayan farklı bir departmana veya uzmana ihtiyaç duyar
HubSpot CRM	HubSpot'taki kişileri ve fırsatları oku/yaz	Çağrıyı HubSpot'a kaydetme, bir potansiyel müşteriyi arama
MCP sunucuları	Kayıtlı MCP sunucularınızdan herhangi birinden araçları sunun	Bir MCP uyumlu araç sunucusu çalıştırıyorsunuz ve ajanın araçlarını konuşma ortasında kullanmasını istiyorsunuz

Çağrı Yönlendirme

Belirli koşullar karşılandığında çağrıları bir insana aktarın.

Ayar	Açıklama	Örnek
Ad	Gerekli. Kişi veya departman adı	`"Satış Yöneticisi"`
Yönlendirme Numarası	Aktarılacak varsayılan telefon numarası	`"+49 123 456 789"`
Tetikleyici Koşul	Ajanın ne zaman aktaracağı	`"Müşteri yönetici ister veya sorun çözülemez"`
Koşullu Yönlendirme Numaraları	Yönlendirme için koşul-numara eşlemesi	`{"billing": "+49 111 222", "technical": "+49 333 444"}`

Nasıl çalışır:

Bir konuşma sırasında AI, Tetikleyici Koşulu değerlendirir.
Koşullu yönlendirme numaraları ayarlandıysa, eşleşen koşul hangi numaranın aranacağını belirler.
Aksi takdirde Yönlendirme Numarası kullanılır.
Ajan arayanı aktarma hakkında bilgilendirir.
Çağrı yönlendirilir — yanıt yoksa, ajana geri döner.

ipucu

Farklı departmanlar için birden fazla Çağrı Yönlendirme aracı ekleyebilirsiniz — biri "Satış" için ve diğeri "Teknik Destek" için farklı koşullar ve numaralarla.

Google Calendar

Ajanın çağrılar sırasında müsaitliği kontrol edip randevu alabilmesi için Google Calendar'ınızı bağlayın.

Kurulum:

Önce Entegrasyon → Takvimler bölümüne gidin ve Google hesabınızı bağlayın.
Ajanın Eylemler sekmesinde Google Calendar aracını ekleyin.
Kullanılacak takvimi seçin.
Müsaitlik ayarlarınızı yapılandırın.

Ayar	Açıklama	Varsayılan
Takvim	Gerekli. Hangi takvim kullanılacak	Birincil takviminiz
Saat Dilimi	Randevular için saat dilimi (IANA formatı)	Otomatik algılandı
Çalışma Başlangıç Saati	Çalışma saatlerinin başlangıcı	9:00
Çalışma Bitiş Saati	Çalışma saatlerinin sonu	18:00
Yuva Süresi	Dakika cinsinden randevu uzunluğu	30
Çalışma Günleri	Haftanın müsait günleri	Pazartesi-Cuma
Randevular Arası Tampon	Randevular arasındaki tampon (0-60 dak)	0

Desteklenen yuva süreleri: 15, 30, 45, 60, 75, 90, 105, 120 dakika.

ipucu

Çalışma saatlerinizi ve günlerinizi doğru ayarlayın — ajan yalnızca yapılandırılmış müsaitliğiniz içindeki zaman yuvalarını sunacaktır.

Outlook Calendar

Çağrılar sırasında randevu planlama için Outlook Calendar'ınızı bağlayın. Google Calendar ile aynı şekilde çalışır.

Kurulum:

Önce Entegrasyon → Takvimler bölümüne gidin ve Outlook hesabınızı bağlayın.
Ajanın Eylemler sekmesinde Outlook Calendar aracını ekleyin.
Kullanılacak takvimi seçin.
Müsaitlik ayarlarınızı yapılandırın.

Ayarlar Google Calendar ile aynıdır (saat dilimi, çalışma saatleri, yuva süresi, çalışma günleri, tampon).

Ajan Aktarımı

Hesabınızdaki başka bir AI sesli ajana çağrı aktarın. Farklı departmanlar için özel ajanlarınız olduğunda kullanışlıdır.

Ayar	Açıklama
Hedef Ajan	Gerekli. Hangi ajana aktarılacağını seçin
Tetikleyici Koşul	Ne zaman aktarılacağı (örn. "Arayan teknik destek hakkında sorar")

Örnek: Resepsiyonist ajan, fiyatlandırma hakkında sorduklarında arayanları bir satış ajanına veya teknik bir sorunları olduğunda bir destek ajanına aktarır.

HubSpot CRM

Çağrı sırasında HubSpot CRM'inize okuyup yazın. Ajanın etkileşimleri kaydetmesine, bir kişiyi telefonla aramasına veya API çağrılarını betiklemenize gerek kalmadan fırsat güncellemelerini iletmesine olanak tanır.

Kurulum:

Entegrasyonlar sayfasına gidin ve HubSpot hesabınızı bağlayın.
Ajanın Eylemler sekmesinde HubSpot CRM aracını ekleyin.
Ajanın dokunabileceği hangi boru hattını ve özellikleri seçin.

Araç eklendikten sonra, AI arayanı telefonla bir HubSpot kişisiyle eşleştirebilir, fırsat aşamasını getirebilir ve alanları güncelleyebilir — hepsi canlı konuşmadan.

MCP sunucuları

Hanc.AI'ye bağladığınız herhangi bir MCP uyumlu sunucudan araçları sunun. Bir ajan birden fazla MCP sunucusundan çekebilir; bir MCP sunucusu birden fazla ajana hizmet edebilir.

Kurulum:

MCP sunucularınızı Entegrasyon → MCP sunucuları altında bir kez bağlayın. Tam kayıt adımları için özel MCP Sunucuları sayfasına bakın.
Bu ajanın Eylemler sekmesine MCP sunucuları girişini ekleyin — Eylem Ekle açılır menüsünde Canlı çağrı altında gruplandırılmıştır.
Bu ajanın hangi kayıtlı bağlantılarınıza erişebileceğini açın.
Ajanın bu araçlara ne zaman başvuracağını bilmesi için kısa bir "Ne zaman kullanılacak" talimatı ekleyin.

Ajan, her çağrının başında etkinleştirilen her MCP sunucusundan araç setini yeniden keşfeder, böylece sunucu tarafında yaptığınız değişiklikler bir sonraki çağrıda otomatik olarak görünür. Farklı sunuculardan benzer adlı araçların çakışmaması için araçlar bağlantı etiketiyle önek alarak yeniden adlandırılır.

API Tool RAG

Çağrılar sırasında gerçek zamanlı bilgi getirmek için harici API'lere bağlanın — siparişleri arayın, envanteri kontrol edin, hesapları doğrulayın veya API üzerinden mevcut herhangi bir veriye erişin.

Ayar	Açıklama	Örnek
Ad	Gerekli. Araç adı	`"Sipariş Arama"`
Açıklama / Ne Zaman Kullanılır	Gerekli. API'yi ne zaman sorgulayacağı	`"Müşteri sipariş durumu hakkında sorar"`
API URL	Gerekli. API uç noktası. Body Parameters Schema'daki değerlerle değiştirilecek `{placeholder}` token'ları içerebilir (aşağıya bakın).	`"https://api.yourshop.com/orders/{order_id}"`
HTTP Yöntemi	Gerekli. HTTP yöntemi	`GET`, `POST`, `PUT`, `DELETE`, `PATCH`
Yükleme Mesajı	Beklerken ajanın ne söyleyeceği	`"Sizin için kontrol edeyim..."`
Zaman Aşımı	Maksimum bekleme süresi (ms)	`5000` (varsayılan)
Başlıklar	Her istekle gönderilen statik HTTP başlıkları	`{"Authorization": "Bearer KEY"}`
Sorgu Parametreleri	Her isteğe eklenen statik sorgu dizesi parametreleri	`{"apiVersion": "v2"}`
Body Parameters Schema	Gerekli. AI'nın konuşmadan çıkaracağı ve araca geçireceği argümanları açıklayan JSON Schema. Body Parameters Schema Yazma bölümüne bakın.	JSON Schema nesnesi

ipucu

Her zaman bir Yükleme Mesajı ayarlayın — API çağrıları sırasındaki sessizlik arayana bozuk gibi hissettirir.

not

API Tool RAG üzerindeki eski "Çağrı başında çalıştır" onay kutusu, özel Önceden çek girişiyle değiştirildi. Konuşma başlamadan önce veriyi istediğinizde Önceden çek'i kullanın; ajanın çağrı sırasında getirip getirmeyeceğine karar vermesi gerektiğinde API Tool RAG'i kullanın.

Body Parameters Schema Yazma

Adına rağmen, Body Parameters Schema ham bir istek gövdesi değildir. AI'nın konuşmadan ne çıkaracağını ve aracınıza ne geçireceğini açıklayan bir JSON Schema'dır. HTTP yöntemine ve URL şablonuna bağlı olarak, bu değerler URL'de, sorgu dizesinde veya JSON gövdesinde sona erer:

HTTP yöntemi	Çıkarılan değerlerin nereye gittiği
URL `{name}` içeriyor	Eşleşen değer URL'ye değiştirilir
`GET`, `DELETE`	Kalan değerler URL'ye `?key=value` olarak eklenir
`POST`, `PUT`, `PATCH`	Kalan değerler JSON gövdesi olarak gönderilir

Minimum yapı

{
  "type": "object",
  "properties": {
    "param_name": {
      "type": "string",
      "description": "What this value is and how the AI should pick it"
    }
  },
  "required": ["param_name"]
}

Kök type her zaman "object"dir. properties her bir argümanı listeler. required AI'nın her zaman sağlaması gerekenleri işaretler — müşteri henüz söylemediyse, AI aracı çağırmadan önce soracaktır.

Alan referansı

Alan	Amaç
`type`	Değerin JSON türü: `"string"`, `"number"`, `"integer"`, `"boolean"`, `"array"`, `"object"`
`description`	En önemlisi. AI'ya değerin ne anlama geldiğini, hangi formatın kullanılacağını ve ne zaman sağlayacağını söyler. Mümkün olduğunca örnekler ekleyin.
`enum`	Değeri sabit bir listeden birine kısıtlar. AI, doğal konuşmayı en yakın seçeneğe eşleyecektir (örn. `"mavi olan"` → `"blue"`).
`minimum`, `maximum`	Sayısal sınırlar. AI, aralık dışı değerleri reddeder/sınırlar.
`default`	AI bu alanı geçirmediğinde kullanılan değer. Gerekli değildir, ancak örtük değeri belgeler.
`format`	Doğrulama ipucu, örn. `"email"`, `"date"` (YYYY-MM-DD), `"uri"`.

Örnekler

Ürün araması (yalnızca anahtar kelime):

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Product search keyword — e.g. \"phone\", \"laptop\", \"Apple\", \"Samsung\""
    }
  },
  "required": ["query"]
}

https://dummyjson.com/products/search?q={query}&limit=5 URL'si ve GET ile kullanılır: query değeri URL yer tutucusuna gider. Gövdeye hiçbir şey gitmez.

Kimliğe göre sipariş arama:

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "description": "Order ID the customer is asking about, usually 6 to 10 digits. Ask the customer if not provided."
    }
  },
  "required": ["order_id"]
}

https://api.example.com/orders/{order_id} URL'si ve GET ile kullanılır.

Birden fazla zorunlu alanla rezervasyon:

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "description": "Product ID returned by a previous search_products call."
    },
    "quantity": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "How many items to reserve. Default 1."
    },
    "delivery_method": {
      "type": "string",
      "enum": ["pickup", "home_delivery", "locker"],
      "description": "How the customer wants to receive the item."
    },
    "customer_email": {
      "type": "string",
      "format": "email",
      "description": "Customer's email for order confirmation. Ask if not provided."
    }
  },
  "required": ["product_id", "delivery_method", "customer_email"]
}

POST https://api.example.com/reservations ile kullanılır: dört değer JSON gövdesine gider. AI, aracı çağırmadan önce eksik required alanlar için müşteriye soracaktır.

Parametresiz araç:

{
  "type": "object",
  "properties": {}
}

Bunu, uç noktanın tamamen statik olduğu (örn. GET /store/hours) ve AI'nın hiçbir şey geçirmesine gerek olmadığı durumlarda kullanın.

AI sesli ajanlar için en iyi uygulamalar

Şemayı düz tutun. İç içe nesneler ve diziler çalışır, ancak AI bir telefonda konuşurken kayabilir. Maksimum 3-5 üst düzey alan tercih edin.
Her alan için her zaman bir description yazın. Örnekler ekleyin (örn. "telefon", "dizüstü") — örnekler, soyut tanımlardan daha güvenilir şekilde AI'yı yönlendirir.
Sabit bir değer listesine sahip olduğunuzda enum kullanın. AI'nın değerler uydurması veya "electronics" yerine "Electronics" göndermesi riskini ortadan kaldırır.
Bir alanı required olarak yalnızca araç onsuz çalışamıyorsa işaretleyin. Geri kalan her şey isteğe bağlıdır ve AI, müşteri bahsetmediğinde onu atlayacaktır — garip ekstra sorular yok.
snake_case adları kullanın ve URL'deki herhangi bir {placeholder} token'ıyla tam olarak eşleştirin.
Eksik değerler için davranışı description'da belgeleyin — örn. "Bütçe sınırı yoksa atlayın", "Varsayılan 5".

Çağrı Sonrası Eylemler

Çağrı sonrası eylemler, çağrı sona erdikten ve analiz zinciri özeti, duyguyu ve çıkarılan değişkenleri ürettikten sonra tetiklenir. Çağrı verilerini tüketirler — müşteriyle konuşmazlar.

Mevcut Eylemler

Eylem	Amaç
E-posta Gönder	Ekibinize veya müşteriye yapılandırılmış bir özet e-postası
SMS Gönder	Arayana metin onayı
WhatsApp Gönder	WhatsApp mesajı veya şablonu (24 saatlik pencerenin içinde ve dışında çalışır)
API Çağrısı	Tam çağrı yükünü harici bir API'ye gönderin (CRM, webhook, veri ambarınız)

E-posta Gönder

Ayar	Açıklama
Ad	Gerekli. Eylem tanımlayıcısı
Konu	Gerekli. E-posta konu satırı
Mesaj Gövdesi	Gerekli. E-posta gövdesi — çekme değişkenleri içerebilir
Tetikleyici Koşul	Ne zaman gönderileceği (boş = her zaman)
Alıcılar	Gerekli. E-postayı her zaman alan e-posta adresleri
Koşullu Alıcılar	Koşul-alıcı eşlemesi

E-postada değişkenleri kullanma:

Telefon çağrısından yeni potansiyel müşteri:

Ad: {{customer_name}}
E-posta: {{customer_email}}
İlgilendiği: {{selected_plan}}
Notlar: {{call_notes}}

SMS Gönder

Ayar	Açıklama
Ad	Gerekli. Eylem tanımlayıcısı
Gönderici Adı	Görüntülenen gönderici adı
Mesaj	Gerekli. SMS içeriği (değişkenler içerebilir)
Tetikleyici Koşul	Ne zaman gönderileceği
Alıcılar	Gerekli. SMS'yi her zaman alan telefon numaraları
Koşullu Alıcılar	Koşul-numara eşlemesi

WhatsApp Gönder

HANC'taki WhatsApp mesajlaşması merkezi bir Twilio Content hesabından önceden onaylanmış şablonlar kullanır — bir Template SID'yi elle yapıştırmazsınız. Eylem editörü, şu anda aktif ve onaylanmış her şablonun açılır menüsünü gösterir ve siz birini seçersiniz. Şablon içindeki yer tutucular ({{1}}, {{2}}, …), editörde eşlediğiniz çağrı değişkenlerinden veya statik metinden satır içi doldurulur.

Ayar	Açıklama
Ad	Gerekli. Eylem tanımlayıcısı
Tetikleyici Koşul	Ne zaman gönderileceği
Alıcılar	Gerekli. Mesajı her zaman alan telefon numaraları
Koşullu Alıcılar	Koşul-numara eşlemesi
Şablon	Gerekli. Merkezi Twilio Content hesabından senkronize edilen önceden onaylanmış WhatsApp şablonlarının açılır seçicisi. Her giriş, hangisini seçeceğinizi bilmeniz için şablon adını, dilini ve gövdenin önizlemesini gösterir.
Şablon Değişkenleri	Seçtiğiniz şablon için editör her yer tutucuyu (`{{1}}`, `{{2}}`, …) listeler ve onu bir çağrı değişkenine (aşağıya bakın) veya statik bir dizeye eşlemenize olanak tanır.

Şablon yer tutucularına eşleyebileceğiniz mevcut çağrı değişkenleri:

Değişken	Açıklama
`{{call_from}}`	Arayanın telefon numarası
`{{call_to}}`	Aranan numara
`{{call_summary}}`	AI tarafından oluşturulan çağrı özeti
`{{call_sentiment}}`	Duygu (pozitif/nötr/negatif)
`{{call_task_achieved}}`	Çağrı görevinin başarılıp başarılmadığı
`{{call_transcription}}`	Tam çağrı transkripsiyonu

Neden seçici, serbest metin değil

WhatsApp, 24 saatlik müşteri hizmeti penceresi dışında her işletme tarafından başlatılan mesajın bir önceden onaylanmış şablon kullanmasını gerektirir. HANC, onaylanmış şablonların listesini paylaşılan Twilio Content hesabından senkronize eder, böylece açılır menü her zaman şu anda gönderilmeye uygun olanı tam olarak gösterir — yanlışlıkla bir taslak, reddedilmiş bir şablon veya var olmayan bir SID seçemezsiniz. Yeni bir şablon eklemek için desteğe başvurun; WhatsApp tarafından onaylandığında otomatik olarak açılır menüde görünür.

API Çağrısı

Çağrı sonrası API Çağrı eylemi, yığınınızın geri kalanına genel webhook'unuzdur. Yöntemi seçin, URL'yi ayarlayın ve tüm çağrı yükünü göndereceğiz — uç noktanız neler olduğunu açıklayan yapılandırılmış bir JSON nesnesi alır.

Ayar	Açıklama
Ad	Gerekli. Eylem tanımlayıcısı
Tetikleyici Koşul	Ne zaman tetikleneceği (boş = her çağrı). Transkripsiyona karşı bir LLM tarafından değerlendirilir.
API URL	Gerekli. API uç nokta URL'si
HTTP Yöntemi	Gerekli. `GET`, `POST`, `PUT`, `DELETE`, `PATCH`
Başlıklar	İsteğe bağlı istek başlıkları
Sorgu Parametreleri	İsteğe bağlı sorgu dizesi parametreleri

Uç noktanızın aldığı şey

POST / PUT / PATCH için, uç noktanız istek gövdesinde bir JSON nesnesi alır. Yapılandırılmış gövde parametreleriniz tam çağrı yüküyle birleştirilir:

{
  "call_from": "+431234567890",
  "call_to":   "+439876543210",
  "direction": "inbound",
  "call_type": "phone",
  "call_status": "ended",
  "start_timestamp": 1730000000000,
  "end_timestamp":   1730000187000,
  "duration": 187000,
  "transcription": [
    { "speaker": "agent", "content": "Hello…", "timestamp": 1730000001000 },
    { "speaker": "user",  "content": "Hi…",    "timestamp": 1730000003000 }
  ],
  "call_summary": "Customer asked about pricing…",
  "task_achieved": true,
  "sentiment": { "sentiment": "positive", "explanation": "…" },
  "custom_analysis_data": {
    "name": "John",
    "email": "john@example.com"
  },
  "collected_data": { /* in-call form submissions */ },
  "transfer_history": [ /* if any agent transfer happened */ ],
  "recording_url": "https://…",
  "disconnection_reason": "user_hangup",
  "is_anonymous": false,
  "is_simulation": false,
  "created_at": 1730000000000,
  "updated_at": 1730000187000
}

GET / DELETE için, aynı alanlar sorgu dizesine düzleştirilir — ancak transcription, sentiment ve custom_analysis_data gibi iç içe değerler atlanır (URL'ler yapılandırılmış veriyi mantıklı bir şekilde taşıyamaz). Transkripte ihtiyacınız varsa POST/PUT/PATCH kullanın.

Her istek ayrıca izleme için bir X-Correlation-Id başlığı alır ve 30 saniye sonra zaman aşımına uğrar.

Ön çekme vs Çağrı sonrası API Çağrısı

Önceden çek {phone} vb. öğeleri URL/başlıklar/sorgu/gövdeye şablonlar. Çağrıdan önce, komut dosyasına geri döner.
Çağrı sonrası API Çağrısı tüm çağrı dökümünü gövde veya sorguda gönderir. URL şablonu yok — uç noktanız statik URL + dinamik gövde alır.

Çekme Değişkenleri

Çekme Değişkenleri, AI'nın konuşmalardan otomatik olarak çıkardığı özel veri alanlarıdır. Örneğin, ajan arayanın adını, e-postasını, telefon numarasını veya tanımladığınız herhangi bir başka bilgiyi yakalayabilir.

Varsayılan Değişkenler

Her yeni ajan iki varsayılan çekme değişkeniyle oluşturulur:

Değişken	Tür	Açıklama
E-posta	E-posta	Arayanın e-posta adresi
Telefon	Telefon	Arayanın telefon numarası

Bunlar varsayılan olarak etkindir ve çağrı widget formunda gösterilir. Bunları düzenleyebilir veya kaldırabilir ve kendi özel değişkenlerinizi ekleyebilirsiniz.

Değişken Türleri

Tür	Kullanım Senaryosu	Örnek
Metin	Adlar, adresler, notlar, serbest biçimli giriş	Müşteri adı, teslimat adresi
Sayı	Miktarlar, bütçeler, kimlikler	Sipariş miktarı, bütçe tutarı
E-posta	Doğrulamalı e-posta adresleri	Müşteri e-postası
Telefon	Doğrulamalı telefon numaraları	Müşteri telefon numarası
Seçici	Önceden tanımlanmış seçeneklerden seçim	Tercih edilen plan (Temel/Pro/Enterprise)
Onay Kutusu	Evet/hayır onayı veya doğrulama	"Pazarlama e-postaları almayı kabul ediyorum"

Bir Değişkenin Yapılandırılması

Alan	Açıklama	Örnek
Değişken Adı	Gerekli. Değişken tanımlayıcısı	`customer_email`
AI Talimatları	Gerekli. Bu değeri ne zaman ve nasıl çıkaracağına dair AI için talimatlar	`"Müşterinin e-posta adresi. Sağlanmazsa sorun."`
Örnek Format	(İsteğe bağlı) Beklenen formatın örneği	`"john@example.com"`
Seçenekler (Seçici için)	(Yalnızca Seçici) İzin verilen seçenekler listesi	`["Basic", "Pro", "Enterprise"]`
Formda Göster	Bu alanın çağrı widget formunda görüntülenip görüntülenmeyeceği	Varsayılan olarak etkin

Formda Göster

Formda Göster etkinleştirildiğinde, değişken çağrıdan önce ve çağrı sırasında web widget'ında görünür bir giriş alanı olarak görünür. Bu, arayanların AI'nın konuşmadan çıkarmasının yanı sıra bilgilerini doğrudan doldurmasına olanak tanır.

ipucu

AI, konuşma sırasında eksik bilgileri doğal olarak soracaktır. "Müşterinin e-posta adresi, sağlanmazsa kibarca sorun" gibi net bir açıklama ayarlayın ve ajan bunu halledecektir.

Araç ve Eylem Ekleme

Ajanınızın Eylemler sekmesine gidin.
Araç Ekle'ye tıklayın.
Açılır menüden doğru aşamayı seçin — Önceden çek, Canlı çağrı veya Çağrı sonrası.
Ayarları yapılandırın.
Kaydedin — değişiklikler bir sonraki çağrıda uygulanır.

Tüm girişler Eylemler tablosunda birlikte listelenir. Düzenlemek için herhangi bir satıra tıklayın veya silmek için çöp kutusu simgesini kullanın.

İlgili

AI Sesli Ajanlar Genel Bakış
Komut Dosyası Mühendisliği — Komut dosyanızda araçlara başvurun
Bilgi Tabanı — Bilgi kaynakları
Entegrasyonlar — Araçlarınızın konuşabileceği harici sistemler

Üç Aşama​

Önceden Çek​

Ne zaman kullanılır​

Nasıl çalışır​

Yapılandırma​

Mevcut değişkenler​

Komut dosyasına ne girer​

Önemli kısıtlamalar​

Canlı Çağrı Araçları​

Mevcut Araçlar​

Çağrı Yönlendirme​

Google Calendar​

Outlook Calendar​

Ajan Aktarımı​

HubSpot CRM​

MCP sunucuları​

API Tool RAG​

Body Parameters Schema Yazma​

Minimum yapı​

Alan referansı​

Örnekler​

AI sesli ajanlar için en iyi uygulamalar​

Çağrı Sonrası Eylemler​

Mevcut Eylemler​

E-posta Gönder​

SMS Gönder​

WhatsApp Gönder​

API Çağrısı​

Uç noktanızın aldığı şey​

Çekme Değişkenleri​

Varsayılan Değişkenler​

Değişken Türleri​

Bir Değişkenin Yapılandırılması​

Formda Göster​

Araç ve Eylem Ekleme​

İlgili​

Üç Aşama

Önceden Çek

Ne zaman kullanılır

Nasıl çalışır

Yapılandırma

Mevcut değişkenler

Komut dosyasına ne girer

Önemli kısıtlamalar

Canlı Çağrı Araçları

Mevcut Araçlar

Çağrı Yönlendirme

Google Calendar

Outlook Calendar

Ajan Aktarımı

HubSpot CRM

MCP sunucuları

API Tool RAG

Body Parameters Schema Yazma

Minimum yapı

Alan referansı

Örnekler

AI sesli ajanlar için en iyi uygulamalar

Çağrı Sonrası Eylemler

Mevcut Eylemler

E-posta Gönder

SMS Gönder

WhatsApp Gönder

API Çağrısı

Uç noktanızın aldığı şey

Çekme Değişkenleri

Varsayılan Değişkenler

Değişken Türleri

Bir Değişkenin Yapılandırılması

Formda Göster

Araç ve Eylem Ekleme

İlgili