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.
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
- 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.
- 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.
- 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.
- 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
| Quando | O 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 fazer | Onde |
|---|---|
| Cadastrar o site que vai embutir o chat | Configurações > Aplicações |
| Escolher quais agentes podem ser embutidos | Na mesma aplicação, na lista de agentes |
| Definir cor, modo, logo e ícone do chat | Configurações > Temas |
| Definir os limites de uso | Na aplicação |
| Encerrar a conversa de uma pessoa, ou apagar os dados dela | Pelo seu próprio sistema, que pede isso ao VolundOS |
| Ler uma conversa embutida | Na lista de conversas do agente, aqui dentro, em modo de leitura |
API pública e conversa compartilhada
Duas portas de entrada que não passam pela tela do painel: a API pública e o link de conversa compartilhada. Aqui o recorte é o que muda quando a mensagem entra por elas.
Canal Telegram
Um bot do Telegram conectado ao agente: a pessoa conversa pelo aplicativo e o agente responde ali mesmo. Só quem está na lista de permitidos consegue falar.