--- title: AI Chat description: Chat de suporte automático para clientes autenticados: repasse à equipe via Telegram e Zalo, botões de atalho e limites sob seu controle. url: https://nexcmp.com/pt/docs/ai/ai-chat/ applies_to: NexCMP 1.6.1 updated: 2026-11-02 --- # AI Chat {#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 {#what-it-does} 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 {#requirements} | Item | Requisito | |---|---| | Módulo e provedor | O módulo **AI** ativado e um [AI provider](https://nexcmp.com/pt/docs/ai/ai-providers/) 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](https://nexcmp.com/pt/docs/administration/telegram-notifications/)). O mesmo canal recebe transferências de atendimento do chat e rascunhos de tickets. | | Dependências | [AI provider](https://nexcmp.com/pt/docs/ai/ai-providers/). | ## Preparar a infraestrutura {#prepare-the-infrastructure} 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](https://nexcmp.com/pt/docs/administration/telegram-notifications/)). Os recursos de suporte reutilizam esse bot e chat. ## Conectar no NexCMP {#connect-in-nexcmp} 1. Certifique-se de que o módulo de IA esteja ativado e o provedor retorne verde nos testes ([AI provider](https://nexcmp.com/pt/docs/ai/ai-providers/)). 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. ![Aba AI settings com os alternadores de IA e Telegram, limites do chat ao vivo e links de atalho](https://nexcmp.com/pt/docs/images/ai/ai-chat-01-settings.webp) ![Página de chat do cliente com o assistente, botões de atalho do Zalo e Telegram e a opção de falar com um atendente humano](https://nexcmp.com/pt/docs/images/ai/ai-chat-02-portal.webp) ## O que o assistente pode e não pode fazer {#what-the-assistant-can-and-cannot-do} - **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 {#staff-hand-off} 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 {#verify} 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 {#limits-notes} - **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 {#troubleshooting} | 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](https://nexcmp.com/pt/docs/ai/ai-providers/). | | 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](https://nexcmp.com/pt/docs/administration/telegram-notifications/). | | 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. |