🚀Primeiros passos

Copie o código em Configurações → Instalação no seu painel e cole logo antes da tag </body> em todas as páginas do seu site. O script carrega de forma assíncrona, então não deixa suas páginas mais lentas.

<script src="https://revochat.app/widget.js"
        data-revo-chat="YOUR_SITE_KEY" async></script>

Depois de colar o código, basta abrir seu site uma vez: na primeira vez que o widget se conecta a partir do seu domínio, a etapa na tela Configuração se conclui sozinha. Não há botão para apertar.

• WordPress: Aparência → Editor de arquivos de tema → footer.php, ou qualquer plugin de “inserir código no cabeçalho/rodapé”.
• Shopify: Loja virtual → Temas → Editar código → theme.liquid, antes de </body>.
• Wix / Squarespace: o campo de “código personalizado” nas configurações do site, aplicado a todas as páginas.
• Next.js / React: como um <script> no layout raiz, com defer/async.

Por privacidade (KVKK/GDPR), o widget não registra nada até o visitante abrir o balão de chat: ele não aparece na lista de visitantes ao vivo, as visualizações de página não são rastreadas e nenhum ID persistente é guardado no navegador. O balão continua visível, e a conversa começa normalmente assim que o visitante o abre.

Se você usa uma ferramenta de consentimento de cookies (Cookiebot, CookieYes, Google Consent Mode…), faça a chamada abaixo quando o visitante der consentimento; para quem consentir, o rastreamento e as mensagens proativas funcionam mesmo antes de iniciar uma conversa. Se o consentimento for retirado, consent(false) apaga o ID persistente.

RevoChat.consent(true);   // consentimento dado
RevoChat.consent(false);  // consentimento retirado

Se você identifica seus membros com RevoChat.identify, ative a verificação de identidade: crie um segredo em Configurações → Instalação → Verificação de identidade, guarde-o só no seu servidor e assine o e-mail lá. Um e-mail assinado mostra um check verde no painel, e os webhooks incluem visitorEmailVerified: true. Um e-mail sem assinatura (inclusive um que o próprio visitante digitou) é salvo, mas tratado como não verificado.

const hash = crypto.createHmac("sha256", IDENTITY_SECRET).update(member.email).digest("hex");
// na página:
RevoChat.identify({ email: member.email, name: member.name, hash });

Em Configurações → Aparência você ajusta o widget inteiro à sua marca. As mudanças entram no ar assim que você salva — não é preciso colar o código de novo.

• Cor da marca: para o balão e as bolhas de mensagem combinarem com a sua marca.
• Posição do balão: inferior direito (padrão) ou inferior esquerdo — se já houver outro elemento no canto inferior direito do seu site.
• Mensagem de boas-vindas: a primeira linha que o visitante vê quando o chat abre.
• Mensagem offline: exibida quando não há atendente disponível e o assistente de IA está desativado.
• Idioma do widget: automático, conforme o idioma do navegador do visitante, ou fixo (inglês, turco, espanhol, português, alemão, francês, italiano, holandês, russo).
• Perguntas rápidas: aparecem como botões na tela de boas-vindas; quando o visitante clica em uma, a conversa começa com essa pergunta.

Sua chave de incorporação fica visível para qualquer pessoa no código-fonte da página — isso é normal e ela não foi feita para ser secreta. Mas, se não quiser que alguém copie a chave e a use no próprio site, preencha Configurações → Instalação → Domínios permitidos.

• Enquanto a lista estiver vazia, não há restrição (o recurso é opcional).
• Separe com vírgulas: site.com, loja.site.com
• Curingas são aceitos: *.site.com cobre todos os subdomínios e também o próprio site.com.
• Conexões de um endereço fora da lista são recusadas; o visitante não vê erro, o widget simplesmente não aparece.

Cada site tem sua própria página de chat independente. Coloque o link no perfil das redes sociais, na assinatura de e-mail ou em um QR code; quando o visitante clica, abre um chat em tela cheia e a conversa chega na mesma caixa de entrada.

https://revochat.app/chat/YOUR_SITE_KEY