Uma plataforma. Três superfícies poderosas.

Sua primeira requisição em 5 minutos

Há um pré-requisito para todas as superfícies: crie uma chave de API na página Desenvolvedores do seu painel. Com a chave, você puxa dados via REST, configura webhooks e controla o widget.

Autentique-se com uma chave Bearer

Adicione sua chave a cada requisição REST no cabeçalho Authorization. As chaves começam com o prefixo rc_live_ e são exibidas uma única vez, na criação — guarde a sua em um lugar seguro.

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

Acesso programático aos seus dados

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

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

Os eventos nas suas mãos no instante em que acontecem

Defina uma URL de webhook no seu painel; os eventos escolhidos são enviados com corpo JSON como um POST no instante em que acontecem. Cada requisição traz dois cabeçalhos: X-RevoChat-Event (o nome do evento) e X-RevoChat-Signature (uma assinatura HMAC-SHA256 do corpo bruto, feita com o segredo do seu webhook) — verifique-a antes de processar. Formato do corpo: { event, createdAt, data }. As entregas expiram após 5 segundos, então responda rápido.

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

Controle total do balão de chat

Assim que o script de instalação carregar, o objeto window.RevoChat estará pronto:

RevoChat.open();                    // abre o painel
RevoChat.close();                   // fecha o painel
RevoChat.toggle();                  // abre/fecha
RevoChat.isOpen();                  // está aberto? (boolean)

RevoChat.identify({                 // identifica o visitante
  name: "Maria Silva",
  email: "[email protected]",
});

RevoChat.on("ready", () => {});     // widget carregado
RevoChat.on("open", () => {});      // painel aberto
RevoChat.on("close", () => {});     // painel fechado
RevoChat.on("message", (m) => {});  // nova mensagem ({ sender, content, type })

Adicione data-lang="en" à tag do script para definir o idioma do widget por página (tr / en / de / es). O atributo data-canli-destek dos códigos de incorporação antigos continua compatível.

Conecte as conversas à receita

Adicione uma linha à página de confirmação do pedido; a venda é vinculada à conversa mais recente do visitante e aparece em Análises como "receita atribuída ao chat".

RevoChat.track("purchase", {
  orderId: "ORD-1042",   // opcional
  amount: 1299.9,        // obrigatório (number)
  currency: "USD",       // padrão: TRY
});

Por enquanto, o único evento compatível é purchase; a venda é atribuída à conversa mais recente do visitante.