Una piattaforma. Tre superfici potenti.
Recupera le conversazioni con la REST API, ascolta gli eventi in tempo reale con i webhook firmati HMAC e controlla via codice la bolla della chat sul tuo sito con la Widget JS API.
La tua prima richiesta in 5 minuti
Per ogni superficie c'è un solo prerequisito: crea una chiave API nella pagina Sviluppatori della tua dashboard. Con la chiave puoi recuperare dati via REST, configurare webhook e controllare il widget.
Autenticati con una chiave Bearer
Aggiungi la chiave a ogni richiesta REST nell'header Authorization. Le chiavi iniziano con il prefisso rc_live_ e vengono mostrate una sola volta, alla creazione: conservala in un posto sicuro.
curl https://revochat.app/api/v1/conversations \
-H "Authorization: Bearer rc_live_XXXXXXXXXXXX"Accesso programmatico ai tuoi dati
URL di base: https://revochat.app/api/v1
/conversationsElenca le conversazioni, dalla più recente aggiornata. Parametri: status (open | closed), limit (predefinito 50, max 200). La risposta restituisce un array data; ogni record include sito, visitatore, operatore assegnato, tag, punteggio CSAT e timestamp.
curl "https://revochat.app/api/v1/conversations?status=open&limit=20" \
-H "Authorization: Bearer rc_live_..."/conversations/:idRestituisce una singola conversazione con tutti i suoi messaggi (note interne escluse). I messaggi includono sender, content, type e, se presenti, i campi file. Restituisce 404 se non trovata.
Una chiave non valida o mancante riceve un 401 con corpo { "error": "..." }. Le chiavi più vecchie con prefisso cd_live_ continuano a funzionare.
Gli eventi nelle tue mani appena accadono
Imposta un URL webhook nella dashboard; gli eventi che scegli vengono inviati con un corpo JSON come POST nel momento in cui accadono. Ogni richiesta ha due header: X-RevoChat-Event (il nome dell'evento) e X-RevoChat-Signature (una firma HMAC-SHA256 del corpo grezzo, creata con il segreto del webhook): verificala prima dell'elaborazione. Forma del corpo: { event, createdAt, data }. Le consegne vanno in timeout dopo 5 secondi, quindi rispondi rapidamente.
conversation.createdmessage.createdconversation.closedconversation.ratedconst crypto = require("crypto");
const expected = crypto
.createHmac("sha256", process.env.WEBHOOK_SECRET)
.update(rawBody) // corpo grezzo — PRIMA di JSON.parse
.digest("hex");
if (expected !== req.headers["x-revochat-signature"]) return res.status(401).end();Controllo completo della bolla della chat
Una volta caricato lo script di installazione, l'oggetto window.RevoChat è pronto:
RevoChat.open(); // apri il pannello
RevoChat.close(); // chiudi il pannello
RevoChat.toggle(); // apri/chiudi
RevoChat.isOpen(); // è aperto? (boolean)
RevoChat.identify({ // identifica il visitatore
name: "Mario Rossi",
email: "[email protected]",
});
RevoChat.on("ready", () => {}); // widget caricato
RevoChat.on("open", () => {}); // pannello aperto
RevoChat.on("close", () => {}); // pannello chiuso
RevoChat.on("message", (m) => {}); // nuovo messaggio ({ sender, content, type })Aggiungi data-lang="en" al tag script per forzare la lingua del widget in una pagina (tr / en / de / es). L'attributo data-canli-destek dei vecchi codici di embed è ancora supportato.
Collega le chat al fatturato
Aggiungi una riga alla pagina di conferma ordine; la vendita viene collegata all'ultima conversazione del visitatore e riportata in Analisi come "fatturato attribuito alla chat".
RevoChat.track("purchase", {
orderId: "ORD-1042", // facoltativo
amount: 1299.9, // obbligatorio (numero)
currency: "USD", // predefinito: TRY
});Per ora l'unico evento supportato è purchase; la vendita viene attribuita alla conversazione più recente del visitatore.
Chiavi API e segreti dei webhook si gestiscono nella pagina Sviluppatori della tua dashboard.
Vai a Sviluppatori →