VolundOS

Chat embutido: o agente dentro do site da sua empresa

Põe o chat de um agente dentro do seu site ou sistema, para pessoas que não têm conta no VolundOS — em área logada, identificando cada uma, ou num botão de atendimento aberto.

Atualizado em 26 de outubro de 2026

Chat embutido: o agente dentro do site da sua empresa

Para que serve

Põe o chat de um agente dentro do seu próprio site ou sistema, para pessoas que não têm conta no VolundOS. Quem conversa não faz login aqui e só enxerga a própria conversa.

São dois modos, e a escolha depende de quem está do outro lado:

  • Assinado — o seu sistema identifica cada pessoa e abre a conversa por trás dos panos. É o modo de uma área logada, onde você já sabe quem é quem.
  • Público — um botão flutuante de atendimento num site aberto, com visitante anônimo. É o modo de um widget de ajuda.

Para embutir, o site precisa estar cadastrado como aplicação vinculada, em Configurações > Aplicações.

Uma ressalva de vocabulário, porque a palavra se repete no produto com outro sentido: no modo assinado, a pessoa que o seu sistema identifica não é uma conta do VolundOS. Ela não vira membro da organização e não consente com nada aqui — quem responde pela conversa e pelo consumo é a aplicação. Isso é diferente de uma conta vinculada, em que um membro daqui autoriza o vínculo com outro serviço.

Como se usa

  1. Cadastre a aplicação e escolha quais agentes podem ser embutidos. Isso exige as duas permissões — administrar aplicações e configurar o agente — porque embutir um agente é publicá-lo para gente de fora.
  2. Se quiser, escolha a aparência em Configurações > Temas: cor, modo claro ou escuro, logo e ícone. Os limites de uso não ficam aqui — eles se definem na própria aplicação, e estão descritos mais abaixo.
  3. Ligue ao seu site. No modo assinado, o seu servidor pede uma sessão e recebe de volta o endereço para abrir o chat. No modo público, a página carrega o script do chat com a chave que pode ficar à vista.
  4. A pessoa conversa. O que o agente produzir aparece como cartão e abre num painel ali mesmo, dentro do chat.

O que muda para o agente embutido

Vale conhecer antes de escolher o agente, porque ali ele trabalha com menos do que tem em casa. Um agente embutido atende uma conversa, e só ela: não acumula memória, não usa as bases de conhecimento, não carrega skills pessoais, não delega a outros agentes, não dispara por agendamento e não alcança as credenciais do Cofre nem a rede interna.

Outras duas regras que importam no desenho:

  • O Oráculo não pode ser embutido.
  • Do lado de dentro do VolundOS, a conversa embutida é somente leitura — ela se lê, não se responde por aqui.

Sobre o que o agente produz: a pessoa abre e usa, mas não salva, publica nem exporta de dentro do chat embutido.

Limites de uso

Os limites se definem na própria aplicação, em quatro camadas: por aplicação e por pessoa identificada e, no modo público, também por aplicação pública e por visitante. Cada camada tem teto de conversas por dia, de consumo por mês e de conversas ao mesmo tempo. O modo público tem ainda um teto de visitantes novos por hora e por endereço de origem, que é o que segura um site aberto de virar porta de abuso.

Mensagens que a pessoa pode ver

QuandoO que aparece
A aplicação não cadastrou de quais sites o chat pode ser embutido"A aplicação não tem nenhuma origem cadastrada para embutir o chat."
O chat embutido não está ligado para aquela aplicação"O chat embutido não está ligado para esta aplicação."
Muitas conversas novas em pouco tempo, no modo público"Muitas conversas novas em pouco tempo. Tente de novo mais tarde."
Muitos pedidos seguidos"Muitos pedidos em pouco tempo. Tente de novo em instantes."
A sessão venceu"Esta sessão venceu. Recarregue a página para continuar."
A sessão foi encerrada de fora"Esta sessão foi encerrada. Recarregue a página para começar outra."

O que dá para fazer, e onde

O que dá para fazerOnde
Cadastrar o site que vai embutir o chatConfigurações > Aplicações
Escolher quais agentes podem ser embutidosNa mesma aplicação, na lista de agentes
Definir cor, modo, logo e ícone do chatConfigurações > Temas
Definir os limites de usoNa aplicação
Encerrar a conversa de uma pessoa, ou apagar os dados delaPelo seu próprio sistema, que pede isso ao VolundOS
Ler uma conversa embutidaNa lista de conversas do agente, aqui dentro, em modo de leitura

On this page