Geri Arama Widget'ı
Geri Arama Widget'ı, web sitesi ziyaretçilerinizin telefon numaralarını bırakıp AI ajanınızdan geri arama almasına olanak tanıyan, gömülebilir küçük bir formdur — genellikle saniyeler içinde. Ziyaretçilerden sizi aramalarını istemek yerine, konuşma onlara gelir.
Bu, Floating, Pill, Inline ve Popup widget'larının yanındaki beşinci widget türüdür — ancak çok farklı çalışır. Diğer widget'lar tarayıcıda sesli konuşma başlatır. Geri Arama Widget'ı ise, ajanınızın çıkış numaranız üzerinden yaptığı gerçek bir telefon çağrısını sıraya alır.
Ne Zaman Kullanılır
| Senaryo | Geri Arama Widget'ı Neden Uygun |
|---|---|
| Lead-gen açılış sayfaları | Ziyaretçi bir telefon numarasıyla taahhütte bulunur, ajan bir dakika içinde onu nitelendirir |
| Yüksek niyetli ürün sayfaları | Ziyaretçiyi numara çevirmeye zorlamadan "Bir uzmanla görüş" |
| Mobil öncelikli siteler | Pill üzerine tek dokunuş, izin istemi yok, kulaklık gerekmez |
| Mesai dışı kapsama | Ziyaretçi mesai dışında numarasını bırakır, sıra açıldığında ajan arar |
| Formlara kıyasla daha az sürtünme | Ziyaretçiler tek bir alan gönderir ve anında yanıt alır |
Uygunluk
Geri Arama Widget'ı etkinleştirilmeden önce hesabınızda üç şey gereklidir:
| Gereksinim | Neden |
|---|---|
| Ücretli plan (Starter veya üzeri) | Geri arama sırasında tüketilen çıkış dakikaları dakika başına faturalandırılır |
| Ajana atanmış doğrulanmış çıkış telefon numarası | Ajanın arama yapacağı gerçek bir numaraya ihtiyacı vardır |
| Çalışma alanınızda doğrulanmış e-posta | Çıkış çağrıları açılmadan önce sahipliği doğrular |
Bunlardan herhangi biri eksikse, ajanın Widgets sekmesindeki Callback widget bölümü, neyi düzeltmeniz gerektiğini tam olarak söyleyen bir uyarı gösterir. Widget, üçü de yerine getirilene kadar devre dışı kalır.
Geri Arama Widget'ı, çıkış telefon çağrıları yaptığı için Ücretsiz planda mevcut değildir. Diğer tüm widget türleri (Floating, Pill, Inline) ücretsiz kalır.
Kurulum
1. Ajanda geri aramayı etkinleştir
- Ajanınızı açın ve Widgets sekmesine gidin.
- Callback widget bölümüne kaydırın.
- "Enable callback widget" geçişini açın.
- Yapılandırın:
- Yeniden deneme sayısı — ziyaretçi cevap vermezse ajanın kaç kez yeniden deneyeceği (1–5, varsayılan 3).
- Yeniden deneme aralığı — denemeler arası dakika (1–30, varsayılan 5).
- Widget dili — formun, durum mesajlarının ve ülke seçicinin ziyaretçinize hitap edeceği dil (14 dil mevcut — aşağıya bakın).
- Tema — floating pill ve diyalog için renk şeması (diğer widget'larla aynı tema paletini kullanır).
- Kaydedin.
Ayarların yanında widget'ın canlı önizlemesi belirir, böylece değişikliklerinizi anında görebilirsiniz — görünüşü test etmek için dağıtıma gerek yoktur.
2. Gömme parçacığını kopyalayın
Aynı bölümde HTML parçacığını kopyalayın:
<hanc-ai-callback agent-id="YOUR_AGENT_ID"></hanc-ai-callback>
<script src="https://unpkg.com/hanc-webrtc-widgets@latest" async type="text/javascript"></script>
Bunu web sitenize bir kez yapıştırın, tipik olarak </body> etiketinden hemen önce. Widget, sayfanın köşesinde floating pill olarak görünür.
@latest etiketi, sitenizin yayınlandıklarında yeni widget sürümlerini otomatik olarak almasını sağlar. Yükseltmeler üzerinde tam kontrol istiyorsanız belirli bir sürüme sabitleyin (örn. hanc-webrtc-widgets@1.4.0).
Ziyaretçinin Gördükleri
Widget, ziyaretçileri dört durumdan geçirir:
| Durum | Ziyaretçinin Gördükleri |
|---|---|
| Form | Köşede floating pill. Açmak için tıklayın. Solda ülke seçici, sağda telefon girişi, gönder düğmesi. |
| Sırada | "Sıradasınız — sizi aramamıza yaklaşık N saniye." Canlı olarak güncellenir. |
| Aranıyor | "Sizi şimdi arıyoruz." Çağrı bağlanana veya başarısız olana kadar kalır. |
| Tamamlandı / Başarısız | Kısa bir onay veya "başka bir geri arama yapmak için sayfayı yeniden yükleyin" ipucu içeren samimi bir hata. |
Form, telefon numarasını seçilen ülkenin ulusal formatına göre otomatik doğrular ve numara makul olmadıkça göndermeyi reddeder.
Ülke kapsamı
Ülke seçici, Avrupa'yı (AB + DACH + Birleşik Krallık), Kuzey Amerika'yı (ABD + Kanada) ve geniş çapta desteklenen ek ülkelerden seçilmiş bir grubu kapsar. Her ülke bayrağını, adını ve ziyaretçinin ne yazacağını bilmesi için ana formatta örnek bir yer tutucuyu gösterir.
Ziyaretçilerinizin kullandığı bir ülke listede yoksa, support@hanc.ai ile iletişime geçin — kapsam düzenli olarak genişletilir.
HTML Öznitelikleri
Widget, <hanc-ai-callback> etiketinde şu öznitelikleri kabul eder:
| Öznitelik | Gerekli | Açıklama |
|---|---|---|
agent-id | Evet | Ajanınızın benzersiz tanımlayıcısı |
locale | Hayır | Bu sayfa için widget'ın UI dilini geçersiz kıl (örn. locale="de"). Siteniz çok dilliyse ve sayfa yerel ayarı ajanın varsayılanıyla eşleşmiyorsa kullanışlıdır. |
theme | Hayır | Bu sayfa için renk temasını geçersiz kıl |
position | Hayır | Floating pill'in nereye sabitleneceği (bottom-right, bottom-left, top-right, top-left) |
Bıraktığınız her şey, ajanı pano üzerinden yapılandırdığınız değerlere geri döner.
Örnek: Çok dilli bir sitede Almanca sayfa
<hanc-ai-callback agent-id="YOUR_AGENT_ID" locale="de"></hanc-ai-callback>
<script src="https://unpkg.com/hanc-webrtc-widgets@latest" async></script>
Pill metni, diyalog etiketleri, ülke seçici ve durum mesajlarının tümü Almancaya geçer. Ajanın kendisi yine yapılandırıldığı dilde konuşur — locale yalnızca ziyaretçinin sayfada okuduklarını etkiler.
Widget Dili
Widget UI'ı, 14 yerleşik dille birlikte gelir:
| Kod | Dil |
|---|---|
en | English |
de | Deutsch |
fr | Français |
es | Español |
it | Italiano |
pt | Português |
pl | Polski |
cs | Čeština |
hu | Magyar |
tr | Türkçe |
kk | Қазақша |
zh | 中文 |
ru | Русский |
uk | Українська |
Ajan dilini, öncelik sırasına göre üç yerden seçer:
- Gömmedeki
locale="…"özniteliği (en yüksek öncelik) - Ajanın Widgets sekmesinde ayarlanan Widget dili
- İngilizce (varsayılan)
Widget dili, yalnızca ziyaretçinin okuduğu ekran metnini etkiler — etiketler, ülke seçici, durum mesajları. Asıl sesli konuşma, ajanınızın konuşmak üzere yapılandırıldığı dilde gerçekleşir.
Yeniden Deneme Davranışı
Ziyaretçi ilk denemede cevap vermezse, ajan yapılandırılan aralığı bekler ve tekrar arar — yapılandırılan deneme sayısına kadar.
- Denemeler: 1–5 (varsayılan 3)
- Aralık: 1–30 dakika (varsayılan 5)
Widget, ziyaretçiye her denemenin durumunu gösterir. Tüm denemeler başarısız olduktan sonra, widget kibar bir mesajla "size ulaşamadık" durumuna geçer.
Beş dakika aralıkla üç deneme, çoğu lead-gen sayfası için iyi çalışır — ziyaretçinin hâlâ göz attığı kadar hızlı, baskıcı hissettirmeyecek kadar yumuşak. Hedef kitleniz bilinmeyen numaraları görmezden gelme eğilimindeyse artırın.
Sayfa Yükleme Başına Bir Geri Arama
Bir ziyaretçi numarasını gönderdiğinde, widget kendisini o sayfa ömrünün geri kalanı için kilitler:
- Diyaloğu kapatmak, pill'i daraltır ancak formu sıfırlamaz.
- Yeniden açmak, taze bir form değil mevcut durumu (sırada / arıyor / tamamlandı / başarısız) gösterir.
- İkinci bir geri arama yapmak için, ziyaretçinin sayfayı yeniden yüklemesi gerekir.
Bu, bir çağrı zaten yoldayken kazara çift gönderimi önler. Ziyaretçi, diyalogdan sıraya alınmış geri aramasını açıkça iptal ederse (sıraya alınmış ekrandaki "İptal" düğmesi), kilit serbest bırakılır ve hemen yeniden gönderebilirler.
Geri arama sırasında yeniden yüklerlerse ne olur?
Bir ziyaretçi, ajan numaralarını hâlâ yeniden denerken sayfayı yeniden yüklerse, widget aynı numara için aktif bir geri aramanın zaten var olduğunu algılar ve sessizce ona yeniden bağlanır — çift arama yok, ikinci sıra girişi yok. Ziyaretçi yalnızca mevcut durumunun kaldığı yerden devam ettiğini görür.
Eşzamanlılık ve İş Hacmi
Tek bir ajan, aynı anda uçuşta 10 geri aramaya kadar sahip olabilir. Bunun ötesindeki gönderimler sırada bekler ve kapasite serbest kaldıkça aranır.
Ajan-serbest-bırak-sonra-ara döngüsü kuyruğu sürekli boşaltır — eşzamanlılık sınırına yakın değilseniz, çoğu ziyaretçi gönderdikten birkaç saniye sonra aranır.
Kötüye kullanımı önlemek için numara başına oran sınırı vardır (aynı ajan için bir numara saatte yalnızca birkaç kez sıraya alınabilir). Bu sınıra ulaşan ziyaretçiler, sıraya alınmış ekran yerine samimi bir "kısa süre içinde sizinle iletişime geçeceğiz" mesajı görür.
Panoda Canlı Önizleme
Widgets sekmesi, ayarların yanında geri arama widget'ının canlı önizlemesini gösterir. Yaptığınız herhangi bir değişiklik — tema, dil, yeniden deneme sayıları — önizlemeyi anında günceller. Widget'ın nasıl görüneceğini görmek için sitenizi dağıtmak zorunda değilsiniz.
Önizleme, tam ülke listesi ve demo uygunluğu içeren bir sahte manifest kullanır, böylece widget, çıkış geri aramalarının henüz mevcut olmadığı planlarda bile oluşturulur.
Gömülü İzleme
Widget, diğer widget'larla aynı call-start ve call-end olaylarını yayınlar. Kendi analitiklerinizi tetiklemek istiyorsanız JavaScript'te dinleyin:
const widget = document.querySelector('hanc-ai-callback');
widget.addEventListener('call-start', () => {
// Ziyaretçinin geri araması az önce bağlandı — dönüşüm olarak izle
});
widget.addEventListener('call-end', () => {
// Geri arama bitti — süreyi, sonucu vb. izle
});
Plan Kullanılabilirliği
| Plan | Geri Arama Widget'ı |
|---|---|
| Free | Kullanılamaz (çıkış araması gerektirir) |
| Starter / Pro / Business / Enterprise | Kullanılabilir |
Tüm ücretli planlar aynı widget özellik setini alır. Çağrı başına maliyet, normal çıkış oranınızı takip eder — bkz. Faturalama.
İlgili
- Web Sitesi Widget'ları — Tarayıcı içi konuşmalar için Floating, Pill, Inline ve Popup widget türleri
- Ayarlar — Geri aramaları da sınırlayan Maksimum Çağrı Süresi dahil ajan düzeyi çağrı ayarları
- Telefon Numaraları — Geri arama widget'ınızın arayacağı çıkış numarasını bağlayın
- SSS — Yaygın sorular ve uç durumlar