@zeruz-ia/bubble-chat-widget

Widget leve para instalar o Bubble Chat da Zeruz em sites externos usando iframe.

ESM

import { ZeruzBubbleChat } from "@zeruz-ia/bubble-chat-widget";

const chat = ZeruzBubbleChat.init({
  slug: "agent-example-web",
  baseUrl: "https://app.zeruz.com.br",
  position: "right",
});

Script Direto

<script src="https://cdn.jsdelivr.net/npm/@zeruz-ia/[email protected]/dist/index.global.js"></script>
<script>
  ZeruzBubbleChat.init({
    slug: "agent-example-web",
    baseUrl: "https://app.zeruz.com.br",
    position: "left"
  });
</script>

Build

npm install
npm run build

O build usa tsup e gera ESM, CJS, IIFE/global e tipos TypeScript em dist/.

Opções Principais

• slug: slug da ConnectionProjectAgent.
• baseUrl: URL base onde o frontend da Zeruz está hospedado.
• iframeSrc: URL completa do iframe. Quando informado, substitui slug/baseUrl.
• position: "right" ou "left". Default: "right".
• bottom: distância inferior quando fechado. Default: "16px".
• sideOffset: distância lateral quando fechado. Default: "16px".
• zIndex: default 999999999.
• hiddenBranding: usa a rota /hidden. Default: true.

O widget redimensiona automaticamente o iframe quando recebe eventos do Bubble:

• zeruz:chat:open
• zeruz:chat:close
• zeruz:chat:hint:show
• zeruz:chat:hint:hide
• { type: "zeruz:image:open", payload: { src, alt } }