Une plateforme. Trois interfaces puissantes.

Votre première requête en 5 minutes

Un seul prérequis, quelle que soit l'interface : créez une clé API sur la page Développeurs de votre tableau de bord. Avec votre clé, vous pouvez récupérer des données via REST, configurer des webhooks et piloter le widget.

Authentifiez-vous avec une clé Bearer

Ajoutez votre clé à chaque requête REST dans l'en-tête Authorization. Les clés commencent par le préfixe rc_live_ et ne sont affichées qu'une seule fois, à leur création — conservez la vôtre en lieu sûr.

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

Un accès programmatique à vos données

URL de base : https://revochat.app/api/v1

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

Les événements entre vos mains dès qu'ils se produisent

Définissez une URL de webhook dans votre tableau de bord ; les événements choisis sont envoyés en POST avec un corps JSON dès qu'ils se produisent. Chaque requête comporte deux en-têtes : X-RevoChat-Event (le nom de l'événement) et X-RevoChat-Signature (une signature HMAC-SHA256 du corps brut, générée avec le secret de votre webhook) — vérifiez-la avant tout traitement. Format du corps : { event, createdAt, data }. Les envois expirent au bout de 5 secondes : répondez rapidement.

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();

Un contrôle total de la bulle de chat

Une fois le script d'installation chargé, l'objet window.RevoChat est prêt :

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 })

Ajoutez data-lang="en" à la balise script pour imposer la langue du widget page par page (tr / en / de / es). L'attribut data-canli-destek des anciens codes d'intégration reste pris en charge.

Reliez vos conversations au chiffre d'affaires

Ajoutez une ligne à votre page de confirmation de commande ; la vente est rattachée à la dernière conversation du visiteur et apparaît dans Statistiques comme « chiffre d'affaires attribué au chat ».

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

Pour l'instant, le seul événement pris en charge est purchase ; la vente est attribuée à la conversation la plus récente du visiteur.