AI Chat

Onde no admin: Customers › Support › Ticket, aba AI settings (/support/tickets?tab=settings). Provedor e módulo: System › Settings › AI provider (/settings/ai). Onde no portal: o botão de chat flutuante e a página /chat (modo Ask AI).

O que faz

O AI Chat responde às perguntas dos clientes a qualquer hora, consulta dados da conta deles (saldo, serviços, pagamentos, erros recentes) e pode agir por eles — criar uma VM, alterar um plano — após a confirmação do cliente. Quando o assistente não consegue ajudar, o cliente clica em Talk to a human: o chat é enviado para sua equipe no Telegram e, se ninguém responder a tempo, vira um ticket. As mesmas configurações de IA também permitem que o sistema investigue tickets para sua equipe.

Requisitos

Item	Requisito
Módulo e provedor	O módulo AI ativado e um AI provider salvo e em uso. Sem um provedor, o assistente informa que não está configurado.
Clientes	Apenas clientes conectados. Em uma instalação do NexCMP não há site público, portanto, um visitante que não esteja conectado recebe a mensagem "Sign in to use AI Chat".
Canal da equipe (opcional)	Um bot e chat do Telegram para alertas de admin (consulte Telegram notifications). O mesmo canal recebe transferências de atendimento do chat e rascunhos de tickets.
Dependências	AI provider.

Preparar a infraestrutura

Não é necessário além do AI provider. Se quiser transferência para a equipe:

1. Crie um bot do Telegram com o @BotFather e anote o token.
2. Crie um grupo ou use seu chat privado com o bot e anote o ID do chat.
3. Insira ambos em System › Settings › Admin alerts (consulte Telegram notifications). Os recursos de suporte reutilizam esse bot e chat.

Conectar no NexCMP

1. Certifique-se de que o módulo de IA esteja ativado e o provedor retorne verde nos testes (AI provider).

2. Abra Customers › Support › Ticket e selecione a aba AI settings. A parte superior do cartão esquerdo exibe três tags: AI provider: configured, Telegram: channel present e On shift ou Off shift.

3. Cartão esquerdo AI + Telegram:

   Alternador ou campo	Padrão	Significado
   A IA investiga tickets automaticamente	On	Para um novo ticket ou mensagem, a IA lê os dados do cliente (somente leitura) e escreve a causa provável e um rascunho de resposta como uma nota interna. Ela nunca envia para o cliente.
   Alertas do Telegram para o admin	On	A nota chega no Telegram com os botões Send, Edit e Skip.
   AI auto-reply	Desligado	Envia respostas simples de instruções ou vendas por conta própria quando todas as condições de segurança forem atendidas (confiança de 85% ou mais, sem avisos); enviado após 3 minutos e cancelável no Telegram.
   Categorias permitidas para resposta automática	how_to, sales	Apenas estas.
   Modelo primário, Modelo de fallback	definido pelo provedor	Normalmente, deixe como salvo pela página do provedor de IA.
   ID de usuário do Telegram autorizado a agir	vazio	Vazio significa o chat do canal de alertas.

4. Cartão direito Live chat (customer widget):

   Campo	Padrão	Significado
   Enable chat widget	On	A bolha de chat e a página /chat.
   Horário de suporte (horário do Vietnã)	08:00-22:00	Quando a equipe deve responder no Telegram. Fora desses horários, ou quando nenhum canal do Telegram existir, Talk to a human transforma o chat em um ticket imediatamente.
   Espera máxima pela equipe (minutos), depois converter em ticket	10	1 a 240.
   Turnos de IA / dia / cliente	40	1 a 1000. Após o limite, o assistente convida o cliente a falar com um atendente humano.
   Novos chats / hora / IP	20	1 a 1000.
   Zalo OA link	vazio	https://zalo.me/... Mostra o botão Chat on Zalo (com um código QR) no chat. Vazio oculta-o.
   Telegram link	vazio	https://t.me/... Mostra um botão Telegram. Vazio oculta-o.
   Limite diário geral do sistema de turnos de IA, clientes logados	2000
   Limite diário geral do sistema, visitantes	500	Pool próprio; não usado enquanto convidados não puderem conversar.
   Limite diário geral do sistema de investigações automáticas de tickets	200
   Caminho do admin (o botão "Open admin" do Telegram)	vazio	Sua URL de administrador, por exemplo https://cloud.example.com/admin.

   Cada alternador ou campo é salvo assim que você o altera.

