Primeiros passos

O que é o ChatISP

O ChatISP é a central de atendimento por WhatsApp feita para provedores de internet pela Ravi Systems. Ele reúne em um único painel web os números de WhatsApp do provedor, a equipe de atendimento, a inteligência artificial e as informações do assinante: quem está falando, como está a conexão dele e como está o financeiro.

O que diferencia o ChatISP de um atendimento por WhatsApp genérico é que ele conhece a operação de um provedor:

• Rede do assinante, pelo Ravicor: com o Ravicor (a gestão de rede da Ravi Systems, contratada à parte) pareado, o atendente e a IA enxergam durante a conversa a situação real da conexão do cliente (sessão, sinal da fibra, roteador, Wi-Fi) e podem executar ações de diagnóstico. Veja Integrações.
• Cadastro e financeiro, pelo ERP: o ChatISP se conecta direto aos ERPs homologados (IXC Provedor, SGP, Hubsoft, Gesprov, ReceitaNet e Pipesoft) para reconhecer o assinante pelo telefone, mostrar faturas em aberto e enviar segunda via. Outros sistemas entram por API genérica.
• IA que atende de verdade: a assistente de inteligência artificial recebe o cliente, consulta a situação dele, resolve o que pode (segunda via, orientação de Wi-Fi, conexão) e transfere para a equipe quando precisa, com o motivo resumido. Veja Inteligência artificial.
• Atendimento compartilhado: fila por departamento, distribuição automática entre atendentes, transferência, conversa compartilhada, notas internas, mensagens rápidas, pesquisa de satisfação. Veja Atendimento.
• Tudo que a operação pede em volta: ordens de serviço internos, agenda da equipe, chamadas de voz e vídeo pelo WhatsApp, automação de envios (inclusive régua de cobrança), fluxos de autoatendimento, relatórios, auditoria, API pública e webhooks.

O painel é 100% web, funciona em computador, tablet e celular, nos temas claro e escuro, em Português, Inglês e Espanhol.

Como funciona

Em linhas gerais, o caminho de uma mensagem é este: o cliente escreve no WhatsApp do provedor; a mensagem chega ao ChatISP pelo canal daquele número; o sistema identifica o assinante, registra a conversa e decide quem responde (fluxo de autoatendimento, IA ou fila humana); a resposta volta ao cliente pelo mesmo canal.

As peças, em linguagem de operação

As duas formas de usar

O ChatISP é o mesmo sistema nas duas formas de contratação. O que muda é quem cuida da máquina.

Ao longo desta documentação, o que só existe na instalação própria vem marcado com o selo Instalação própria.

Requisitos do servidor Instalação própria

O ChatISP é distribuído como uma imagem de instalação própria, baseada em Debian 13 (64 bits). A imagem instala o sistema operacional e todo o restante: servidor web, banco de dados, serviços do WhatsApp, transcrição de áudio e voz. Você não instala nenhum pacote à mão.

Máquina

Máquina virtual: atenção ao tipo de CPU

Máquina virtual é o caminho mais comum e funciona normalmente. O cuidado é um só: o tipo de CPU da VM precisa repassar as instruções modernas do processador. Em Proxmox e KVM, escolha host (ou x86-64-v2, se a VM precisar migrar entre nós diferentes) em vez do genérico kvm64.

Internet

