Eine Plattform. Drei starke Schnittstellen.

Ihre erste Anfrage in 5 Minuten

Für jede Schnittstelle gibt es eine Voraussetzung: Erstellen Sie auf der Seite Entwickler Ihres Dashboards einen API-Schlüssel. Damit können Sie Daten per REST abrufen, Webhooks einrichten und das Widget steuern.

Authentifizierung mit einem Bearer-Schlüssel

Fügen Sie Ihren Schlüssel jeder REST-Anfrage im Header Authorization hinzu. Schlüssel beginnen mit dem Präfix rc_live_ und werden nur einmal bei der Erstellung angezeigt – bewahren Sie Ihren sicher auf.

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

Programmatischer Zugriff auf Ihre Daten

Basis-URL: https://revochat.app/api/v1

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

Ereignisse in Ihren Händen, sobald sie eintreten

Legen Sie in Ihrem Dashboard eine Webhook-URL fest; die gewählten Ereignisse werden in dem Moment, in dem sie eintreten, als POST mit JSON-Body gesendet. Jede Anfrage enthält zwei Header: X-RevoChat-Event (der Ereignisname) und X-RevoChat-Signature (eine HMAC-SHA256-Signatur des Roh-Bodys, erstellt mit Ihrem Webhook-Secret) – prüfen Sie diese vor der Verarbeitung. Aufbau des Bodys: { event, createdAt, data }. Zustellungen brechen nach 5 Sekunden ab, antworten Sie also zügig.

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

Volle Kontrolle über die Chat-Blase

Sobald das Installationsskript geladen ist, steht das Objekt window.RevoChat bereit:

RevoChat.open();                    // Panel öffnen
RevoChat.close();                   // Panel schließen
RevoChat.toggle();                  // öffnen/schließen
RevoChat.isOpen();                  // geöffnet? (boolean)

RevoChat.identify({                 // Besucher identifizieren
  name: "Jane Doe",
  email: "[email protected]",
});

RevoChat.on("ready", () => {});     // Widget geladen
RevoChat.on("open", () => {});      // Panel geöffnet
RevoChat.on("close", () => {});     // Panel geschlossen
RevoChat.on("message", (m) => {});  // neue Nachricht ({ sender, content, type })

Fügen Sie dem Script-Tag data-lang="en" hinzu, um die Widget-Sprache pro Seite festzulegen (tr / en / de / es). Das Attribut data-canli-destek aus älteren Einbettungscodes wird weiterhin unterstützt.

Chats mit Umsatz verknüpfen

Fügen Sie Ihrer Bestellbestätigungsseite eine Zeile hinzu; der Verkauf wird mit der letzten Konversation des Besuchers verknüpft und in den Analysen als „Chat-bezogener Umsatz“ ausgewiesen.

RevoChat.track("purchase", {
  orderId: "ORD-1042",   // optional
  amount: 1299.9,        // erforderlich (Zahl)
  currency: "USD",       // Standard: TRY
});

Derzeit wird nur das Ereignis purchase unterstützt; der Verkauf wird der jüngsten Konversation des Besuchers zugerechnet.