Como o ChatISP usa o Ravisign

O ChatISP é o sistema de atendimento para provedores de internet da Ravi Systems. Com o Ravisign, o provedor colhe a assinatura do contrato dentro da própria conversa de WhatsApp em que o assinante está sendo atendido: o assinante recebe o link e o código ali mesmo, assina pelo celular e recebe a via final na conversa.

Por que a assinatura pela conversa é forte#

Quando o envelope nasce de uma conversa do ChatISP, o signatário é o titular já identificado pelo número de WhatsApp em atendimento. O link e o código de confirmação chegam pela conexão do próprio provedor, na conversa em andamento. A trilha de auditoria registra a origem (identificadores da conversa, conexão e protocolo, sem dados pessoais) junto com o código validado, o IP, a data e a hora. É uma evidência mais forte do que um e-mail que qualquer pessoa poderia ter cadastrado.

O que dá para assinar#

• Contrato de adesão de um assinante novo.
• Renovação de contrato.
• Migração de plano: o assinante pede um plano diferente, recebe o aditivo, assina na conversa e a mudança segue para o sistema de gestão do provedor.
• Termos avulsos, como cessão de equipamento em comodato ou autorização de débito.

Os documentos saem de modelos do Ravisign com variáveis preenchidas pelos dados do assinante que o ChatISP já conhece: nome, CPF ou CNPJ, endereço do ponto, plano, valor e vigência.

Como funciona, passo a passo#

1. Uma vez por provedor: o ChatISP guarda, cifrada, a chave de API da conta do provedor no Ravisign e cadastra um webhook para receber os avisos: código pedido, assinatura, recusa, conclusão, expiração e cancelamento.
2. Criar o envelope: o atendente (ou a IA, se o provedor ligar essa ação) escolhe o modelo e envia. O assinante entra no envelope com o canal conversa; outras pessoas, como uma testemunha do provedor, podem usar o e-mail.
3. Entregar o convite: o ChatISP pede ao Ravisign o link pessoal e um código de 6 dígitos e envia os dois na conversa, avisando que o código vale 30 minutos.
4. Novo código: se o assinante tocar em Pedir novo código na página de assinatura, o Ravisign gera outro e avisa o ChatISP, que entrega na conversa.
5. Acompanhar: o atendente vê na conversa quando o assinante assina ou recusa. Lembretes no canal conversa são feitos pelo ChatISP.
6. Concluir: com todas as assinaturas, o ChatISP baixa a via final, confere o hash e envia o PDF na conversa, guardando-o junto do atendimento.

Quando a instalação do ChatISP não tem um endereço público com certificado para receber webhooks, ela consulta a situação dos envelopes pela API periodicamente. Os dois caminhos funcionam.

Ação da IA#

A ação Enviar contrato para assinatura da IA do ChatISP nasce desligada. O provedor decide se liga e qual modelo a IA pode usar. Contrato é coisa séria: por isso essa ação é uma exceção às que já nascem ligadas.

Renovação e migração de plano#

Depois que o assinante assina a renovação ou a migração, o ChatISP aplica a mudança no sistema de gestão do provedor pela integração disponível. Onde o sistema de gestão não permite essa alteração automática, o ChatISP abre uma ordem de serviço para a equipe aplicar a migração, como rede de segurança.

Conta e plano#

• A conta do Ravisign é do provedor, com painel, usuários e modelos próprios. Tudo o que é enviado pelo ChatISP aparece no painel com a origem ChatISP.
• O Ravisign é um produto à parte, com plano e cobrança próprios: a licença do ChatISP não inclui nem desconta o Ravisign. O ChatISP mostra a situação da conta e o caminho para contratar ou trocar de plano.
• Sem plano ativo no Ravisign, o ChatISP não envia contratos.

Em breve criação e vínculo da conta direto do ChatISP, sem digitar nada, a partir da licença da instalação. Até lá, crie a conta pelo site, gere uma chave de API em Configurações > Chaves de API com os escopos envelopes.escrever, envelopes.ler, modelos.ler, documentos.ler e conta.ler, e cadastre-a no ChatISP.

Em breve: código de confirmação por WhatsApp pela API oficial e por SMS, para envelopes que não nascem de uma conversa.

Para quem integra outro sistema de atendimento#

O ChatISP usa a mesma API pública que qualquer integrador pode usar. Para reproduzir esse fluxo no seu sistema, veja Signatários (link e código pelo seu canal) e Webhooks (evento signatario.otp_solicitado). Boas práticas do fluxo:

• Não guarde nem registre em log o código de confirmação depois de entregue.
• Em 429 cota_excedida, espere o Retry-After. 429 otp_reenvio_limite só libera ao longo da hora seguinte: use o código já gerado, que signatarios/otp_pendente devolve.
• Antes de criar outro envelope depois de uma falha de rede, procure por referencia_externa em envelopes/listar para não duplicar.