Inteligência artificial
Como a inteligência artificial trabalha no ChatISP: a assistente que atende o cliente sozinha pelo WhatsApp, consulta a rede e o financeiro e executa ações na conta; os recursos de IA que ajudam o atendente no dia a dia; e o Copiloto do painel. Aqui você encontra a configuração, as regras que a IA segue, os limites, os custos e o que acontece com os dados.
Visão geral: os três papéis da IA
O que diferencia o ChatISP é a integração com o Ravicor, a gestão de rede do provedor. A assistente de IA não responde só com texto pronto: ela enxerga o cadastro do assinante no ERP, o financeiro, a sessão de internet, o equipamento e o Wi-Fi, e com isso diagnostica, executa ações (segunda via, desbloqueio em confiança, troca de senha do Wi-Fi, reinício do equipamento) ou abre uma OS para a equipe técnica quando o problema pede investigação. Ela atende a qualquer hora, sempre que um fluxo entrega a conversa para ela.
No ChatISP a IA aparece em três papéis diferentes:
| Papel | Quem conversa com ela | O que faz |
|---|---|---|
| IA autônoma (a assistente) | O cliente final, pelo WhatsApp | Atende sozinha a conversa que um fluxo entregou para ela: identifica o cliente, consulta rede e financeiro, responde dúvidas com a Base de conhecimento, executa ações liberadas, transfere para o setor certo ou encerra. É o assunto principal desta página. |
| IA de apoio ao atendente | O atendente, dentro da conversa | Sugere a próxima resposta ou melhora o texto digitado, traduz a conversa com cliente de outro idioma, transcreve áudios, resume cada chamado encerrado e prepara o resumo das ordens de serviço. Veja IA de apoio ao atendente. |
| Copiloto | Qualquer usuário do painel | Assistente especialista do próprio ChatISP, aberto pelo botão de brilho no topo: encontra, explica e configura o sistema, consulta dados, sugere respostas ao cliente do atendimento aberto. Tem página própria: Copiloto. |
Nas telas e mensagens do sistema a IA autônoma é chamada de assistente. No chat, cada mensagem enviada por ela aparece identificada como da IA, e tudo o que ela consulta ou executa fica registrado em notas internas na linha do tempo do chamado (o cliente não vê essas notas).
A assistente só atende quando um fluxo entrega a conversa para ela, pela etapa Agente de IA. Sem fluxo com essa etapa, o atendimento é 100% humano (fila e roleta) e a IA autônoma não gasta nada. A frase aparece no próprio cartão de configuração: A assistente só atende quando um fluxo entrega a conversa para ela.
Requisitos e planos
O que cada plano inclui
| Recurso | Disponibilidade |
|---|---|
| IA de apoio (sugestão e melhoria de texto, tradução, resumos), Copiloto | Todos os planos. |
| IA autônoma (a assistente que responde o cliente sozinha) Recurso de plano | A partir do plano NORMAL, e no teste grátis de 10 dias. Em plano sem o recurso, a conversa que chegaria à IA vai para a fila humana com a nota Atendimento autônomo por IA não incluído no plano: conversa levada para a fila. |
| Transcrição de áudios e resposta em voz | Todos os planos. Rodam no próprio servidor e aparecem na tela com o selo Gratuito: não geram custo de IA. |
Integrações que dão poder à IA
A assistente funciona sem nenhuma integração (responde dúvidas, segue as instruções do fluxo e transfere), mas o que ela consegue fazer cresce com o que estiver conectado em Integrações:
- ERP do provedor (IXC, Hubsoft, SGP, Gesprov, ReceitaNet, Pipesoft e outros): identificação do cliente pelo telefone, cadastro, contratos, faturas, segunda via e desbloqueio em confiança (o desbloqueio depende do ERP; veja o comparativo em Integrações).
- Ravicor (gestão de rede): sessão de internet, sinal da fibra, equipamento do cliente, redes Wi-Fi e as ações no equipamento por TR-069 (Wi-Fi, reinício, canal, teste de velocidade).
- Sistemas externos marcados como disponíveis para a IA: operações de consulta que a assistente pode chamar durante a conversa.
- Base de conhecimento: planos, preços, condições comerciais, respostas prontas e o aviso de incidente do momento. Veja Base de conhecimento.
Detalhes de cada integração em Integrações.
Instalação própria e ChatISP Cloud
Todos os recursos de IA desta página valem nas duas formas de uso. A única diferença é a aba IA local das Configurações, que mostra o estado dos serviços de transcrição e de voz no servidor e permite instalá-los: ela existe só na instalação própria Instalação própria, porque no ChatISP Cloud a Ravi Systems cuida desses serviços.
A conexão com a plataforma de IA vem configurada pela Ravi Systems junto com a licença. Você não precisa contratar conta em provedor de IA nem informar chave alguma.
Como a IA entra (e sai) do atendimento
Entrada pela etapa Agente de IA do fluxo
No editor de fluxos, a etapa Agente de IA entrega a conversa para a assistente. Ela tem três campos:
| Campo | O que faz |
|---|---|
| Mensagem antes (opcional) | Texto enviado ao cliente quando a etapa começa. Com texto, ele vale como a resposta desta etapa e a IA fala a partir da próxima mensagem do cliente. Sem texto, a IA responde na hora, com uma saudação natural. |
| Instruções para a IA nesta etapa | Orientações que somam-se à persona configurada (exemplo da própria tela: foque em suporte técnico; se pedirem boleto, use o sistema financeiro). Aceitam as variáveis {nome}, {protocolo} e {telefone}. |
| Fila se a IA transferir para humano | Departamento que recebe a conversa quando a IA decide chamar um atendente. Vazio mantém o departamento atual da conversa. |
A partir daí a conversa fica no estado de atendimento pela IA (visível na aba de IA da tela de conversas) e cada mensagem do cliente acorda a assistente. Como montar o fluxo está em Fluxos.
Quando a IA nunca responde
- Conversa na fila: fila significa aguardando um atendente humano. A IA não responde ali, nem depois de ela mesma ter transferido. A única exceção é o plantão fora do horário (veja Plantão fora do horário).
- Chamado com atendente: conversa atribuída a uma pessoa nunca recebe resposta automática, seja qual for o estado.
- Atendente assumiu durante o processamento: a resposta da IA leva alguns segundos para ser gerada. Antes de enviar, o sistema relê a conversa; se alguém assumiu ou encerrou nesse meio-tempo, a resposta é descartada.
A IA sai quando um humano fala
Se um atendente escreve numa conversa que está com a IA, pelo painel ou pelo celular pareado ao número, a assistente sai de cena na hora: a conversa é transferida para quem escreveu (ou para a fila do departamento, quando a mensagem veio do celular) com a nota Um atendente respondeu na conversa: a assistente saiu do atendimento.
Rede de segurança: IA sem responder
Em Configurações > Atendimento, cartão Fila e inatividade, o campo IA sem responder: mandar para a fila após (min) (padrão 5) protege contra qualquer falha: se a última mensagem do cliente ficou sem resposta da IA por esse tempo, a conversa vai em silêncio para a fila humana, sem enviar nada ao cliente. 0 desliga.
Além disso, quando a chamada à IA falha, o sistema tenta de novo mais duas vezes, com intervalo crescente; na terceira falha a conversa vai para a fila com o motivo registrado.
Configuração da assistente
Tudo fica em Configurações > Atendimento, cartão Atendimento, seção Assistente de IA. É preciso a permissão Configurações do perfil de acesso. Altere os campos e clique em Salvar no fim do cartão.
| Campo | Padrão | O que faz |
|---|---|---|
| Personalidade da assistente | Texto de provedor de internet | Como ela se apresenta e fala com o cliente (até 4.000 caracteres). Em branco usa o padrão. Detalhes em Personalidade e regras fixas. |
| IA pode abrir ordens de serviço internas | Ligada | Quando não consegue confirmar a causa de um problema, a IA registra uma OS para o setor adequado e avisa o cliente. Veja Transferir, encerrar e abrir OS. |
| IA pergunta se o cliente precisa de mais alguma coisa antes de transferir | Ligada | Antes de passar a conversa para a equipe, a IA avisa o que vai encaminhar e pergunta se há mais algum pedido. |
| Subseção Ações que a IA executa sozinha | Todas ligadas | Seis chaves: segunda via, desbloqueio em confiança, Wi-Fi, reinício, canal do Wi-Fi e teste de velocidade. Veja IA com ações. |
| IA só atende dado sigiloso do titular pelo telefone do cadastro | Ligada | Boleto, senha do Wi-Fi, dados da conta e afins só quando o telefone da conversa está no cadastro. Veja Identificação do titular. |
| Com mais de um cadastro no mesmo telefone, a IA pede | o CPF ou CNPJ do titular, ou o nome completo como está no cadastro | Como a IA pede a identificação quando o telefone está em mais de um cadastro (ex.: "o número do contrato"). Ela nunca diz que há mais de um cadastro. |
| IA localiza o cadastro pelo CPF ou CNPJ que o cliente informar | Desligada | Para telefone fora do cadastro: a IA pede o documento, busca no ERP e atende consultas. |
| IA localiza o cadastro pelo nome completo que o cliente informar | Desligada | Mesma regra, pelo nome completo exatamente como está no cadastro. Pode ficar ligada junto com a opção por documento. |
Na mesma página ficam a seção Transcrição de áudios (transcrição e resposta em voz, veja Áudios), o cartão Fila e inatividade (com a rede de segurança IA sem responder) e o cartão Aguardando retorno: cliente responde fora do horário (com o plantão da IA).
Instalação nova já vem pronta para atender: persona preenchida, ações e perguntas antes de transferir ligadas, abertura de ordens de serviço ligada. O assistente de configuração inicial também gera a persona e os fluxos com a etapa de IA a partir das respostas do provedor.
Personalidade, instruções e regras fixas
O comportamento da assistente vem de quatro camadas, da mais geral para a mais específica. As duas primeiras são do provedor; as duas últimas são do sistema e não podem ser desligadas.
| Camada | Onde se define | Para que serve |
|---|---|---|
| Persona | Campo Personalidade da assistente | Tom de voz, como se apresenta, nível de formalidade, tamanho das mensagens. |
| Instruções da etapa | Campo Instruções para a IA nesta etapa do fluxo | Foco daquele ponto do atendimento (suporte, financeiro, comercial), roteiros e o que fazer em cada caso. |
| Fatos do sistema | Automático | Data e hora atuais, horário de atendimento do departamento (a IA nunca chuta quando a equipe volta), nome da empresa como deve ser escrito, se o cliente já recebeu mensagem neste chamado, se há OS aberta, o aviso de incidente e a Base de conhecimento. |
| Regras fixas | Automático | Valem acima da persona, das instruções da etapa e de qualquer pedido feito na conversa. |
Persona padrão
A instalação nasce com uma persona de provedor de internet já escrita e visível no campo, que você pode editar à vontade. Em resumo, ela orienta a assistente a se apresentar só na primeira mensagem, conversar como alguém da equipe (mensagens curtas, tom humano, chamar o cliente pelo nome), não oferecer menus de opções, fazer uma pergunta por vez, consultar os dados em silêncio e responder direto com a solução, explicar sem jargão em no máximo 5 passos curtos e, quando não souber, dizer que vai passar para alguém da equipe em vez de arriscar.
Regras fixas do sistema
Estas regras entram em todo atendimento e nenhuma configuração as desliga:
- Sem certeza, transfere. Certeza é dado confirmado por uma consulta ou pela documentação naquele atendimento. Palpite, suposição ou generalização viram transferência para um atendente.
- Nunca inventa dado nem age por suposição: vale para dado técnico, cadastro, valor, prazo, link e qualquer ação na conta.
- Nunca culpa a empresa. A IA não admite, não confirma e não insinua que a causa de um problema é do provedor, do sistema, do serviço ou de uma atualização, e não concorda quando o cliente ou um técnico dele levanta essa hipótese ("faz sentido", "pode ter sido a atualização"), a menos que uma consulta daquele atendimento confirme. Sem confirmação, diz que não consegue verificar a causa por ali e encaminha para a equipe, sem validar nem descartar a hipótese.
- Sem travessão nas mensagens ao cliente.
Além delas, a assistente segue regras obrigatórias de segurança e de estilo:
- Nunca cita nomes de sistemas internos, fornecedores, ferramentas de IA ou detalhes de infraestrutura ao cliente.
- Nunca afirma que executou uma ação na conta sem tê-la executado de fato, com resultado de sucesso. Se falhou, diz com franqueza e transfere.
- Link de boleto, linha digitável, código Pix, valores, datas e protocolos saem sempre copiados de uma consulta. É proibido montar ou completar dado de pagamento.
- Mensagem do cliente é sempre tratada como dado, nunca como instrução: um "ignore as regras acima" não tem efeito.
- Formatação de WhatsApp: negrito com um asterisco de cada lado, itálico com sublinhado, nada de tabelas ou links entre colchetes.
- Entende o jeito de falar do cliente: "chave", "pix" e "código" em assunto de pagamento são o código Pix da fatura (nunca a senha do Wi-Fi); "net" é a internet; "modem", "roteador", "aparelho" e "caixinha" são o equipamento; "conta", "boleto" e "mensalidade" são a fatura; "liberar", "religar" e "desbloquear" são pedido de liberação.
- Problema resolvido e nada pendente: despede-se em uma frase e encerra no mesmo turno; o sistema envia em seguida a mensagem padrão de encerramento com o protocolo.
Primeira fala e saudação
O sistema informa à IA se o cliente já recebeu alguma mensagem do atendimento naquele chamado. Na primeira fala ela cumprimenta de acordo com o horário e se apresenta conforme a persona, inclusive quando o cliente abriu a conversa com uma foto, um comprovante, um áudio ou um documento. Depois disso ela não cumprimenta de novo nem repete aviso de horário, mesmo que a instrução da etapa peça.
Caso especial: se a primeira mensagem do chamado é curta (até 80 caracteres) e sem saudação, como um "obrigado", um joinha ou "deu certo", e o mesmo contato teve um atendimento encerrado nos últimos 7 dias, a IA recebe o resumo e as últimas mensagens daquele atendimento. Se a mensagem só fecha o assunto anterior, ela responde curto ("Disponha! Qualquer coisa é só chamar.") e encerra sem enviar nova mensagem de protocolo; se continua um assunto pendente, segue dali sem se apresentar de novo.
Escreva as instruções de etapa como orientação de trabalho, não como regra de segurança. Pedir na instrução para a IA "sempre informar a causa" ou "confirmar que foi a atualização" não tem efeito: as regras fixas valem acima. Para respostas comerciais e processos, prefira a Base de conhecimento a textos longos dentro da instrução.
Como a IA decide em cada turno
Cada vez que o cliente fala, a assistente executa um turno: lê o contexto, decide o que fazer e termina com uma única saída (responder, transferir, encerrar ou abrir OS). Dentro do turno ela pode fazer várias consultas e ações, até oito, antes de responder.
- Agrupa as mensagens. Mensagens picadas que o cliente manda em sequência viram um turno só (veja Ritmo da conversa).
- Lê o contexto. As últimas 20 mensagens da conversa (notas internas ficam de fora), as instruções da etapa, a persona, os fatos do sistema e a Base de conhecimento.
- Consulta a situação do cliente quando precisa. Uma consulta traz a ficha do assinante: cadastro no ERP (nome, situação, plano e velocidade, endereço, login), contratos, financeiro (faturas vencidas e a do mês, total em aberto, próximo vencimento, último pagamento), rede (sessão, sinal, equipamento, redes Wi-Fi) e uma lista de alertas já calculados, como financeiro em atraso ou equipamento offline. As senhas do Wi-Fi nunca entram na ficha.
- Consulta sistemas externos que o administrador liberou para a IA, quando o assunto pede.
- Executa ações liberadas (segunda via, desbloqueio, Wi-Fi, reinício, diagnósticos) quando o cliente pede e as regras permitem.
- Responde com base no que encontrou, ou transfere, encerra ou abre OS.
Faturas que a IA oferece
A IA trabalha com as faturas vencidas e a do mês. Fatura de mês futuro já emitida no ERP fica de fora: não é atraso nem dívida, e a IA não oferece. Cliente querendo adiantar mês futuro é transferido.
Quando falta leitura de rede ou o financeiro não responde
Se o cliente não tem equipamento vinculado na gestão de rede, a IA trata isso como limitação do que ela enxerga, nunca como diagnóstico: não diz que "não vê aparelho conectado" nem que o cliente está desconectado. Para cliente sem internet ou com lentidão, segue o roteiro básico (aparelho ligado e com luzes acesas, cabos firmes, tirar da tomada por 10 segundos e ligar de novo) e só transfere se não resolver.
Do mesmo jeito, se a consulta ao financeiro não retornou, a IA nunca diz ao cliente que o sistema financeiro está fora do ar: avisa que a equipe confirma os valores e transfere quando o assunto depende de valor ou fatura.
Travas contra resposta errada
| Situação | O que o sistema faz |
|---|---|
| A IA escreve "vou verificar", "um momento" ou "já te retorno" sem ter consultado nada no turno | Devolve para ela agir agora (consultar e responder com o resultado) ou responder sem prometer retorno. O cliente não fica esperando um retorno que nunca vem. |
| A resposta contém linha digitável ou código Pix que não veio de nenhuma consulta | Primeiro devolve para a IA refazer (a segunda via sai pela ação própria). Se insistir, a mensagem não é enviada e a conversa vai para um atendente com o motivo. |
| Outra mensagem do cliente chegou enquanto a resposta era gerada | A resposta é descartada e um turno novo responde levando tudo em conta (exceto quando o turno já executou ação na conta, para a confirmação não se perder). |
| Nome da empresa escrito com erro de digitação | Corrigido automaticamente para o nome cadastrado na Base de conhecimento. |
O rastro no chamado
Toda consulta e ação da IA vira uma nota interna na linha do tempo do chamado, com o resultado e o tempo gasto. Exemplos: "IA consultou a situação do assinante: ok (3,2 KB em 1,4 s)", "IA localizou o cadastro por CPF/CNPJ", "IA: segunda via enviada ao cliente: fatura ... de 99,90 com vencimento ...", "IA abriu a OS OS-000123". O atendente que assume a conversa vê exatamente o que foi feito, sem precisar perguntar de novo ao cliente.
Identificação do titular
Com a opção IA só atende dado sigiloso do titular pelo telefone do cadastro ligada (o padrão), dado sigiloso e ação na conta só são atendidos quando o telefone da conversa consta no cadastro do cliente no ERP. Isso cobre boleto e segunda via, situação financeira, senha do Wi-Fi, dados cadastrais, desbloqueio e qualquer coisa que só o titular pode ver ou pedir. Dúvida geral sobre o produto ou o serviço continua livre para qualquer pessoa.
Telefone sem cadastro
A IA nunca revela se existe ou não cadastro. O que acontece depende das opções de localização:
| Opções de localização | Comportamento |
|---|---|
| Nenhuma ligada (padrão) | A IA não pede CPF, nome nem outro dado. Diz que vai passar para um atendente e transfere com o motivo "telefone não vinculado ao cadastro". |
| IA localiza o cadastro pelo CPF ou CNPJ que o cliente informar | A IA pede o CPF ou CNPJ uma vez (ou usa o que o cliente já digitou ou mostrou numa imagem), busca no ERP e, localizado, atende consultas: situação, bloqueio, segunda via. |
| IA localiza o cadastro pelo nome completo que o cliente informar | Mesma regra, pelo nome completo exatamente como está no cadastro. Só vale o nome inteiro (duas palavras ou mais) e só quando ele aponta para um único cliente. |
Com o cadastro localizado por documento ou nome, a conversa passa a apontar para ele e o cartão do cliente mostra o vínculo com a observação localizado pelo CPF/CNPJ informado pelo cliente ou localizado pelo nome completo informado pelo cliente. Resultado não localizado, mais de um cliente encontrado ou cliente sem o dado: a IA transfere para um atendente.
Ligar a localização por documento ou nome é decisão e responsabilidade do administrador: quem tiver o documento ou o nome completo de outra pessoa passa a ver dados dela (situação, bloqueio, faturas). Ações na conta continuam exigindo o telefone do cadastro, com uma exceção: a segunda via da fatura, porque quem pede quer pagar a conta.
A busca por documento funciona nos ERPs em que o ChatISP consulta clientes por CPF/CNPJ (IXC, Hubsoft, SGP, Gesprov, ReceitaNet e Pipesoft); a busca por nome usa os cadastros sincronizados dos ERPs integrados.
Telefone em mais de um cadastro
Quando o mesmo telefone aparece em cadastros de clientes diferentes, a ficha que a IA recebe não traz nome, financeiro nem rede de ninguém. A IA pergunta com naturalidade o nome completo do titular (ou o CPF/CNPJ, se o cliente preferir), sem citar nomes, planos, quantos cadastros existem ou de quem são. Se não confere, pede uma única vez o outro dado; sem confirmação, transfere com o motivo "titular não confirmado". Enquanto o titular não é confirmado, nenhuma ação na conta é executada, nem a segunda via.
Cliente com mais de um contrato
Se o cliente tem mais de um ponto instalado, a IA pergunta de qual endereço ele está falando antes de responder sobre a conexão ou agir, citando os endereços. Com o cliente ela fala sempre por endereço, nunca por número de contrato. Desbloqueio, reinício e testes vão para o contrato escolhido; a troca de Wi-Fi vale só para o ponto principal (outro ponto, ela transfere).
Conexão de outra pessoa
É comum, principalmente em zona rural, quem tem sinal pedir pela internet de um vizinho ou parente ("na casa do fulano está sem internet"). Quando o cliente cita um nome diferente do titular ou diz que o problema é na casa de outra pessoa, a IA não responde pelo cadastro da conversa nem consulta a rede dele como se fosse o assunto:
- Com alguma opção de localização ligada, ela pede o CPF/CNPJ ou o nome completo daquela conexão e, localizado, atende a consulta sobre esse cadastro. Ações na conta do terceiro continuam bloqueadas.
- Sem opção ligada, sem o dado ou sem localizar, transfere com o motivo "consulta sobre outro cadastro".
Quando a conversa troca de cadastro, o cartão registra de quem ela falava antes: (antes a conversa apontava para o cadastro de {nome}). Se o próprio titular informa o documento dele, nenhuma nota é gerada.
Desligar IA só atende dado sigiloso do titular pelo telefone do cadastro faz a IA atender dado sigiloso e executar ações para qualquer cadastro identificado, inclusive os localizados por documento ou nome. Só desligue se a política do seu provedor permitir.
IA com ações
Na subseção Ações que a IA executa sozinha, cada chave libera uma ação que a assistente executa quando o cliente pede. A IA usa as mesmas funções que o atendente usa no cartão do cliente, com registro na linha do tempo e nota interna no chat. As seis chaves nascem ligadas; desligue o que não quiser liberar.
| Chave na tela | Depende de | O que acontece |
|---|---|---|
| Enviar a segunda via da fatura | ERP com financeiro integrado | Envia ao cliente o resumo da fatura, a imagem do QR Code e o código Pix copia e cola (ou linha digitável e link), como o atendente envia pela modal de faturas. Com mais de uma fatura possível, a IA pergunta qual. Depois do envio, não repete nenhum dado de pagamento: só confirma que enviou. Fatura sem boleto, Pix nem link emitido no ERP não tem como sair: a IA avisa e transfere. |
| Desbloqueio em confiança no ERP | ERP com desbloqueio (hoje IXC e Hubsoft) | Libera a conexão bloqueada por débito pelas regras do próprio ERP (dias de liberação e restrições). A IA explica antes que é uma liberação temporária e que a fatura precisa ser paga, e repassa a resposta do ERP (aceita ou recusada, com o motivo). Se o pagamento já liberou a conexão sozinho, ela avisa que o cliente já pode navegar. |
| Alterar nome e senha do Wi-Fi | Ravicor conectado | Troca o nome (até 32 caracteres) e/ou a senha (8 a 63 caracteres) da rede escolhida, no equipamento do cliente. A IA confirma antes o que muda e em qual rede, nunca vê nem informa a senha atual, usa a senha que o cliente escolher (nunca inventa) e avisa que os aparelhos vão precisar conectar de novo. |
| Reiniciar o equipamento | Ravicor conectado | Reinício remoto quando o roteiro pede e o cliente confirma que pode ficar uns dois minutos sem internet. No máximo um por atendimento a cada 15 minutos. |
| Analisar o espectro e trocar o canal do Wi-Fi | Ravicor conectado e atualizado | Varredura das redes vizinhas em 2,4 GHz pelo próprio equipamento. Se o canal atual estiver poluído, a IA troca para o menos ocupado (mesma régua da correção automática do Ravicor) e informa de qual canal para qual; se não compensar, diz que o canal atual já é o melhor. Usada para lentidão ou queda só no Wi-Fi. |
| Teste de velocidade | Ravicor conectado e atualizado | Medida feita pelo próprio equipamento, por cabo, sem o Wi-Fi no meio: é a velocidade que chega na casa. A IA compara com a velocidade do plano ao informar. |
Regras que valem para todas as ações
- Só para o titular: o telefone da conversa precisa estar no cadastro, ou o vínculo precisa ter sido feito por um atendente. Cadastro localizado pela IA por documento ou nome não vale, exceto para a segunda via. O sistema confere de novo na hora de executar, independentemente do que a IA decidiu.
- Telefone em mais de um cadastro: nenhuma ação até o titular ser confirmado.
- Uma ação por vez, sempre depois de consultar a situação do cliente naquele atendimento. A IA responde ao cliente com base no resultado, nunca antes.
- Falhou, diz que falhou: com resultado negativo a IA diz com franqueza que não conseguiu e transfere para um atendente com o motivo. Nunca finge sucesso.
- Ações valem acima das instruções de etapa: se a instrução do fluxo manda transferir para um atendente para o mesmo fim (por exemplo, segunda via), a ação liberada prevalece.
- Registro: cada ação gera um evento na linha do tempo e uma nota interna "IA: ..." no chat, com o que foi feito.
Diagnósticos que levam tempo
O teste de velocidade e a análise de canal são executados pelo equipamento do cliente, no ritmo dele. A IA dispara o diagnóstico e espera até cerca de 20 segundos. Se não terminou, ela avisa o cliente que o teste está rodando e que volta com o resultado. O sistema acompanha a cada 30 segundos, por até cerca de 5 minutos, e quando o resultado chega a IA é acordada e informa o cliente, mesmo sem nova mensagem dele. Sem resposta do equipamento nesse prazo, o teste é dado como sem resposta.
O teste de velocidade e a troca de canal exigem uma versão do Ravicor que ofereça esses diagnósticos. Se a gestão de rede do provedor ainda não os tiver, a IA deixa de oferecer esses dois recursos por 24 horas e volta a tentar depois, sem nenhum aviso ao cliente. As outras ações seguem normais.
Comprovante de pagamento: quando o cliente manda o comprovante (imagem ou PDF), a IA lê valor e data, confere com as faturas e, se o cadastro está bloqueado e o desbloqueio está liberado, pode liberar em confiança até a baixa do pagamento, avisando que é temporário.
Transferir, encerrar e abrir OS
Transferência para a equipe
Ao transferir, a IA escreve um motivo para o atendente (o cliente não vê) e, opcionalmente, uma mensagem curta ao cliente. O destino segue esta ordem:
- Com dois ou mais departamentos ativos, a IA recebe a lista e escolhe pelo assunto: cobrança, fatura, bloqueio e negociação para o financeiro; planos, contratação, upgrade e mudança de endereço para o comercial; conexão, Wi-Fi, equipamento, lentidão e visita técnica para o suporte. O motivo registra "setor escolhido pela IA".
- Se o nome não corresponde a um departamento ativo, ou nenhum se encaixa, vale o departamento da conversa (o da etapa do fluxo, quando definido).
Pergunta antes de transferir
Com IA pergunta se o cliente precisa de mais alguma coisa antes de transferir ligada, na hora de transferir a IA primeiro avisa em uma frase o que vai encaminhar e para qual equipe e pergunta se o cliente precisa de mais alguma coisa. Na mensagem seguinte, se ele não precisa de mais nada, transfere; se traz outro pedido, atende também, e o que não resolver entra junto no motivo, para o atendente receber tudo de uma vez. A pergunta é feita uma vez por atendimento, e quem pede diretamente para falar com um atendente é transferido na hora.
A etapa Transferir dos fluxos tem uma opção equivalente para conversas que não passam pela IA (veja Fluxos).
Encerramento
Com o problema resolvido, a IA se despede e encerra; o sistema envia a mensagem padrão de encerramento com o protocolo. Se houver motivos de encerramento cadastrados em Cadastros, a IA escolhe o que melhor descreve o assunto do atendimento, para alimentar os relatórios por tipo de chamado. Ela nunca inventa motivo fora da lista; se nenhum descreve, encerra sem motivo.
Abrir OS interna
Com IA pode abrir ordens de serviço internas ligada, a IA registra uma OS quando algo precisa de investigação interna da equipe, sem o cliente na linha (suspeita de falha ou comportamento estranho depois de uma mudança, algo que exige verificação no sistema), em vez de dar palpite:
- Escreve título e descrição com o que o cliente relatou e o que ela já verificou, só fatos.
- Escolhe o tipo de OS pelo nome entre os tipos ativos; a OS vai para a equipe daquele tipo. Na dúvida, deixa sem tipo e a OS fica em aberto para toda a equipe.
- Avisa o cliente que registrou uma solicitação interna e que a equipe vai verificar e retornar, sem prometer prazo nem resultado.
- No máximo um OS aberta por atendimento: com um já aberto, apenas informa que a equipe já está verificando.
- No quadro de ordens de serviço, a origem aparece como IA, e o chat ganha a nota interna "IA abriu a OS ...". O resumo do atendimento para a equipe é gerado automaticamente.
OS não substitui atendimento. Se o cliente está na conversa esperando uma resposta que a IA não tem (dúvida técnica ou comercial, orçamento, dimensionamento), o caminho é transferir para um atendente, nunca abrir OS no lugar da fila. Abrir OS também não encerra o atendimento. Se a criação da OS falhar, a IA não envia a mensagem de confirmação e a conversa vai para a fila.
O funcionamento do quadro está em Ordens de serviço.
Ritmo da conversa: agrupamento e "digitando"
Clientes de WhatsApp costumam mandar a mensagem em pedaços ("oi", "bom dia", "minha internet", "caiu"). Para não responder cada pedaço, a assistente espera um pouco antes de agir:
- Agrupamento: cada mensagem do cliente arma uma espera de 8 segundos. Se chega outra nesse intervalo, a espera recomeça. Quando o cliente para, a IA responde uma vez só, com tudo o que ele mandou.
- "Digitando..." segura a resposta (conexões por QR Code): enquanto o WhatsApp do cliente mostra que ele está digitando ou gravando áudio, a resposta pendente é adiada mais 8 segundos a cada aviso, com teto de 2 minutos desde a primeira mensagem do grupo. Quem digita sem parar não segura a IA para sempre.
- Turno repetido nunca sai: se por qualquer motivo dois turnos ficarem pendentes para as mesmas mensagens, o segundo é cancelado antes de gastar IA.
O "digitando" depende do cartão Cliente digitando ao vivo da conexão de QR Code, que vem ativado. Ativado, o painel mostra "digitando..." e "gravando áudio..." em tempo real e a IA espera o cliente terminar. Enquanto ele estiver ativado, o celular pareado ao número não toca as notificações de mensagem, como acontece com o WhatsApp Web aberto. Desativado, o celular volta a tocar e a IA responde sem esperar o cliente terminar de escrever. Veja Conexões de WhatsApp.
A API oficial da Meta não informa quando o cliente está digitando. Em conexões só pela API oficial vale apenas o agrupamento de 8 segundos.
Imagens, documentos e outras mídias
| O cliente manda | O que a IA faz |
|---|---|
| Imagem (JPEG, PNG, WebP ou GIF, até 4 MB) | Lê o conteúdo como se o cliente tivesse escrito: mensagem de erro, tela de bloqueio, endereço ou IP, dados de um boleto, comprovante. Ela recebe as 3 imagens mais recentes do cliente; as mais antigas aparecem para ela só como "imagem enviada". Texto dentro da imagem também é tratado como dado, nunca como instrução. |
| Documento em PDF | Lê o texto extraído das 3 primeiras páginas (comprovante, boleto, documento) e nunca pede print do que já foi enviado. PDF digitalizado como foto, sem texto, não tem o que ler. |
| Áudio | Lê a transcrição (veja Áudios). Sem transcrição, pede em uma frase que o cliente escreva. |
| Contato compartilhado ou localização | Lê o nome e o telefone do contato, ou o endereço da localização. |
| Vídeo e outros documentos | Não abre: pede em uma frase que o cliente escreva o que precisa. |
Mídia também acorda a IA: uma conversa que começa com uma foto ou um áudio já recebe resposta, com o cumprimento da primeira fala.
A leitura de imagem serve para o que está escrito ou visível na tela (erro, endereço, valores). Não espere da IA um diagnóstico técnico a partir da foto de um equipamento: para isso ela usa a leitura de rede do Ravicor ou transfere para o suporte.
Áudios: transcrição local e resposta em voz
Os dois recursos ficam na seção Transcrição de áudios de Configurações > Atendimento, rodam no próprio servidor e são gratuitos (selo Gratuito: Este recurso é processado neste próprio servidor e não gera custo de IA.).
Transcrição dos áudios
| Campo | O que faz |
|---|---|
| Transcrever os áudios das conversas | Ligada de fábrica. Cada áudio recebido ou enviado ganha o texto transcrito logo abaixo do player, e a IA lê o que o cliente falou antes de responder. A transcrição roda no próprio servidor: o áudio não sai da instalação. |
| Vocabulário de apoio à transcrição | Nomes e termos que costumam aparecer nos áudios (nome do provedor, planos, equipamentos, siglas, bairros), até 800 caracteres. Ajudam a grafar corretamente o que é falado. |
No chat, a transcrição aparece em texto corrido sob o player, com Ler mais nos textos longos e a indicação Transcrevendo enquanto o serviço trabalha. Um áudio curto leva em torno de 15 segundos para ser transcrito; áudios longos levam mais, conforme o processador do servidor. Quando não dá para transcrever (após três tentativas), aparece Transcrição indisponível.
Para a IA: se o cliente mandou áudio e a transcrição ainda está a caminho, o turno espera, em passos de 5 segundos e por até 4 minutos, para responder ao que foi dito e não a um "áudio recebido". Se o serviço de transcrição está parado, a IA não espera e pede que o cliente escreva.
Com a tradução automática ligada na conversa, a transcrição também é traduzida para o idioma do atendente (veja IA de apoio).
Resposta em áudio
| Campo | O que faz |
|---|---|
| Responder em áudio quando o cliente falar por áudio | Ligada de fábrica. Quando a pergunta chega em áudio, a resposta da IA sai como nota de voz gerada no próprio servidor, em português. Independe da transcrição. |
| Voz da assistente | Aparece com a chave ligada. Quatro vozes em português (Faber, a padrão, Cadu, Jeff e Edresson). Use Ouvir para comparar antes de escolher; a troca vale a partir da próxima resposta. |
Como a decisão é tomada em cada resposta:
- Regra automática: se o cliente falou por áudio desde a última mensagem enviada, a resposta sai em voz.
- A pedido do cliente: "me manda um áudio" (dirigindo, sem poder ler agora) faz aquela resposta sair em voz, mesmo que ele tenha escrito.
- Preferência permanente: se o cliente pede para sempre receber áudio (não sabe ler, enxerga mal), a IA registra a preferência para o telefone dele, que vale também nos próximos atendimentos, e a equipe recebe a nota interna "IA registrou preferência do cliente: sempre responder em áudio". Pedindo texto de volta, a preferência é removida.
- O que nunca vira voz: resposta com link, e-mail, boleto, linha digitável, código Pix ou número longo sai em texto, porque é dado que o cliente copia ou toca. Listas e respostas longas (mais de 450 caracteres) também saem em texto, a não ser que o cliente tenha pedido áudio, caso em que o limite sobe para 1.200 caracteres.
- Falha nunca deixa o cliente sem resposta: se a geração do áudio falhar ou o canal recusar a nota, o mesmo texto é enviado por escrito.
Na bolha da nota de voz, o texto falado aparece como transcrição: o atendente lê o que a IA disse sem precisar ouvir. Valores em reais são falados por extenso ("89 reais e 90 centavos").
Aba IA local Instalação própria
Em Configurações > IA local (visível para quem tem a permissão Servidor (rede e certificado)) você vê se a transcrição e a voz estão funcionando, o motivo quando não estão (não instalada, parada, sem responder há mais de um minuto, processador incompatível) e o botão Instalar agora, que instala o que falta sem derrubar o atendimento. Em máquina virtual com o tipo de processador genérico, a transcrição pode ficar Indisponível neste processador: a tela explica como trocar o tipo para "host" no hipervisor. Veja Configurações.
Plantão fora do horário
A IA autônoma atende a qualquer hora as conversas que os fluxos entregam para ela. O plantão é outra coisa: é a IA cobrindo, fora do horário, conversas que já estão com a equipe humana. Ele é configurado no cartão Aguardando retorno: cliente responde fora do horário, em Configurações > Atendimento. A escolha é salva na hora, sem botão Salvar.
| Opção | O que acontece |
|---|---|
| Silêncio | Nada é enviado: o retorno fica aguardando o atendente, que vê a mensagem quando o expediente abrir. |
| Aviso de retorno (recomendado) | O cliente recebe na hora a confirmação de que o retorno chegou e o horário em que o atendente retoma o chamado, calculado da grade de horários. |
| Aviso + IA de plantão Recurso de plano | Além do aviso, a assistente se oferece para ajudar enquanto isso. Exige IA autônoma no plano (a tela mostra Requer IA autônoma no plano). |
Com Aviso + IA de plantão, a IA responde fora do horário em dois casos:
- Chamado de um atendente marcado como aguardando retorno do cliente: quando o cliente responde fora do horário, recebe o aviso com a oferta (campo Mensagem do aviso com a oferta da IA, que aceita {retorno}, {protocolo} e {nome}) e as mensagens seguintes são respondidas pela IA.
- Conversa na fila fora do horário, sem atendente: ninguém vai assumir até a próxima abertura, e o cliente que continua falando é respondido pela IA em vez de ficar sem resposta.
Regras do plantão
- A IA nunca é dona do chamado: ela sabe que o chamado é do atendente (ou da fila) e que ele retoma na próxima abertura. Ajuda no que consegue confirmar pelos sistemas, coleta informações e deixa o caminho pronto.
- Nunca transfere nem encerra: se tentar, o sistema ignora. Quando não puder ajudar, responde que a equipe retoma na próxima abertura.
- Sai quando o atendente fala: qualquer mensagem do atendente desliga o plantão na hora, inclusive descartando uma resposta que estava sendo gerada. A volta do horário de atendimento e o encerramento também desligam.
- Pode usar as ações liberadas e abrir OS como em qualquer atendimento.
O recurso de aguardando retorno está descrito em Atendimento.
IA de apoio ao atendente
Recursos que ajudam quem atende, sem falar sozinhos com o cliente. Valem em todos os planos.
Sugerir ou melhorar a resposta
No campo de mensagem da conversa há um botão de IA com a dica Sugerir resposta com IA (campo vazio) ou melhorar o texto digitado:
- Campo vazio: a IA lê a conversa e sugere a próxima mensagem do atendente, com base apenas no que já foi dito.
- Campo com texto: a IA melhora clareza, tom e ortografia do rascunho, sem mudar o sentido nem acrescentar informação.
O texto volta para o campo de mensagem: nada é enviado sem o atendente revisar e clicar em enviar. A sugestão sai no idioma do atendente, sem travessão e sem inventar valores, prazos ou links. É preciso ter assumido o atendimento; caso contrário aparece Assuma o atendimento para enviar mensagens ao cliente. Para uma ajuda mais completa (conhecer o cliente, histórico, alertas), use a sugestão de resposta do Copiloto.
Tradução automática
O botão de globo no cabeçalho da conversa (Ativar tradução automática) liga a tradução para aquela conversa:
- As mensagens recebidas são traduzidas para o idioma do atendente (o idioma da conta dele, ou o do sistema) e aparecem com a marca Traduzido; um clique mostra o original lado a lado.
- O atendente escreve no próprio idioma; o cliente recebe a mensagem traduzida para o idioma detectado dele. No painel, a mensagem enviada aparece como foi digitada.
- Ao ligar, as 20 últimas mensagens recebidas ainda sem tradução são traduzidas. Áudios transcritos também são traduzidos.
- A tradução é fiel: não muda o contexto nem o conteúdo. Se a tradução da mensagem enviada falhar, o original é enviado.
Resumo dos chamados encerrados
Todo chamado encerrado em que o cliente falou alguma coisa ganha, automaticamente, um título descritivo (até 70 caracteres, como "Lentidão após troca de roteador") e um resumo de 2 a 4 frases: o que o cliente trouxe, o que foi feito e o desfecho ou pendência. Os resumos aparecem no botão Chamados anteriores do cabeçalho da conversa, que lista o histórico do cliente com data, título e resumo, e são lidos pelo Copiloto para alertar sobre problemas recorrentes.
Resumo para as ordens de serviço
Quando uma OS nasce de um atendimento, a IA prepara o briefing para a equipe: o que o cliente relatou (sintomas, desde quando, o que já tentou), o que o atendimento verificou ou orientou e o que fica pendente, com dados úteis como endereço e horário combinado. Se o chamado é encerrado com a OS ainda aberto, o briefing é refeito cobrindo a conversa inteira. Veja Ordens de serviço.
Nos fluxos
Nos menus dos fluxos, a IA interpreta respostas em texto livre ("quero ver minha fatura" escolhe a opção do financeiro) e pode redigir o título e a descrição curtos de cada opção dos menus em lista da API oficial do WhatsApp. Esses usos aparecem separados no consumo de IA. Veja Fluxos.
Consumo e custos de IA
A tela Consumos de IA mostra o que a IA consumiu em cada chamado e quanto custou. Para abrir: menu Auditoria, botão Consumos de IA no topo. Exige a permissão Auditoria.
O que a tela mostra
| Elemento | Conteúdo |
|---|---|
| Seletor de período | Últimos 7 dias, Últimos 30 dias (padrão) ou Últimos 90 dias. |
| Custo no período | Soma em reais, com a cotação do dólar usada (Dólar a ... (cotação de ...)). |
| Chamadas, Tokens de entrada, Tokens de saída | Totais do período. |
| Tabela por chamado | Colunas Chamado (protocolo e cliente), No que (em quais usos a IA trabalhou), Chamadas, tokens e Custo, do uso mais recente para o mais antigo. Usos sem chamado ligado aparecem agrupados como Fora de atendimento. |
Usos contados
A coluna No que separa: Atendimento (a assistente), Resumo do chamado, Resumo de OS, Tradução, Títulos de menu, Interpretação de menu, Texto do atendente (o botão de sugerir e melhorar), Copiloto e Outros. A importação de textos da Base de conhecimento também é contada, numa linha própria.
Como o número é calculado
- Os tokens são os informados pela própria plataforma de IA em cada resposta, nunca uma estimativa do ChatISP.
- O custo é calculado pela tabela oficial de preços do modelo usado (em dólar por milhão de tokens) e convertido para reais pela cotação do dia, atualizada a cada 12 horas. Sem cotação disponível, a tela avisa Sem cotação do dólar disponível: valores exibidos em dólar (US$).
- Transcrição e voz não aparecem: rodam no próprio servidor e não têm custo de IA.
Use a tela para entender onde está o consumo: um atendimento longo com muitas consultas consome mais que vários atendimentos curtos. Instruções de etapa enxutas e a Base de conhecimento bem organizada (em vez de textos repetidos em cada etapa) ajudam a manter o consumo baixo. O tamanho da base que vai para a IA aparece em Ver o que a IA lê, na tela da Base de conhecimento.
Privacidade: o que vai para a IA
As respostas da assistente, os resumos, as traduções e o Copiloto são gerados pela plataforma de IA da Ravi Systems, fora do servidor do provedor. Em cada chamada vai somente o necessário para aquela tarefa.
| Vai para a plataforma de IA | Fica no servidor |
|---|---|
|
|
Todo conteúdo vindo do cliente, de sistemas externos ou de consultas é marcado para a IA como dado, nunca como instrução, o que protege contra tentativas de manipular a assistente pela conversa.
Para limitar o que a IA vê de cada cliente, mantenha ligada a opção IA só atende dado sigiloso do titular pelo telefone do cadastro e deixe as opções de localização por documento e nome desligadas, a menos que a política do provedor peça o contrário.
Problemas comuns
| Sintoma | Causa provável e o que fazer |
|---|---|
| A IA não responde ninguém | Nenhum fluxo ativo entrega a conversa para uma etapa Agente de IA, ou o plano não inclui IA autônoma (a conversa vai para a fila com a nota de plano). Confira os fluxos e o plano em Conta. |
| A IA parou de responder no meio do atendimento | Um atendente escreveu na conversa (a IA sai de cena), a conversa foi transferida para a fila (a IA não responde na fila) ou a rede de segurança IA sem responder levou a conversa para a fila. A linha do tempo do chamado mostra qual foi. |
| A IA transfere todo mundo com "telefone não vinculado ao cadastro" | Os telefones dos clientes não estão no cadastro do ERP, ou o ERP não está integrado. Corrija o cadastro ou avalie ligar a localização por CPF/CNPJ ou nome. |
| A IA não envia a segunda via nem desbloqueia | Chave da ação desligada, ERP sem o recurso, cliente identificado por documento ou nome (desbloqueio exige o telefone do cadastro), telefone em mais de um cadastro sem titular confirmado, ou fatura sem cobrança emitida no ERP. A nota interna "IA: ..." no chat mostra o motivo. |
| A IA não oferece teste de velocidade nem troca de canal | O Ravicor não está conectado ou ainda não tem esses diagnósticos. Atualize o Ravicor; a IA volta a tentar em até 24 horas. |
| A IA respondeu antes de o cliente terminar de escrever | Conexão pela API oficial (sem aviso de digitação) ou cartão Cliente digitando ao vivo desativado na conexão de QR Code. |
| Áudio do cliente sem transcrição | Transcrição desligada na aba Atendimento ou serviço parado. Na instalação própria, veja a aba IA local. |
| A chave de resposta em áudio não aparece | O serviço de voz não está instalado no servidor. Na instalação própria, instale pela aba IA local. |
| A IA escreve o nome da empresa errado | Preencha Nome da empresa (como a assistente escreve) na Base de conhecimento. |
| A IA cumprimenta de novo no meio da conversa | Instrução de etapa pedindo saudação em toda resposta. O sistema já bloqueia a saudação repetida; revise a instrução para deixar a saudação só na persona. |
Outros sintomas em Solução de problemas.