Eén platform. Drie krachtige koppelvlakken.

Je eerste request in 5 minuten

Voor elk koppelvlak geldt één voorwaarde: maak een API-sleutel aan op de pagina Ontwikkelaars in je dashboard. Met je sleutel haal je data op via REST, stel je webhooks in en stuur je de widget aan.

Authenticeren met een Bearer-sleutel

Voeg je sleutel toe aan elk REST-request in de header Authorization. Sleutels beginnen met het voorvoegsel rc_live_ en worden maar één keer getoond, bij het aanmaken — bewaar de jouwe op een veilige plek.

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

Programmatische toegang tot je data

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

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

Events in handen op het moment dat ze gebeuren

Stel een webhook-URL in je dashboard in; de events die je kiest worden direct als POST met een JSON-body verstuurd. Elk request bevat twee headers: X-RevoChat-Event (de eventnaam) en X-RevoChat-Signature (een HMAC-SHA256-handtekening van de ruwe body, gemaakt met je webhook-secret) — controleer die vóór verwerking. Vorm van de body: { event, createdAt, data }. Leveringen verlopen na 5 seconden, dus antwoord snel.

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

Volledige controle over de chatbubbel

Zodra het installatiescript is geladen, staat het object window.RevoChat klaar:

RevoChat.open();                    // paneel openen
RevoChat.close();                   // paneel sluiten
RevoChat.toggle();                  // openen/sluiten
RevoChat.isOpen();                  // geopend? (boolean)

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

RevoChat.on("ready", () => {});     // widget geladen
RevoChat.on("open", () => {});      // paneel geopend
RevoChat.on("close", () => {});     // paneel gesloten
RevoChat.on("message", (m) => {});  // nieuw bericht ({ sender, content, type })

Voeg data-lang="en" toe aan de script-tag om de widgettaal per pagina in te stellen (tr / en / de / es). Het attribuut data-canli-destek uit oudere insluitcodes wordt nog steeds ondersteund.

Koppel chats aan omzet

Voeg één regel toe aan je orderbevestigingspagina; de verkoop wordt gekoppeld aan het laatste gesprek van de bezoeker en in Analyses gerapporteerd als „omzet via chat”.

RevoChat.track("purchase", {
  orderId: "ORD-1042",   // optioneel
  amount: 1299.9,        // verplicht (getal)
  currency: "USD",       // standaard: TRY
});

Voorlopig is purchase het enige ondersteunde event; de verkoop wordt toegeschreven aan het meest recente gesprek van de bezoeker.