Widget: siteye tek satırla sohbet balonu

Tek script etiketiyle asistanınız sitenizde sohbet balonuna dönüşür. Renk, konum, karşılama, alan adı kısıtı ve sesli mod ayarları.

Güncellendi: 17 Ağustos 2026

Widget, telefonu açan asistanın tarayıcıda çalışan hâlidir. Sitenizin her sayfasına tek satır JavaScript eklersiniz.

30 saniyelik kurulum

1Panel → Widget’lar → Yeni Widget.
2Hangi asistanı kullanacağını seçin — mevcut sesli asistanınız uygundur.
3Renk, konum ve karşılama mesajını ayarlayın.
4Kaydedin ve gösterilen kod parçasını kopyalayın.
5Kodu sitenizde </body> etiketinden hemen önce yapıştırın.
6Sayfayı yenileyin — sohbet balonu görünür. Tıklayın, mesaj yazın, asistan cevaplar.

<script src="https://api.call2me.app/v1/widgets/widget_xxxxx/embed.js" async></script>

Özelleştirme

Ayar	Varsayılan	Ne yapar
greeting_message	"Merhaba! Nasıl yardımcı olabilirim?"	Balon açıldığında görünen ilk mesaj
placeholder_text	"Bir mesaj yazın..."	Giriş alanındaki ipucu metni
primary_color	#6366f1	Balon ve mesaj arka planı rengi
position	bottom-right	bottom-right veya bottom-left
language	tr-TR	Widget arayüz dili
auto_open	kapalı	Belirli süre sonra kendiliğinden açılsın mı
auto_open_delay_ms	3000	Otomatik açılma gecikmesi
avatar_url	yok	Balonda görünecek görsel
show_branding	açık	Alt kısımdaki platform imzası
allowed_domains	yok	Widget’ın çalışmasına izin verilen alan adları

allowed_domains alanını mutlaka doldurun. Boş bırakırsanız widget kodunuzu kopyalayan biri kendi sitesinde çalıştırabilir ve mesaj ücretleri sizin cüzdanınızdan düşer. Kendi alan adlarınızı yazmak bir dakikalık iştir.

Sesli mod

Widget yalnızca yazı değil, tarayıcıdan sesli görüşme de sunabilir. voice_mode alanı üç değer alır.

voice_mode	Davranış
chat	Sadece yazılı sohbet (varsayılan)
voice	Sadece sesli görüşme — mikrofon izniyle canlı konuşma
both	Kullanıcı yazıyla mı sesle mi konuşacağına kendi karar verir

Sesli modda voice_session_limit_sec ile tek oturumun üst sınırını belirlersiniz (varsayılan 300 saniye). Sesli görüşmenin ücreti widget sahibinin cüzdanından düşer — kullanıcı ödeme yapmaz.

voice_greeting_enabled açıksa karşılama mesajı sesli olarak da okunur. Karşılama sesi önceden üretilip saklanır, her ziyaretçide yeniden sentezlenmez.

Fiyatlandırma

Yazılı sohbet mesaj başına $0.01. Sesli görüşme dakika bazlı sesli tarifeyle işler; telefon hattı kalemi oluşmadığı için telefon aramasından ucuzdur.

Hacim	Yazılı maliyet
100 görüşme × 6 mesaj	$6
1.000 görüşme × 8 mesaj	$80
10.000 görüşme × 10 mesaj	$1.000

Aynı asistan, iki kanal

Widget mevcut sesli asistanınızı yeniden kullanır. Ortak olanlar:

Sistem talimatı — kişilik ve kurallar birebir aynı.
Bilgi tabanı — cevaplar aynı parçalardan gelir.
Arama sonrası çıkarım — aynı yapılandırılmış alanlar sohbette de doldurulur.
Webhook — aynı sisteminiz veriyi alır.
Fonksiyonlar — aynı araçlar çağrılır.

İki ayrı asistan bakmanız gerekmez; bir yerde güncelleme her iki kanala yansır.

Sayfa başına farklı asistan

Bazı siteler farklı sayfalarda farklı asistan ister — /fiyatlandirma sayfasında satış, /destek sayfasında destek asistanı. Çözüm basit: her biri farklı asistana bağlı birden çok widget oluşturun ve sayfaya göre doğru script’i ekleyin.

Hesaba özel konular — widget’ın bağlı olmadığı veritabanı sorguları gerektiren durumlar.
İade, iptal, ücret iadesi — asistan kabul etsin, ama insana devretsin.
Hukuki sonuç doğuran her şey — doğrudan insana.

Devir yolu: asistan çözemediğini söylediğinde webhook tetiklenir, ekibiniz görüşmeyi devralır. Döküm devirle birlikte gider.

API uçları

Panel yerine doğrudan API kullanmak isterseniz ilgili uçlar şunlar:

Uç	Erişim	Ne döner
GET /v1/widgets/{id}/embed.js	Herkese açık	Widget çalışma zamanı JavaScript’i
GET /v1/widgets/{id}/config	Herkese açık	Widget yapılandırması
POST /v1/widgets/{id}/chat	Herkese açık	Mesaj gönderip cevap alır
POST /v1/widgets/{id}/voice-token	Herkese açık	Sesli görüşme için oturum token’ı
GET /v1/widgets/{id}/preview	Herkese açık	Widget’ı tek başına önizler
GET /v1/widgets/{id}/sessions	API anahtarı	Görüşme listesi

# Widget oluştur
curl -X POST https://api.call2me.app/v1/widgets \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent_abc123",
    "name": "Site destek balonu",
    "greeting_message": "Merhaba! Randevu için mi arıyorsunuz?",
    "primary_color": "#0f766e",
    "language": "tr-TR",
    "voice_mode": "both",
    "voice_session_limit_sec": 300,
    "allowed_domains": ["ornek.com.tr", "www.ornek.com.tr"]
  }'

Sohbet API’si

Sık sorulanlar

Widget’ı siteme nasıl eklerim?

Panelde widget oluşturun, gösterilen tek satırlık script etiketini kopyalayın ve sitenizde </body> etiketinden önce yapıştırın. Bu kadar.

Widget ne kadara geliyor?

Yazılı mesaj başına $0.01. Bin görüşme × sekiz mesaj yaklaşık $80 eder. Sesli mod açıksa sesli görüşmeler dakika bazlı tarifeyle işler ve telefon hattı ücreti oluşmaz.

Widget telefonda kullandığım asistanı kullanabilir mi?

Evet. Widget aynı sesli asistanı kullanır — aynı talimat, aynı bilgi tabanı, aynı çıkarım alanları. Tek kişilik, iki kanal.

Widget’ta sesli konuşma var mı?

Var. voice_mode alanını voice veya both yaparsanız ziyaretçi mikrofonuyla asistanla canlı konuşabilir. Oturum süresi voice_session_limit_sec ile sınırlanır ve ücret widget sahibinin cüzdanından düşer.

Başkası widget kodumu kopyalayıp kullanabilir mi?

allowed_domains alanını boş bıraktıysanız evet — ve ücret sizin cüzdanınızdan düşer. Kendi alan adlarınızı bu listeye yazarak widget’ın yalnızca sizin sitenizde çalışmasını sağlayın.

850santral