Chat com Login e Senha

O que é

O Chat com Login e Senha é uma forma de publicar o chatbot em que todos os visitantes usam o mesmo login e 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:

• Apenas um grupo fechado use o chat (equipe, clientes VIP, beta testers, evento);
• A distribuição seja simples: um link + uma senha, sem desenvolvimento;
• Ou embutir o chat num site, mas exigindo uma senha antes da conversa.

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

2. Configurando na plataforma

1. Acesse o seu Projeto → menu Chatbots → selecione o chatbot desejado.
2. Clique na aba Publicar e depois na sub-aba Sites.
3. Clique em Adicionar.
4. No modal “Publicar em Sites ou Sistemas Web”, preencha:
   • Nome da publicação: um nome interno (ex.: “Área de suporte restrita”);
   • Tipo de integração: selecione “Acesso com Login e Senha”;
   • Login de acesso: o usuário que será digitado na tela de entrada do chat;
   • Senha de acesso: mínimo 6 caracteres.
5. Clique em Salvar Publicação.

🔒 A senha é armazenada de forma segura (hash) e não poderá ser visualizada depois — anote-a em um local seguro. Se perdê-la, você poderá redefini-la no card da publicação.

Pronto! A nova conexão aparece na Listagem de publicações.

3. O que a plataforma mostra depois de criar

Ao expandir a publicação, você verá:

3.1 Link de acesso

Um link direto para uma página de chat exclusiva, no formato:

https://.../SEU_CHATBOT_ID?public_api_key=ct_...

É a forma mais rápida de distribuir: envie o link + login + senha para quem deve ter acesso. Ao abrir, a pessoa verá a tela de entrada do chat.

3.2 Login de acesso

O login definido na criação, sempre visível no card para consulta.

3.3 Redefinir senha

Como a senha atual não pode ser visualizada, o card oferece o botão “Redefinir”: informe uma nova senha (mínimo 6 caracteres) e ela passa a valer imediatamente. A senha antiga deixa de funcionar.

3.4 Código de instalação (script)

Alternativa ao link: o mesmo código de script do modo Público, para embutir o chat no seu site — com a diferença de que o chat abre na tela de login em vez de abrir direto:

<script>
  var carameloaiChatbot = {
    publicApiKey: "ct_...",
    project_id: "SEU_PROJECT_ID",
    pluginVersion: "VERSAO_DO_PLUGIN"
  };
</script>
<script src="https://static.carameloai.com/prod/index.js"></script>

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 de acesso (ou a página do site com o script);
2. Em vez da conversa, aparece uma tela de login personalizada com as cores e o avatar do seu chatbot;
3. Ele digita o login e a senha compartilhados;
4. A plataforma confere as credenciais e libera a conversa.

5. Como funciona o acesso do visitante

💡 Boas práticas: troque a senha periodicamente (botão “Redefinir”), evite senhas óbvias e, se alguém deixar o grupo, redefina a senha e distribua a nova.

6. Configurações visuais do chat

No card da publicação, coluna “Configurações”, você ajusta o comportamento do widget (clique em Salvar após alterar):

• Posição do chat no site: canto da tela onde o balão aparece;
• Iniciar e manter a caixa de conversa aberta: o chat fica sempre aberto, sem opção de fechar;
• Modo Compacto: o chat ocupa o menor tamanho possível;
• Retenção de Atenção: após um tempo de inatividade, a aba chama atenção e o chat fica brilhando;
• Renderizar em um local fixo da página: exibe o chat dentro de uma área específica do seu site, em vez de flutuante.

Essas opções valem para o modo script; a tela de login sempre usa as cores e o avatar configurados no chatbot.

7. Perguntas frequentes