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 Widget tem duas telas:

Tela	Caminho	O que configura
Visão Geral	CRM → Canais → [canal] → Visão Geral	Código de incorporação (Configuração:), tema Modo Claro / Modo Escuro do script e contexto customizado.
Customização	CRM → Canais → [canal] → Customização	Visual, CTA do widget fechado, indicador na foto do agente e ações rápidas.

O passo a passo da customização está em Customização.

<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>

⚙️ Em Visão Geral, copie o script em Configuração: e cole na seção <body> do seu HTML.
Após a implantação, os visitantes do seu site poderão conversar diretamente com seu Agente.

Contexto customizado

A página que embute o Widget pode enviar dados do seu sistema (usuário logado, página, plano) junto com cada mensagem.
Esses dados entram no prompt da LLM em Custom Contextual Information — não como fala do visitante.

Na description de cada property da tool, aponte para esse bloco. Exemplo: preencha esta property com o userId presente dentro da Custom Contextual Information.

O passo a passo está em Contexto customizado.

Notas de personalização

A tela Customização oferece preview ao vivo do chat aberto e do widget fechado:

Cores das bolhas e do texto em Modo Claro e Modo Escuro.
Mensagem inicial e o switch Chat inicia aberto por padrão.
CTA do widget fechado e indicador verde na foto do agente.
Até três Ações rápidas acima da área de texto.

Altere os campos e confira o preview antes de Salvar. Cada canal Widget tem a própria customização.

O guia completo está em Customização.

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.

Formulário no chat

O Agente pode mostrar um formulário no Widget para o visitante escolher opções ou preencher dados curtos. O botão é Enviar. O envio vira a próxima mensagem.

Não há cadastro em Ferramentas: a tool Request User Input é nativa nessas conversas. Guia: Request User Input.