Merchant API ve entegrasyon — Chatvia geliştiriciler

Her işletmenin kendi merchant anahtarı.

Anahtar, Chatvia hesabı açıldığında oluşturulur. İşletme sahibi veya yöneticisi panelde Entegrasyonlar bölümünden görüntüleyebilir. API isteklerinde Authorization: Bearer MERCHANT_KEY başlığını kullanın. Anahtarı URL’ye eklemeyin.

Authorization: Bearer cv_live_SIZIN_GIZLI_ANAHTARINIZ
Accept: application/json
Content-Type: application/json

API adresi: https://chatvia.com.tr/api/v1. Merchant API yalnızca mağaza bağlantısını yönetir; mesaj geçmişine veya panel oturumuna erişim vermez.

Marvigo’da bir kez girilen anahtar, otomatik kurulum.

Mağaza sahibi Marvigo panelinde Entegrasyonlar → Chatvia bölümüne merchant anahtarını girer.
Marvigo sunucusu oturum, mağaza sahipliği ve CSRF kontrolünü yapar. Mağaza kimliği ve alan adını kendi veritabanından okur.
Sunucu GET /merchant ile anahtarı doğrular; ardından POST /integrations/marvigo/connect ile mağazayı bağlar.
Dönen widget.website_id kaydedilir. Merchant anahtarı yalnızca sunucuda şifrelenerek saklanır.
Vitrin teması açık site koduyla sohbet yükleyicisini ekler. Mağaza sahibi görüşmeleri Chatvia panelinden yanıtlar.

Chatvia API’si ve örnek istemci hazırdır. Marvigo’nun kendi panel ve tema akışına bağlanacak kodun nerelere eklenmesi gerektiği ZIP paketinde açıklanır.

Bağlantı uçları

Yöntem	Uç	Görev
GET	`/merchant`	İşletmeyi ve ücretsiz planı doğrula
POST	`/integrations/{provider}/connect`	Mağazayı bağla / tekrar etkinleştir
GET	`/integrations/{provider}/stores/{store_id}`	Bağlantı durumunu oku
DELETE	`/integrations/{provider}/stores/{store_id}`	Bağlantıyı kes

Marvigo için provider=marvigo. Kendi altyapınız için custom veya platformunuza özel sabit bir kod kullanabilirsiniz. Aynı platform ve mağaza kimliği tekrar gönderildiğinde kayıt çoğalmaz.

Bağlama isteği

POST https://chatvia.com.tr/api/v1/integrations/marvigo/connect

{
  "store_id": "marvigo-1042",
  "store_name": "Örnek Mağaza",
  "store_url": "https://magazam.example.com"
}

İlk bağlantı 201, tekrar bağlantı 200 döndürür. store_id platform içinde benzersiz ve sabit olmalı; alan adı değişse de değiştirilmemelidir. store_url HTTPS kullanmalı ve yalnızca site kökünü içermelidir.

{
  "status": "connected",
  "already_connected": false,
  "widget": {
    "script_url": "https://chatvia.com.tr/embed.js?v=1.1.0",
    "website_id": "site_...",
    "embed_html": "<script ...></script>"
  },
  "dashboard_url": "https://chatvia.com.tr/app"
}

Buradaki yanıt kısaltılmıştır; tam şema ve hata yanıtları OpenAPI dosyasındadır. Anahtar geçersizse 401, mağaza başka bir hesaba bağlıysa 409, veri geçersizse 422, hız sınırı aşılırsa 429 döner.

Gizli anahtar ve açık site kodu farklıdır.

Merchant anahtarı yalnızca sunucu tarafında tutulur. Site kodu ziyaretçinin gördüğü HTML’de yer alabilir. Birini diğerinin yerine kullanmayın. API, işletmeler arasındaki bağlantıları sunucuda sınırlar.

Anahtar yenilendiğinde eski anahtar API isteklerinde geçersiz olur. Mevcut sohbet kodları çalışmaya devam eder. Bağlantı kesildiğinde, aynı site için başka aktif API bağlantısı kalmamışsa sitenin sohbeti de kapatılır. Yeniden bağlama aynı site kodunu etkinleştirir.

API sürümünde bağlama ve durum istekleri anahtar başına dakikada 120; IP başına dakikada 300 istekle sınırlıdır. Sürekli sorgulama yerine bağlantı ayarı kaydedilirken çağırın. Durum kontrolünü makul aralıklarla önbelleğe alın.

Uygulamaya hazır doküman ve örnekler.

Chatvia Entegrasyon API v1

Türkçe rehber · OpenAPI · PHP istemcisi · Node.js örneği · Marvigo bağlama akışı

ZIP’i indir ↓

OpenAPI JSON dosyasını aç ↗

Paket gerçek merchant anahtarı veya müşteri verisi içermez. Her mağaza sahibinin kendi Chatvia anahtarı kullanılmalıdır. Eski, ortak sır kullanan /integrations/marvigo/install ucu kaldırılmıştır; yeni bağlantılarda /connect kullanın.

Sizin altyapınız.Chatvia’nın sohbeti.