Geliştirici entegrasyonu

Venanto'yu müşteri sitesine ekleyin destek döngüsüne girmeden.

Web widget'ı, WordPress eklentisini veya REST API'yi kullanın. API anahtarları backend'inizde kalır; WordPress Connect Venanto ile bağlanır, özel tarayıcı widget'ları ise iptal edilebilir kurulum anahtarları kullanır.

API anahtarı oluştur OpenAPI JSON

Hızlı seçim

İşe yarayan en küçük entegrasyonu seçin.

Statik veya özel web sitesi Zorluk: Orta

Bir kurulum anahtarı oluşturun, tek script etiketini ekleyin ve canlı domain üzerinden test edin.

Ekibiniz site kodunu düzenleyip canlı domaini birebir onaylayabiliyorsa en uygun yol.

<script src="https://venanto.com/static/widget.js" data-bot-id="BOT_ID" data-install-key="YOUR_INSTALL_KEY"></script>

WordPress Zorluk: Kolay

Eklentiyi kurun, WordPress ayarlarında Connect Venanto'ya tıklayın, giriş yapın ve site için asistanı seçin.

Müşteride WordPress admin erişimi varsa ve en az manuel adımı istiyorsa en uygun yol.

https://venanto.com/static/downloads/vilrio-chat.zip?v=0.2.6

Özel uygulama veya backend Zorluk: İleri

API anahtarını sunucu tarafında tutun ve kendi servisinizden `/api/v1/chat` çağırın.

Kimlik doğrulama, sunucu çağrıları, loglama ve yayın testini bir geliştirici üstleniyorsa en uygun yol.

Authorization: Bearer YOUR_VILRIO_KEY

We set it up for you Difficulty: None for you

Hand it over with a setup request — FAQ cleanup, theme matching, hosting access, cPanel, SSH, or private system work.

Müşterinin yayın desteğine ihtiyacı varsa veya erişim yolu standart değilse en uygun yol.

Console > Channels > Setup request

Web widget

Sınırlı bir kurulum anahtarı oluşturun.

Use an API key from Console > Tools. `allowed_origin` should be the exact browser origin that will host the widget.

curl -X POST https://venanto.com/api/v1/install-keys \
  -H "Authorization: Bearer YOUR_VILRIO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bot_id": 123,
    "label": "Main website",
    "allowed_origin": "https://www.example.com"
  }'

Yanıt; özel siteler için tek kullanımlık kurulum anahtarını, widget kodunu ve script URL'sini içerir.

WordPress

En az hareketli parçayla kurulum yapmak istediğinizde eklentiyi kullanın.

`vilrio-chat.zip` dosyasını konsoldan veya `/static/downloads/vilrio-chat.zip?v=0.2.6` yolundan indirin.
WordPress Eklentiler bölümünden yükleyin ve `Venanto Chat` eklentisini etkinleştirin.
Open Settings > Venanto Chat and click `Connect Venanto`.
Venanto'ya giriş yapın, bu site için botu seçin ve WordPress'e geri dönün.
Başlığı, vurgu rengini, önerileri ve sohbetin otomatik açılıp açılmayacağını seçin.
Canlı sitede bir test mesajı gönderin ve Venanto'da kurulum aktivitesini kontrol edin.

Manuel bağlantı alanları eklenti içinde yalnızca gelişmiş bir yedek seçenek olarak kalır.

REST API

Backend sohbeti aynı botu, bilgiyi, araçları ve denetim geçmişini kullanır.

`Authorization: Bearer YOUR_VILRIO_KEY` kullanımını tercih edin. Mevcut sunucu entegrasyonları `X-Venanto-Api-Key: YOUR_VILRIO_KEY` başlığını da gönderebilir. Entegrasyona yetecek en dar yetkili anahtarı oluşturun.

curl -X POST https://venanto.com/api/v1/chat \
  -H "Authorization: Bearer YOUR_VILRIO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bot_id": 123,
    "message": "What are your hours?",
    "external_user_ref": "customer-42"
  }'

Endpoint	Kullanım amacı
GET /api/v1/integration-guide	Makine tarafından okunabilir hızlı başlangıç metadatası.
GET /api/v1/bots	Çalışma alanındaki bot ID'lerini bulun.
POST /api/v1/install-keys	Özel web sitesi için sınırlı kurulum anahtarı oluşturun.
POST /api/v1/chat	Backend tarafından yönetilen sohbet mesajları gönderin.
POST /api/v1/knowledge	Metin, SSS, politika veya hizmet içeriğini indeksleyin.
POST /api/v1/answer-test	Yayından önce hangi kaynak bölümlerinin bir soruyu yanıtladığını kontrol edin.

Mevcut API izinleri bot arama, kurulum anahtarı oluşturma, sohbet, bilgi güncelleme ve cevap testini kapsar.

Bilgi

Önce indeksleyin, sonra cevapları test edin, ardından yayınlayın.

curl -X POST https://venanto.com/api/v1/knowledge \
  -H "Authorization: Bearer YOUR_VILRIO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bot_id": 123,
    "title": "Service FAQ",
    "content": "Emergency requests should be handed to staff immediately.",
    "source_type": "api"
  }'

curl -X POST https://venanto.com/api/v1/answer-test \
  -H "Authorization: Bearer YOUR_VILRIO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bot_id":123,"query":"What happens in an emergency?"}'

Güvenlik sınırı

Güçlü kimlik bilgilerini tarayıcılardan uzak tutun.

API anahtarlarını yalnızca sunucularda kullanın

Venanto API anahtarları botları listeleyebilir, sohbet çağırabilir, bilgiyi indeksleyebilir ve kurulum anahtarları oluşturabilir. Bunları JavaScript, WordPress veya mobil uygulama içine koymayın.

Herkese açık yüzeylerde kurulum anahtarı kullanın

Kurulum anahtarları tek botla sınırlıdır; origin'e kilitlenebilir, izlenebilir ve hesap API anahtarını döndürmeden iptal edilebilir.

Setup help has a clear scope

Theme matching, knowledge preparation, hosting access, and custom CRM work are handled as a setup request with a defined scope and price up front.

Kurulum formlarında sır göndermeyin

Formları erişim yöntemi ve gizli olmayan bağlam için kullanın. Parolalar, özel kimlik bilgileri ve erişim kodları ayrı bir güvenli aktarım gerektirir.