Developers

Aparência

SDK Zarv ​

O SDK Zarv é um único loader que serve dois produtos sob o mesmo window.Zarv:

  • Chat — o widget de conversa que aparece como um launcher no canto da página.
  • Smartflow — o funnel de cadastro/KYC embutido na sua aplicação.

Você carrega um único script e escolhe qual produto usar pela forma como o configura.

Instalação ​

Adicione o loader à sua página:

html
<!-- Produção -->
<script async src="https://js.zarv.com/sdk.js"></script>

Em ambientes de desenvolvimento ou staging, use o host de dev:

html
<!-- Dev / staging -->
<script async src="https://js.zarv.dev/sdk.js"></script>

O loader detecta a origem pelo próprio src: ao carregar de js.zarv.com ele aponta para os backends de produção, e ao carregar de js.zarv.dev aponta para os de dev/staging. Você não precisa configurar isso manualmente.

O SDK roda em qualquer origem — não há restrição de CORS para o JavaScript do loader.

Versionamento ​

O loader lê /sdk/version.json e carrega os bundles versionados com verificação de integridade (SRI). Novas versões são publicadas automaticamente, então integrar via sdk.js sempre traz a versão mais recente sem mudanças do seu lado.

Para fixar uma versão específica (por exemplo, para garantir reprodutibilidade), carregue o bundle versionado diretamente, com integrity e crossorigin:

html
<script
  async
  src="https://js.zarv.com/sdk/v<versão>/widget.js"
  integrity="sha384-..."
  crossorigin="anonymous"
></script>

Próximos passos ​

  • Chat — configuração declarativa do widget de conversa.
  • Smartflow — configuração imperativa do funnel de cadastro/KYC.