One platform. Three powerful surfaces.

Your first request in 5 minutes

There's one prerequisite for every surface: create an API key on the Developers page of your dashboard. With your key you can pull data over REST, set up webhooks and control the widget.

Authenticate with a Bearer key

Add your key to every REST request in the Authorization header. Keys start with the rc_live_ prefix and are shown only once, when they're created — store yours somewhere safe.

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

Programmatic access to your data

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

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

Events in your hands the moment they happen

Set a webhook URL in your dashboard; the events you choose are sent with a JSON body as a POST the moment they happen. Every request carries two headers: X-RevoChat-Event (the event name) and X-RevoChat-Signature (an HMAC-SHA256 signature of the raw body, made with your webhook secret) — verify it before processing. Body shape: { event, createdAt, data }. Deliveries time out after 5 seconds, so respond quickly.

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

Full control of the chat bubble

Once the install script has loaded, the window.RevoChat object is ready:

RevoChat.open();                    // open the panel
RevoChat.close();                   // close the panel
RevoChat.toggle();                  // open/close
RevoChat.isOpen();                  // is it open? (boolean)

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

RevoChat.on("ready", () => {});     // widget loaded
RevoChat.on("open", () => {});      // panel opened
RevoChat.on("close", () => {});     // panel closed
RevoChat.on("message", (m) => {});  // new message ({ sender, content, type })

Add data-lang="en" to the script tag to override the widget language per page (tr / en / de / es). The data-canli-destek attribute from older embed codes is still supported.

Tie chats to revenue

Add one line to your order confirmation page; the sale is linked to the visitor's latest conversation and reported in Analytics as "chat-attributed revenue".

RevoChat.track("purchase", {
  orderId: "ORD-1042",   // optional
  amount: 1299.9,        // required (number)
  currency: "USD",       // default: TRY
});

For now the only supported event is purchase; the sale is attributed to the visitor's most recent conversation.