ClickSign
El equipo de NicoChat evaluó a fondo diversas herramientas para automatizar contratos y decidió empezar integrando ClickSign por los siguientes motivos:
Sobre ClickSign
¿Por qué ClickSign es la mejor herramienta para automatizar contratos?
El equipo de NicoChat evaluó a fondo diversas herramientas para automatizar contratos y decidió empezar integrando ClickSign por los siguientes motivos:
- Precio accesible para el Plan API, a partir de R$ 119
- Sistema de Plantillas, en el que puedes crear un contrato con variables y completarlas vía API
- Fácil y Rápido de Integrar
¿Qué ofrece esta integración?
🔹 Envío Automático de Documentos: envía documentos o datos a una plantilla ya registrada en ClickSign directamente desde el flujo de NicoChat. Automatiza la generación de documentos de manera práctica y eficiente.
🔹 Registro de Firmantes: registra automáticamente a los firmantes, sus calificaciones y cómo deben firmar los documentos, todo dentro del flujo de NicoChat.
🔹 Monitoreo en Tiempo Real: recibe webhooks en tiempo real para seguir el estado de los documentos. Entérate de cuándo un cliente firma, rechaza o cuándo el contrato se finaliza, directamente en tu interfaz de NicoChat.
¿Cómo Conectar?
Suscríbete al Plan Avanzado en ClickSign
Primero, para conectar ClickSign a NicoChat, necesitas tener un Plan Avanzado en ClickSign, para habilitar la integración vía API y Webhook:
Genera un Access Token
Ve a Configuración, luego entra en la pestaña API y genera un Access Token.
Asociar el usuario a la API
Para habilitar el uso del Access Token en la cuenta, es necesario asociar el usuario a la API.
Creando una Plantilla
Para hacer firmas en NicoChat, el mejor camino es crear una plantilla en ClickSign. Para eso, ve a Automatización > Plantillas > Crear Plantilla
Sandbox de ClickSign
Después carga un documento de plantilla. Puedes descargar un ejemplo aquí. Debes colocar las variables según el ejemplo de abajo:
Estas variables son importantes para la implementación de NicoChat. Anota el nombre exacto de cada una.
En NicoChat debes mapear todas las variables en un objeto JSON. La forma más fácil es crear una función JavaScript y pasar todas las variables para crear el JSON:
Guarda los datos en un JSON y ejecuta los 3 pasos de abajo para crear el documento:
El JSON debe insertarse en el paso 1:
El paso 2 puede repetirse varias veces para incluir más de un firmante.
El paso 3 sirve para finalizar el documento.
Plantilla de Ejemplo de NicoChat
Instala la Plantilla de Ejemplo de NicoChat en el enlace de abajo:
Configurando el Webhook
Crear Webhook en NicoChat:
En "Tools", accede a "Webhooks entrantes".
Crea un nuevo Webhook nombrándolo "ClickSign" y copia la URL proporcionada.
Haz clic en “Editar”, activa “Data Preprocessing” e inserta el código de abajo:
function formatarTelefone(telefone){
let whatsapp = telefone.replace(/\D/g, '');
//Adicione aqui exceções de DDi que não devem receber o tratamento do Script
if (telefone.startsWith('+55') || telefone.startsWith('55') || (telefone.startsWith('+') && !telefone.startsWith('+55'))) {
return whatsapp;
}
const ddi = "+55";
let ddd;
if (whatsapp.length === 10 || whatsapp.length === 11) {
ddd = whatsapp.slice(0, 2);
whatsapp = whatsapp.slice(2);
if (parseInt(ddd, 10) <= 28) {
whatsapp = '9' + whatsapp.slice(-8);
} else {
whatsapp = whatsapp.slice(-8);
}
return ddi + ddd + whatsapp;
}
return whatsapp;
}
let email = null, phone = null;
let signer = (payload.event?.data?.signer ||payload.event?.data?.signers?.[0] || payload.document?.signers?.[0] || {});
email = signer.email || payload.event?.data?.user?.email || payload.acceptance?.sender_name;
phone = signer.phone_number || payload.event?.data?.user?.phone_number || payload.acceptance?.signer_phone;
phone = formatarTelefone(phone);
return { email, phone, payload };Después haz clic en “Vista previa de la carga útil” y mapea los campos Email, Phone y Webhook Body según se muestra abajo:
Phone: $.phone
Email: $email
Webhook Body: $.payload
(si no la tienes, puedes crear una variable de tipo JSON)
(Haz clic en Agregar)
Crea un Sub Flujo en NicoChat, inserta un bloque de acción y selecciona Integraciones > ClickSign
Después selecciona “Webhook” e inserta el JSON del “Webhook Body” creado anteriormente. Luego, guarda.
Después vuelve a Tools > Webhooks entrantes y selecciona el flujo creado:
Insertar el Webhook en ClickSign
Obtén el enlace del Webhook, ve a ClickSign > Configuración > API > Webhook e inserta el enlace al crear un nuevo webhook. Selecciona SOLO los eventos que desees para evitar gastos innecesarios de Límites de Webhook.
