Tek platform. Üç güçlü yüzey.

5 dakikada ilk isteğiniz

Tüm yüzeyler için tek ön koşul var: panelin Geliştirici sayfasından bir API anahtarı üretmek. Anahtarınızı aldıktan sonra REST ile veri çekebilir, webhook tanımlayabilir, widget'ı yönetebilirsiniz.

Bearer anahtarıyla imzalayın

Tüm REST isteklerine anahtarınızı Authorization başlığıyla ekleyin. Anahtarlar rc_live_ önekiyle başlar ve yalnızca oluşturulduğu an bir kez gösterilir — güvenli bir yerde saklayın.

curl https://revochat.app/api/v1/conversations \
  -H "Authorization: Bearer rc_live_XXXXXXXXXXXX"

Verilerinize programatik erişim

Temel URL: https://revochat.app/api/v1

curl "https://revochat.app/api/v1/conversations?status=open&limit=20" \
  -H "Authorization: Bearer rc_live_..."

Olaylar gerçekleştiği an sizde

Panelden bir webhook URL'i tanımlayın; seçtiğiniz olaylar gerçekleştiği an JSON gövdeyle POST edilir. Her istekte iki başlık bulunur: X-RevoChat-Event (olay adı) ve webhook sırrınızla üretilen X-RevoChat-Signature (ham gövdenin HMAC-SHA256 imzası) — doğrulamadan işlemeyin. Gövde şekli: { event, createdAt, data }. Teslimat 5 sn zaman aşımıyla yapılır; yanıtınızı hızlı döndürün.

const crypto = require("crypto");
const expected = crypto
  .createHmac("sha256", process.env.WEBHOOK_SECRET)
  .update(rawBody) // ham gövde — JSON.parse ETMEDEN
  .digest("hex");
if (expected !== req.headers["x-revochat-signature"]) return res.status(401).end();

Balonun tam kontrolü sizde

Kurulum script'i yüklendikten sonra window.RevoChat nesnesi hazırdır:

RevoChat.open();                    // paneli aç
RevoChat.close();                   // paneli kapat
RevoChat.toggle();                  // aç/kapa
RevoChat.isOpen();                  // açık mı? (boolean)

RevoChat.identify({                 // ziyaretçiyi tanıt
  name: "Ayşe Yılmaz",
  email: "[email protected]",
});

RevoChat.on("ready", () => {});     // widget yüklendi
RevoChat.on("open", () => {});      // panel açıldı
RevoChat.on("close", () => {});     // panel kapandı
RevoChat.on("message", (m) => {});  // yeni mesaj ({ sender, content, type })

Script etiketine data-lang="en" ekleyerek widget dilini sayfa bazında ezebilirsiniz (tr / en / de / es). Eski gömme kodlarındaki data-canli-destek özniteliği de desteklenmeye devam eder.

Sohbeti ciroya bağlayın

Sipariş onay sayfanıza tek satır ekleyin; satış, ziyaretçinin son konuşmasına bağlanır ve analitikte "sohbet atıflı ciro" olarak raporlanır.

RevoChat.track("purchase", {
  orderId: "SIP-1042",   // isteğe bağlı
  amount: 1299.9,        // zorunlu (sayı)
  currency: "TRY",       // varsayılan: TRY
});

Şimdilik desteklenen tek olay purchase'tır; satış, ziyaretçinin en son konuşmasına atanır.