ClickSign
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:
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
SandBox do ClickSign
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.