• O servidor precisa de saída para a internet: é por ela que os números de WhatsApp funcionam, que a licença é validada junto à central da Ravi Systems, que a cópia de segurança diária é enviada e que as atualizações chegam.
• O painel é acessado pelo IP da instalação, já em https com certificado próprio da máquina (o navegador pode pedir uma confirmação no primeiro acesso). Um domínio com certificado reconhecido (seu próprio domínio ou um subdomínio de chatisp.com.br, com Let's Encrypt) pode ser configurado depois em Servidor.
• Para usar a API oficial da Meta, ter o painel publicado em um domínio é o caminho mais simples. Veja Conexões de WhatsApp.

Instalação pela imagem oficial Instalação própria

A instalação é a mesma para servidor físico e máquina virtual: baixar a imagem, conferir, gravar, responder às perguntas do instalador e esperar o primeiro boot terminar. Não há linha de comando, fora a conferência do arquivo.

Passo a passo

1. Baixe a imagem em chatisp.com.br/baixar. A página mostra a ficha da imagem (arquivo, versão, tamanho e o código SHA-256). O download aceita retomada: dá para pausar e continuar depois. Baixar não inicia o teste de 10 dias.
2. Confira o SHA-256 do arquivo baixado e compare com o publicado na ficha. Se forem diferentes, baixe de novo: um arquivo corrompido costuma falhar no meio da instalação com mensagens que não ajudam.
   Linux macOS Windows

   sha256sum <arquivo-baixado>.iso

   shasum -a 256 <arquivo-baixado>.iso

   certutil -hashfile <arquivo-baixado>.iso SHA256

3. Grave e dê boot: grave a imagem em um pendrive (máquina física) ou monte a ISO como mídia virtual no Proxmox, VMware ou no hipervisor que você usar, e dê boot por ela. O menu de boot funciona tanto em BIOS quanto em UEFI.
4. Responda às perguntas do instalador: o instalador gráfico pergunta só o essencial, e o resto já vem respondido dentro da imagem:
   • Idioma: Português do Brasil, Inglês ou Espanhol. O teclado, a localidade e o fuso horário acompanham a escolha, e o painel já nasce nesse idioma.
   • Rede: endereço IP, máscara, gateway e DNS, informados à mão.
   • Senha do root: a única conta do sistema operacional.
   • Confirmação do particionamento: o instalador usa o disco indicado inteiro.
5. Deixe o primeiro boot terminar: ao reiniciar, a máquina cria o banco de dados, prepara os serviços, emite o certificado interno, liga o firewall e publica o painel. Não é preciso fazer nada nessa etapa.
6. Abra o painel no navegador, em https://IP-do-servidor. A primeira tela é a criação do administrador (veja Primeiro acesso).

Depois de instalar

• O fuso horário nasce do idioma escolhido no instalador (Português: São Paulo; Inglês: Nova York; Espanhol: Cidade do México). Para outro fuso, ajuste em Configurações, aba Sistema, campo Fuso horário. Ele alinha horários de atendimento, relatórios e agenda.
• O acesso SSH ao servidor fica na porta 2202, com o usuário root.
• Uma versão nova do ChatISP é aplicada no servidor já instalado: não é preciso baixar a imagem de novo. Veja Servidor.

Primeiro acesso

Enquanto o sistema não tem nenhum usuário, qualquer endereço do painel leva à tela de boas-vindas, Seja bem-vindo ao ChatISP, que cria o primeiro usuário. Ela mostra a trilha de três etapas (Instalar o servidor, Criar o administrador e Configurar o atendimento) e tem seletor de idioma e botão de tema claro e escuro.

Criar o usuário administrador

1. Escolha o idioma no seletor do canto da tela. A página muda na hora, e esse idioma passa a ser o idioma do sistema.
2. Preencha Nome e E-mail. O e-mail é o seu acesso ao sistema e o canal de recuperação de senha.
3. Defina Senha e Confirmar senha. O medidor de força acompanha a digitação, e a senha precisa chegar ao nível Forte: pelo menos 8 caracteres, misturando letras maiúsculas e minúsculas, números e símbolos (ou uma senha mais longa). Palavras óbvias, sequências e trechos do seu nome ou e-mail derrubam a força da senha.
4. Informe o WhatsApp (celular), com DDD: ele recebe os avisos do atendimento.
5. Clique em Criar e entrar. Todos os campos são obrigatórios; o erro aparece embaixo do próprio campo.

O usuário criado aqui fica no perfil Administrador, com acesso total. É com ele que você convida a equipe e define os perfis de acesso depois, em Usuários e perfis. O tema escolhido nessa tela vira a preferência da sua conta. Ao entrar, o sistema abre o assistente de configuração.

Entrar no sistema

O acesso ao ChatISP é feito com E-mail e Senha: não existe um "nome de usuário" separado.

• Manter conectado neste navegador: com a opção marcada, você continua conectado por 30 dias sem informar e-mail e senha de novo. Não marque em computadores compartilhados.
• Esqueci minha senha: o sistema envia um código para o WhatsApp verificado e para o e-mail da conta; com o código, você define a nova senha.
• Se a conta tiver verificação em duas etapas, a tela Confirme sua identidade pede o código do aplicativo autenticador. Veja Minha conta.
• Depois de várias tentativas erradas, a tela avisa Muitas tentativas. Aguarde alguns instantes e tente novamente.
• Um link do sistema aberto sem login (por exemplo, o link de uma OS) leva à tela de entrada e, depois do login, segue para a página pedida.

Onde cada um cai ao entrar

• Quem tem a permissão Supervisionar todas as conversas (Administrador e Supervisor, por padrão) cai na tela Conversas, aberta na Visão geral do atendimento.
• O atendente sem essa permissão trabalha direto no Modo atendimento, a tela dedicada de atendimento.
• Em uma instalação sem nenhum número conectado e sem histórico, a tela Conversas mostra Bem-vindo ao ChatISP com os atalhos Conectar WhatsApp, Montar a equipe e Ajustar o atendimento.

A orientação completa pela tela está em Interface e navegação.

Assistente de configuração

Logo depois de criar o administrador, o ChatISP abre o Assistente de configuração: Vamos deixar tudo pronto. Em sete passos o atendimento nasce configurado (integração, horário, setores, fluxo, base de conhecimento, equipe e WhatsApp). Cada passo grava de verdade, e tudo pode ser ajustado depois nas telas do painel.

Os sete passos

Navegação e retomada

• Os botões Continuar e Voltar andam entre os passos, e Pular este passo deixa o item para depois.
• Concluir depois fecha o assistente e leva ao painel. O progresso fica salvo.
• Enquanto o assistente não é concluído, o administrador vê no topo do painel o botão de bússola Assistente de configuração, com um ponto pulsante. Ele reabre o assistente no passo em que você parou, já com o que foi gravado de verdade nas telas.
• Refazer um passo atualiza o que ele criou (o mesmo fluxo, os mesmos convites), sem duplicar.

Teste grátis de 10 dias Instalação própria

Toda instalação própria nasce em Teste gratuito: 10 dias com todos os recursos liberados, sem limite de atendentes, números, fluxos ou chaves de API. Não é uma versão reduzida: é o ChatISP atendendo os seus clientes de verdade.

• A contagem começa na instalação, não no download.
• Durante o teste, quem tem a permissão Configurações vê no topo do painel a faixa de contagem (Seu teste expira em N dias., depois Seu teste expira AMANHÃ. e Seu teste expira HOJE! Registre para continuar.) com o botão Registrar agora!. Os demais usuários não veem a faixa.
• Ao fim do prazo sem registro, o painel abre a tela Período de teste encerrado para todos. Conversas e configurações continuam salvas, e as mensagens que chegam continuam sendo gravadas; a IA, a distribuição da fila e os envios automáticos ficam em espera até a licença voltar.

Licença e registro

Cada instalação tem um Token da instalação: uma chave única, criada no primeiro uso, que nunca muda. Ela identifica o seu servidor junto à Ravi Systems no registro do plano, no suporte e nas cópias de segurança.

Onde ver o token e o plano

Em Configurações, aba Sistema, o cartão de registro da instalação ("Chave única que identifica esta instalação junto à Ravi Systems") mostra:

Registrar e ativar um plano

1. Clique em Registrar agora! (na faixa do topo durante o teste, no cartão de registro ou na tela de bloqueio). Abre a página de registro em chatisp.com.br, já identificando o seu servidor pelo token.
2. Escolha o plano e a forma de pagamento e conclua o registro.
3. Volte ao cartão de registro em Configurações e clique em Atualizar: o servidor sincroniza com a central na hora e o novo plano passa a valer. Sem esse clique, ele é aplicado na próxima sincronização automática, que acontece a cada 10 minutos.

Sincronização com a central

O servidor sincroniza a licença com a central da Ravi Systems a cada 10 minutos, por canal cifrado. A validação tem folga para quedas de internet:

• Depois de 24 horas sem conseguir sincronizar, quem administra vê a faixa vermelha Sem comunicação com a central da Ravi Systems há N h., com o botão Atualizar.
• Depois de mais de 3 dias sem sincronizar, o painel abre a tela Sem comunicação com a central. A licença volta sozinha na próxima sincronização bem-sucedida.

Tela de licença bloqueada

Quando a licença não está liberada, todas as telas levam à tela de licença, que explica o motivo e o que fazer:

Em todas elas aparecem o token com Copiar, o link Dúvidas sobre planos? Fale com a Ravi Systems e Sair do sistema. Quem tem a permissão Configurações vê também Sincronizar agora, para conferir na hora depois de regularizar.

Planos e limites

O plano é definido na central da Ravi Systems e sincronizado para o seu servidor. Os limites são aplicados na hora de criar ou reativar cada recurso.

O plano anual equivale a 12 mensalidades com 35% de desconto. Os valores acima são os da instalação própria praticados no Brasil e publicados em chatisp.com.br/planos; o ChatISP Cloud tem tabela própria, que já inclui a hospedagem. O teste gratuito equivale ao topo de linha, sem limites.

Plano CUSTOM. Acima de 18 atendentes, a Ravi Systems negocia um plano próprio, caso a caso: o valor e a quantidade de atendentes são definidos no registro da licença, e o resto da tabela segue sem limite, como no ENTERPRISE. O painel mostra o nome CUSTOM no cartão Registro Ravi e aplica o teto combinado no medidor de atendentes.

Como os limites aparecem na tela

• Números de WhatsApp contam por número: um mesmo número conectado pelo QR e pela API oficial ao mesmo tempo conta como um só.
• As telas de atendentes, conexões, fluxos e chaves de API mostram um medidor no cabeçalho, no formato "X de Y do seu plano". Ao atingir o teto, o medidor muda para Teto do plano atingido e o botão de criar some.
• Se alguém tentar criar além do limite, o sistema mostra a mensagem de upgrade (por exemplo, "Limite de atendentes atingido: o plano BASIC permite 2. Faça upgrade do plano para continuar.") e não conclui o cadastro.
• Um recurso fora do plano (como Automação de envios no plano NORMAL) continua visível no menu, mas a tela abre trancada com Recurso não incluído no seu plano e o botão Ver planos.
• Sem o atendimento autônomo por IA no plano, as conversas que iriam para a IA são levadas para a fila humana, com a nota "Atendimento autônomo por IA não incluído no plano: conversa levada para a fila".
• Mudar para um plano menor nunca apaga nada: o que já existe continua funcionando, só não é possível criar mais além do novo limite.

Recurso de plano Ao longo desta documentação, este selo marca os recursos que dependem do plano contratado.

Próximos passos

Com o sistema instalado e o assistente concluído, este é um bom roteiro para colocar a operação de pé:

1. Conheça a tela: Interface e navegação.
2. Confira os números de WhatsApp: Conexões de WhatsApp.
3. Revise setores, horários e a ordem da fila: Departamentos e Fluxos.
4. Ajuste a assistente de IA e a base de conhecimento: Inteligência artificial e Base de conhecimento.
5. Conecte o Ravicor e o ERP, se ainda não conectou: Integrações.
6. Monte a equipe e os perfis de acesso: Usuários e perfis.
7. Cadastre etiquetas, mensagens rápidas e motivos de encerramento: Cadastros.
8. Comece a atender: Atendimento e Ficha do cliente.