5. Na parte inferior, Reply templates (título, idioma VI/EN/ZH, texto de até 4,000 caracteres) fornecem respostas prontas à equipe.

O que o assistente pode e não pode fazer

• Leitura: ele pesquisa em sua base de conhecimento e documentação pública, além de ler os dados do próprio cliente conectado por meio de ferramentas somente leitura. Ele não pode ver outro cliente.
• Act: ela usa as próprias permissões de API do cliente. Uma leitura (read) é executada imediatamente. Qualquer coisa que altere ou custe dinheiro cria um confirmation card ("Needs your confirmation", com as tags Costs money ou Delete); nada acontece até que o cliente clique em Confirm. Um chat pode manter no máximo 3 cartões pendentes e uma conta no máximo 10 ações de gravação confirmadas por hora.
• Nunca: ele não pode abrir consoles, criar tokens de SSH ou console, baixar arquivos de acesso ao Kubernetes, redefinir senhas ou exibir segredos como senhas de proxy ou segredos S3. Os segredos nunca são incluídos no contexto do modelo ou no histórico do chat.
• Segurança: suas respostas passam por um filtro de saída; o texto do cliente e os resultados das ferramentas são tratados como dados, e não como instruções.
• Aviso de transparência: o chat exibe "Respondido por um assistente de IA — pode conter imperfeições. Fale com um humano para assuntos críticos."

Transferência para a equipe

1. O cliente clica em Talk to a human e pode deixar um e-mail.
2. Uma mensagem com a conversa chega ao chat do Telegram da equipe. A equipe responde respondendo a essa mensagem; a resposta aparece no chat do cliente como "[brand] Support".
3. Se ninguém responder dentro do tempo de espera (padrão de 10 minutos), o chat se torna um ticket em Customers › Support › Ticket. O mesmo acontece imediatamente fora do horário de suporte ou quando o Telegram não está configurado, e o cliente é avisado de que um ticket foi aberto.
4. Os administradores também veem os chats emandamento na aba Live chat.

Verificar

1. Faça login como um cliente de teste, abra o chat e faça uma pergunta sobre os seus serviços. O assistente responderá.
2. Peça para ele criar algo que custe dinheiro: um cartão de confirmação aparecerá e nada será criado até que você clique em Confirm.
3. Clique em Talk to a human. A mensagem chegará ao seu chat do Telegram (se configurado) ou, após o tempo de espera, um ticket aparecerá.
4. Com os links do Zalo e do Telegram preenchidos, ambos os botões de atalho aparecem no chat.

Limites e notas

• Limites de taxa (por IP): 20 mensagens por minuto e algumas transferências por hora; 40 mensagens por conversa. Estes valores são fixos.
• Custo: cada interação da IA aciona o seu provedor. Reduza AI turns / day / customer para limitar os gastos.
• A resposta automática vem desativada por padrão. Ative-a somente após acompanhar os rascunhos por algum tempo.
• Idiomas: o assistente responde no idioma do cliente; o vietnamita é detectado a partir do texto.
• Revendedores: os sites de revendedores usam tickets em vez do widget.

Resolução de problemas

Sintoma	Causa	Correção
Clientes não conseguem ver o chat	Módulo de IA desativado ou Enable chat widget desativado	Ative ambos.
"Sign in to use AI Chat"	O visitante não está conectado	Comportamento esperado no NexCMP: faça login primeiro.
O assistente diz que nenhum provedor de IA está configurado	Provedor ausente, não utilizado ou chave ausente	Conclua AI provider.
A IA responde "talk to a human" após algumas perguntas	Limite diário por cliente atingido	Aumente AI turns / day / customer.
Tag do Telegram mostra "no channel"	Bot ou ID do chat não configurados	Configure as notificações do Telegram.
Botão do Zalo ou Telegram ausente	O campo de link está vazio	Preencha o link.
"Too many requests" no chat	Mais de 20 mensagens por minuto de um IP	Aguarde um minuto.
Conversa do chat cheia	40 mensagens atingidas	Inicie uma nova conversa.