Chat com Login e Senha

O que é

O Chat com Login e Senha é uma forma de publicar o agente em que todos os visitantes usam o mesmo login e a mesma senha para abrir o chat. Funciona como uma portaria: quem tem a senha entra e conversa, quem não tem vê apenas a tela de acesso.

1. Quando usar

Use o modo Login e Senha quando você quer que:

• Só um grupo fechado use o chat, como a equipe, clientes VIP, beta testers ou o público de um evento;
• A distribuição seja simples: um link e uma senha, sem desenvolvimento;
• O chat fique no seu site, mas peça a senha antes da conversa.

⚠️ Importante: a senha é compartilhada, todos usam a mesma. Ela controla o acesso, mas não identifica cada visitante. Se você precisa saber quem é cada usuário, o modo certo é o Intranet (acesso autenticado). Veja o guia específico.

2. Criando a conexão

1. Entre no projeto, clique em Robôs Agentes de IA no menu lateral e abra o agente.
2. Clique na aba Canais.
3. Clique em Adicionar canal. Se o agente ainda não tem nenhuma conexão, a lista de canais já aparece direto.
4. No grupo Web, escolha Web protegida por senha e clique em Selecionar.
5. Em Destino e acesso, confira se o Modo de acesso está em Login e senha compartilhados e clique em Continuar.
6. Em Configuração, preencha:
   • Nome da conexão: um nome interno, como “Área de suporte restrita”;
   • Login compartilhado: o usuário que as pessoas vão digitar na tela de acesso do chat;
   • Senha compartilhada: no mínimo 6 caracteres;
   • Domínios permitidos (opcional): os sites em que o chat pode rodar, um por linha.
7. Clique em Criar conexão.

A tela “Conexão criada” mostra o Link do bot e o código para instalar no site.

🔒 Anote a senha em um lugar seguro. Ela é guardada de forma protegida e não pode ser vista depois. Se perder, você pode definir uma nova (veja a seção 3.2).

⚠️ Atenção: criar a conexão não publica uma versão do agente. Enquanto nenhuma versão for publicada, o chat atende com o rascunho atual. Veja como publicar em Seu Primeiro Agente.

3. Distribuindo o acesso

Para ver o link e os códigos depois, abra a aba Canais, encontre a conexão em Suas conexões e clique em Gerenciar.

3.1 Link ou código no site

Em Instalação, escolha o que copiar:

• Link do bot: a forma mais rápida de distribuir. Envie o link, o login e a senha para quem deve ter acesso. Ao abrir, a pessoa vê a tela de acesso do chat;
• Código do site: o mesmo código do Chat Público, para colocar o chat no seu site. A diferença é que o chat abre na tela de acesso, e não direto na conversa.

<!-- Caramelo AI chatbot -->
<script src="https://static.carameloai.com/sdk/latest/client.js"></script>
<script>
  window.CarameloChatbot
    .create({
      publicApiKey: 'ct_...',
      project_id: 'SEU_PROJECT_ID'
    })
    .start();
</script>

3.2 Redefinindo a senha

Na mesma página, em Credenciais e ações, fica o bloco Redefinir senha compartilhada. Ele mostra o Login atual e um campo para a Nova senha (mínimo de 6 caracteres). Clique em Redefinir senha: a nova senha vale na hora para todas as pessoas, e a antiga para de funcionar.

Redefinir a senha é separado do botão Salvar e não envia outras alterações da página.

4. Como tudo se conecta

┌─────────────────────┐                        ┌──────────────────────┐
│  Visitante abre o   │   1. acessa o link     │  Página do chat      │
│  link ou o site     │ ─────────────────────▶ │  (tela de login com  │
└─────────────────────┘                        │  a cara do seu bot)  │
                                               └──────────┬───────────┘
                                                          │ 2. digita login + senha
                                                          ▼
                                               ┌──────────────────────┐
                                               │  API Caramelo        │
                                               │  → confere a senha   │
                                               │    (hash seguro)     │
                                               │  → aplica limite de  │
                                               │    tentativas        │
                                               └──────────┬───────────┘
                                                          │ 3. acesso liberado
                                                          ▼
                                               ┌──────────────────────┐
                                               │  Conversa aberta,    │
                                               │  com histórico       │
                                               │  daquele navegador   │
                                               └──────────────────────┘

Em resumo:

1. O visitante abre o link (ou a página do site com o código);
2. Em vez da conversa, aparece uma tela de acesso com as cores e o avatar do seu agente;
3. Ele digita o login e a senha compartilhados;
4. A plataforma confere os dados e libera a conversa.

5. Como funciona o acesso do visitante

💡 Boas práticas: troque a senha de tempos em tempos, evite senhas óbvias e, se alguém sair do grupo, redefina a senha e distribua a nova.

6. Ajustando a aparência

Em Gerenciar, as seções Configurações e Avançado têm as mesmas opções do Chat Público: posição do balão, modo compacto, manter chat aberto, container fixo, temporização e domínios permitidos. Veja o que cada uma faz no guia do Chat Público.

Essas opções valem para o chat instalado no site. A tela de acesso sempre usa as cores e o avatar configurados na aba Visual do agente.

7. Perguntas frequentes