ClickSign
- Nicola Occhipinti
Sobre o ClickSign
Por que o ClickSign é a melhor ferramenta para fazer automações de contratos?
A equipe do NicoChat avaliou a fundo diversas ferramentas para fazer automações de contratos e decidiu iniciar integrando com o ClickSign pelos seguintes motivos:
Valor acessível para o Plano API, com valores a partir de R$119
Sistema de Modelos, em que você pode criar um contrato com variáveis e preenche-las via API
Fácil e Rápido de Integrar
O que esta integração oferece?
🔹 Envio Automático de Documentos: Envie documentos ou dados para um modelo já cadastrado na Clicksign diretamente pelo fluxo do NicoChat. Automatize a geração de documentos de maneira prática e eficiente.
🔹 Cadastro de Signatários: Cadastre automaticamente os signatários, suas qualificações e como devem assinar os documentos, tudo dentro do fluxo do NicoChat.
🔹 Monitoramento em Tempo Real: Receba webhooks em tempo real para acompanhar o status dos documentos. Saiba quando um cliente assina, recusa ou quando o contrato é finalizado, diretamente na sua interface do NicoChat.
Como Conectar?
Assine o Plano Avançado no ClickSign
Primeiramente para conectar o ClickSign com o NicoChat você precisa ter um Plano Avançado no ClickSign , para liberar a integração via API e Webhook:
Gere um Access Token
Vá até Configurações, depois entre na aba API e em seguida gere um Access Token.
Associar o usuário à API
Para liberar a utilização do access token para a conta, é necessário associar o usuário para a utilização da API.
Criando um Modelo
Para fazer assinaturas no NicoChat o melhor caminho é criar um modelo no Clicksign. Para isso vá em Automação > Modelos > Criar Modelo
Se essa opção não tiver ativada para você, você provavelmente não está no plano de API. Entre em contato com as vendas do Clicksign para adquirir um plano. Ou utilize o SandBox para testes:
Depois faça upload de um documento de modelo. Você pode baixar um exemplo aqui. Você deve colocar as variáveis como o exemplo abaixo:
Essas variáveis são importantes para a implementação do NicoChat. Anote o nome exato de cada uma.
No Nico Chat você deve mapear todas as variáveis em um objeto JSON. A forma mais fácil é fazendo uma função Java script e passando todas as variáveis para criar o JSON:
Salve os dados em um JSON e performe os 3 passos abaixo para criar o documento:
O JSON você deve inserir no passo 1:
O passo 2 você pode repeti-lo várias vezes para colocar mais de um signatário.
O passo 3 é para finalizar o documento.
Template de Exemplo NicoChat
Instale o Template de Exemplo do NicoChat no link abaixo:
Configurando o Webhook
Criar Web Hook no NicoChat:
Em "Tools" ou "Ferramentas", acesse "Webhooks de Entrada".
Crie um novo Webhook nomeando-o como "ClickSign" e copie o URL fornecido.
Clique em “Editar”, ative o “Pré-processamento de dados” e insira o código abaixo:
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 };Depois clique em “Pré-visualizar Payload” mapeie os campos de Email, Phone e Webhook Body conforme abaixo:
Phone: $.phone
Email: $email
webhook body: $.payload
(caso n tenha pode criar uma variável do tipo JSON)
(Clique em adicionar)
Crie um subfluxo no NicoChat, insira um bloco de ação e selecione Integrações > ClickSign
Depois selecione “Webhook” e insira o JSON de “webhook body” criado anteriormente. Depois Salve.
Depois volte em Ferramentas > Webhooks de Entrada e selecione o fluxo criado:
Inserir Webhook no Clicksign
Obtenha o link do Webhook, vá no ClickSing > Configurações > API > Webhook e insira o link ao criar um novo webhook. Selecione APENAS os eventos que desejar para evitar gastos desnecessários de Limites de Webhook.