Settings
Settings é a área administrativa para o comportamento do workspace. O dashboard agora mostra duas abas ativas: Bot e Integrations. API Keys, Connection e GDPR estão ocultas até uma versão dedicada.
Bot
| Configuração | O que faz |
|---|---|
| Bot Name | Adiciona o nome do bot do workspace ao system prompt de Clark. |
| Language | Auto usa o idioma do usuário; um idioma selecionado força respostas nesse idioma do workspace. |
| Greeting Message | Usado quando um chat do Telegram vinculado envia /start. |
| Support Email | Mostrado quando usuários pedem suporte humano. |
| Accent Color | Salvo como cor de marca para componentes de documentos/UI que dão suporte a isso. |
| Extra System Prompt | Adicionado ao system prompt como instruções específicas do workspace. |
Chat Behavior
| Configuração | O que controla |
|---|---|
| Listener Mode | Clark salva contexto e pode responder quando mencionado, respondido, contatado diretamente ou quando detecta uma intervenção útil de alta confiança. |
| Auto Reply | Clark responde a cada mensagem de texto em grupos Telegram/Slack sem menção. Use com cuidado. |
| Daily Summary | Roda de segunda a quinta no fim do expediente do workspace. Se não houver mensagens no período, Clark pula. |
| Weekly Summary | Roda toda segunda às 10:00 no fuso do workspace e cobre a semana anterior. |
| Only for CEO / Admin | Envia resumos em privado ao CEO/admin quando há destino privado disponível. |
| Timezone e business hours | Usados para agendas de resumos e lógica de horário comercial. |
Esses valores são defaults do workspace. Chats individuais podem sobrescrever comportamento na página Chats.
Listener Mode
listener_mode=true ativa a escuta silenciosa em grupos do Telegram. Ele se aplica quando auto_reply=false e a mensagem do grupo não menciona Clark.
Como funciona:
- Clark salva cada mensagem no histórico do chat;
- o contador fica em
xdoc:listener_counter:{tenant}:{chat}; - Clark fica em silêncio nas primeiras 2 mensagens depois que o contador inicia ou reinicia, para acumular contexto;
- perguntas com
?são analisadas assim que há contexto inicial; - mensagens comuns são analisadas aproximadamente a cada 5 mensagens;
- o agent deve retornar
SKIPou intervir brevemente quando tiver uma resposta útil da memória, documentos ou contexto do chat.
Se listener_mode=false, mensagens de grupo sem menção não disparam resposta e são mantidas apenas como contexto/pending escalation.
Auto Reply
auto_reply=true faz Clark responder a cada mensagem de texto em grupos Telegram/Slack sem menção. No Telegram, Auto Reply ignora Listener Mode: a mensagem vai diretamente para o active agent response normal.
Slack atualmente suporta mention OR DM OR auto_reply. O Listener Mode autônomo com decisão SKIP/responder está implementado para Telegram.
Integrations
Clark sempre salva dados de CRM internamente. Quando Sync with External está ativo, novos leads e deals também são enviados aos sistemas externos configurados.
| Integração | Status |
|---|---|
| Bitrix24 | Usa um incoming webhook URL. Test chama get_deals; sync cria leads/deals. |
| AmoCRM | Usa domain e access token. Test chama get_leads; sync cria leads/contacts/deals. |
| 1C | Usa base URL e credenciais opcionais. Test chama counterparties; sync pode criar counterparties. |
| Messaging Channels | Informativo: Clark suporta Telegram e Slack. Gerencie chats em Chats. |
Segredos aparecem mascarados. Salvar o formulário sem alterar um segredo mascarado não sobrescreve o valor real.