Widget

O canal Widget é usado para incorporar um chat interativo diretamente no seu site ou sistema.

Etapas para criar

Selecione Type: Widget.
Nomeie o canal (ex.: Widget Oficial).
Atribua um respondente (Agente ou Squad).
Opcionalmente, adicione um prompt personalizado.
Defina o atraso de resposta.
Clique em Create Channel.

Após a criação, o canal expõe uma Página de Configuração do Widget contendo:

Seção	Descrição
Configuration Code	Trecho de JavaScript que deve ser copiado e colado no seu site ou aplicativo web.
Theme Controls	Alterne entre as versões Light Mode e Dark Mode.
Customization Options	Modifique as cores de fundo, texto e botões.
Open on Load	Opção para abrir automaticamente o widget quando a página carrega.

<body>
  <script>
    window.ZV2Widget = {
      ChannelURL: "https://widget.endless.zaia.app/widget/channel/..."
    };
  </script>
  <script src="https://widget.endless.zaia.app/script/widget-loader.js" async></script>
</body>

⚙️ Use o botão “Copy” para copiar o script completo para a seção <body> do seu HTML.
Após a implantação, os visitantes do seu site poderão conversar diretamente com seu Agente.

Notas de personalização

Para Widget Channels, a Zaia oferece um ambiente de personalização ao vivo:

Modifique as cores das bolhas de mensagem e do texto.
Ajuste a cor do botão para combinar com sua marca.
Alterne entre pré-visualizações Light e Dark.
Pré-visualize instantaneamente todas as mudanças de UI antes de salvar.

Cada opção de personalização é aplicada de forma independente por canal, permitindo múltiplos estilos de widget para diferentes sites ou ambientes.

Os visitantes do site podem anexar documentos às mensagens do Widget. O Widget aceita:

.pdf
.md
.txt

Cada documento pode ter até 10 MB. A Zaia envia a extensão original do arquivo junto com a mensagem.

Arquivos Markdown e de texto não passam por essa verificação de conteúdo de PDF.

Restrições de documentos por canal

A disponibilidade de documentos depende do canal. O Instagram não oferece suporte a anexos de documentos.

Essa restrição se aplica a arquivos PDF, Markdown e de texto.

Use um Test Widget para compartilhar o Draft atual de um Agente com pessoas fora do workspace antes de publicá-lo.

Um Test Widget sempre usa a versão Draft do respondente.
Um Widget normal continua usando a versão Production.
As alterações do Draft ficam disponíveis no Test Widget sem que seja necessário publicar o Agente.
A experiência compartilhada é identificada visivelmente como um ambiente de teste.
A publicação continua sendo uma ação separada e não é acionada pela criação ou uso do Test Widget.
Desative ou remova o Test Widget para encerrar o acesso de teste externo.

Use o Test Widget para validar instruções, tom, tools e comportamento de conversa com revisores externos, mantendo a Production inalterada.

Widget

Etapas para criar

Notas de personalização

Enviar documentos no Widget

Restrições de documentos por canal

Draft Test Widget