Configuração do Telegram

Use este guia para conectar Clark ao Telegram e verificar se o bot consegue ler os chats corretos.

Chat privado

1. Abra o Telegram e procure @xdocai_bot.
2. Pressione Start ou envie /start.
3. Envie /help para ver os comandos disponíveis.
4. Faça uma pergunta simples, por exemplo: Clark, com o que você pode ajudar?

Em um chat privado, Clark responde a mensagens normais porque a conversa é diretamente com o bot.

Chat de grupo

1. Abra seu grupo do Telegram.
2. Adicione @xdocai_bot como membro.
3. Dê permissão para o bot ler mensagens.
4. Vincule o grupo ao seu workspace:

/link seu-tenant-id

Envie como uma mensagem normal no grupo. Você não precisa mencionar Clark nem marcar o bot. Se o Telegram mostrar o comando como /link@xdocai_bot seu-tenant-id, esse formato também funciona.

Se o grupo estava vinculado a outro workspace, Clark moverá o chat para o novo Tenant ID e mostrará a confirmação.

5. Envie uma mensagem que mencione Clark pelo nome, por exemplo: Clark, resuma o que discutimos hoje.

Em chats de grupo, Clark mantém contexto em silêncio e responde apenas quando é mencionado, marcado ou quando alguém responde ao bot. Isso evita interromper a conversa normal da equipe.

Comandos comuns

Comando	Resultado
/help	Mostra comandos disponíveis.
/link <tenant_id>	Vincula ou revincula este chat do Telegram a um workspace.
/link_admin <tenant_id>	Torna este chat do Telegram o único Admin / Master Chat.
/docs	Mostra histórico de documentos processados.
/templates	Mostra modelos de documentos enviados.
/memory	Mostra entidades e fatos lembrados.
/task Prepare report @anna by 15.04 !high	Cria uma tarefa.
/tasks	Lista tarefas no chat atual.
/sum	Cria um resumo do chat atual.
/sum all	Cria um resumo dos chats conectados a partir do master chat.

Resumos automáticos

Admins podem ativar resumos automáticos nas configurações do chat no painel. Clark cria um /sum diário de segunda a quinta no horário local de fim do dia, mas somente se houve mensagens nas últimas 24 horas. Toda segunda-feira às 10:00 no fuso horário do CEO/admin, Clark cria /sum_week da semana anterior. Os resumos são enviados ao Telegram ou, se configurado, em privado ao CEO/admin, e ficam salvos em Memory para contexto futuro.

Documentos no Telegram

Você pode enviar PDF, DOCX, XLSX, CSV, TXT e imagens. Adicione uma legenda se quiser uma ação específica:

Clark, encontre o valor do contrato neste arquivo

template Sales proposal

Clark processará o arquivo e o tornará visível nas seções Documents ou Templates do painel.

Master chat

O master chat é a conversa administrativa usada para resumos entre chats e revisão de tarefas. Pode ser uma conversa privada com o bot ou um grupo dedicado de admins. Configure com /link_admin <tenant_id>. Só pode haver um master chat por workspace; ao vincular um novo, Clark remove o acesso master do anterior. Use-o para:

• /link_admin <tenant_id>
• /sum all
• /tasks all
• revisões semanais
• perguntar o que mudou nos chats conectados da equipe

Apenas administradores aprovados do workspace devem usar esse fluxo. Comandos com all são aceitos apenas no Admin / Master Chat.

Solução de problemas

Problema	O que verificar
O bot não responde em um grupo	Mencione Clark, marque o bot ou responda a uma mensagem do bot.
O bot não vê mensagens	Verifique permissões do grupo Telegram e configurações de privacidade.
Documentos não aparecem	Aguarde o processamento e atualize a aba Documents do painel.
Comandos são ignorados	Confirme que o comando foi enviado em um chat conectado e que o workspace está ativo.
/link recebe uma resposta da IA	Envie /link <tenant_id> novamente depois de adicionar Clark ao grupo; não é preciso mencionar Clark.