Cómo usa ChatISP a Ravisign

ChatISP es el sistema de atención para proveedores de internet de Ravi Systems. Con Ravisign, el proveedor obtiene la firma del contrato dentro de la misma conversación de WhatsApp en la que se atiende al abonado: el abonado recibe el enlace y el código ahí mismo, firma desde el celular y recibe la copia final en la conversación.

Por qué la firma por la conversación es sólida#

Cuando el sobre nace de una conversación de ChatISP, el firmante es el titular ya identificado por el número de WhatsApp en atención. El enlace y el código de confirmación llegan por la conexión del propio proveedor, en la conversación en curso. El registro de auditoría registra el origen (identificadores de la conversación, conexión y protocolo, sin datos personales) junto con el código validado, la IP, la fecha y la hora. Es una evidencia más sólida que un correo electrónico que cualquier persona podría haber registrado.

Qué se puede firmar#

• Contrato de adhesión de un abonado nuevo.
• Renovación de contrato.
• Migración de plan: el abonado pide un plan diferente, recibe la adenda, firma en la conversación y el cambio pasa al sistema de gestión del proveedor.
• Términos sueltos, como cesión de equipo en comodato o autorización de débito.

Los documentos salen de plantillas de Ravisign con variables completadas con los datos del abonado que ChatISP ya conoce: nombre, CPF o CNPJ, dirección del punto, plan, valor y vigencia.

Cómo funciona, paso a paso#

1. Una vez por proveedor: ChatISP guarda, cifrada, la clave de API de la cuenta del proveedor en Ravisign y registra un webhook para recibir los avisos: código solicitado, firma, rechazo, conclusión, expiración y cancelación.
2. Crear el sobre: el agente de atención (o la IA, si el proveedor activa esa acción) elige la plantilla y envía. El abonado entra en el sobre con el canal conversación; otras personas, como un testigo del proveedor, pueden usar el correo electrónico.
3. Entregar la invitación: ChatISP pide a Ravisign el enlace personal y un código de 6 dígitos y envía ambos en la conversación, avisando que el código es válido por 30 minutos.
4. Nuevo código: si el abonado toca Pedir un nuevo código en la página de firma, Ravisign genera otro y avisa a ChatISP, que lo entrega en la conversación.
5. Seguir: el agente de atención ve en la conversación cuándo el abonado firma o rechaza. Los recordatorios en el canal de conversación los hace ChatISP.
6. Concluir: con todas las firmas, ChatISP descarga la copia final, verifica el hash y envía el PDF en la conversación, guardándolo junto con la atención.

Cuando la instalación de ChatISP no tiene una dirección pública con certificado para recibir webhooks, consulta periódicamente el estado de los sobres por la API. Los dos caminos funcionan.

Acción de la IA#

La acción Enviar contrato para firma de la IA de ChatISP nace desactivada. El proveedor decide si la activa y qué plantilla puede usar la IA. Un contrato es algo serio: por eso esta acción es una excepción entre las que ya nacen activadas.

Renovación y migración de plan#

Después de que el abonado firma la renovación o la migración, ChatISP aplica el cambio en el sistema de gestión del proveedor mediante la integración disponible. Donde el sistema de gestión no permite ese cambio automático, ChatISP abre una orden de servicio para que el equipo aplique la migración, como red de seguridad.

Cuenta y plan#

• La cuenta de Ravisign es del proveedor, con panel, usuarios y plantillas propios. Todo lo que se envía por ChatISP aparece en el panel con el origen ChatISP.
• Ravisign es un producto aparte, con plan y cobro propios: la licencia de ChatISP no incluye ni descuenta Ravisign. ChatISP muestra el estado de la cuenta y el camino para contratar o cambiar de plan.
• Sin un plan activo en Ravisign, ChatISP no envía contratos.

Próximamente creación y vinculación de la cuenta directamente desde ChatISP, sin escribir nada, a partir de la licencia de la instalación. Mientras tanto, cree la cuenta por el sitio, genere una clave de API en Configuración > Claves de API con los alcances envelopes.escrever, envelopes.ler, modelos.ler, documentos.ler y conta.ler, y regístrela en ChatISP.

Próximamente: código de confirmación por WhatsApp mediante la API oficial y por SMS, para sobres que no nacen de una conversación.

Para quien integra otro sistema de atención#

ChatISP usa la misma API pública que cualquier integrador puede usar. Para reproducir este flujo en su sistema, consulte Firmantes (enlace y código por su canal) y Webhooks (evento signatario.otp_solicitado). Buenas prácticas del flujo:

• No guarde ni registre en logs el código de confirmación después de entregarlo.
• Ante un 429 cota_excedida, espere el Retry-After. Un 429 otp_reenvio_limite solo se libera a lo largo de la hora siguiente: use el código ya generado, que devuelve signatarios/otp_pendente.
• Antes de crear otro sobre después de una falla de red, busque por referencia_externa en envelopes/listar para no duplicarlo.