Chat Público (Script ou Link)

O que é

O Chat Público é a forma mais simples de publicar o chatbot: você copia um código pronto e cola no seu site. Qualquer visitante pode conversar com o bot — sem login, sem backend, sem configuração de servidor.

1. Quando usar

Use o modo Público quando você quer que:

• Qualquer pessoa que acesse o site possa iniciar uma conversa;
• A instalação seja só copiar e colar um código, sem mexer em servidor;
• O chat apareça como um balão flutuante (ou embutido em uma área fixa da página).

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 para identificar essa conexão (ex.: “Site institucional”);
   • Tipo de integração: selecione “Pública (Script ou Link)”.
5. Clique em Salvar 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á o código de instalação pronto para copiar:

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

Para instalar: cole esse código antes do </body> em todas as páginas do site onde o chat deve aparecer. É só isso — não precisa de backend nem de configuração de servidor.

3.1 Entendendo cada campo do código

💡 Dica: conforme você altera as configurações visuais (seção 6), o código exibido na plataforma é atualizado automaticamente com os parâmetros correspondentes. Copie o código depois de fazer seus ajustes.

3.2 Testando sem instalar nada

No título do card da publicação há um botão de link externo (ícone 🔗): ele abre uma página de teste com o seu chatbot funcionando, para você validar a experiência antes de colar o código no site.

3.3 Trocando o chatbot da publicação

No próprio card há um seletor de chatbot: você pode mudar qual bot atende essa publicação a qualquer momento, sem trocar o código instalado no site.

4. Como tudo se conecta

┌─────────────────────┐                        ┌──────────────────────┐
│  Visitante abre o   │   1. página carrega    │  Seu site            │
│  seu site           │ ─────────────────────▶ │  (script do chat     │
└─────────────────────┘                        │  colado no HTML)     │
                                               └──────────┬───────────┘
                                                          │ 2. script gera um ID
                                                          │    anônimo para o visitante
                                                          ▼
                                               ┌──────────────────────┐
                                               │  API Caramelo        │
                                               │  → valida a chave    │
                                               │    pública           │
                                               │  → cria a conversa   │
                                               └──────────┬───────────┘
                                                          │ 3. chat disponível
                                                          ▼
                                               ┌──────────────────────┐
                                               │  Balão do chat no    │
                                               │  canto da tela,      │
                                               │  pronto para uso     │
                                               └──────────────────────┘

Em resumo:

1. O visitante abre uma página do seu site;
2. O script do chat carrega e cria um identificador anônimo para aquele navegador;
3. A plataforma valida a chave pública e abre a conversa;
4. O balão do chat aparece no canto da tela.

5. Como o visitante é identificado

Diferente do modo Intranet, aqui não existe login: a plataforma gera automaticamente um ID anônimo (ex.: user-a1b2c3...) que fica salvo no navegador do visitante.

📌 Precisa saber quem é o visitante? Você pode configurar o chatbot para pedir dados (nome, e-mail, telefone) durante a conversa. E se o seu site tem área logada e você quer a identidade garantida pelo seu sistema, o modo certo é o Intranet (Acesso Autenticado) — veja o guia específico.

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 (padrão 10 segundos, ajustável em “Timer de Ausência”), a aba do navegador chama atenção e o chat fica brilhando para o visitante voltar;

• Retenção com início oculto: o chat não carrega de imediato — só aparece após um tempo de inatividade (definido em “Tempo de espera”), chamando atenção da mesma forma;

• Renderizar em um local fixo da página: em vez de flutuar, o chat é exibido dentro de uma área sua. Ao ativar, a plataforma mostra um código de <div> para você colar onde o chat deve aparecer:

  <div id="chatbox_ID_DA_PUBLICACAO"></div>
  

⚠️ Atenção: “Retenção de Atenção” e “Início oculto” são opções que se desativam mutuamente — marcar uma desmarca a outra.

7. Perguntas frequentes