Contratos (ZapSign)
Como conectar o ZapSign, colar o webhook e mapear as variáveis dos modelos para enviar contratos por assinatura digital direto do atendimento.
O Fluxo Jurídico permite enviar contratos para assinatura digital direto do atendimento, usando o serviço ZapSign. Em vez de sair do sistema, montar o documento à mão e enviar por fora, você conecta a sua conta do ZapSign uma única vez e o Fluxo passa a gerar o contrato já preenchido com os dados da pessoa em atendimento.
Para isso funcionar, duas coisas precisam estar prontas: conectar a sua conta do ZapSign (informando a chave — o aviso de status, o *webhook*, passa a ser configurado automaticamente) e dizer de onde vem cada dado que preenche o modelo. Este artigo mostra o passo a passo de cada parte.
Você cria e edita os modelos de contrato dentro do ZapSign, não no Fluxo. Aqui no Fluxo você apenas conecta a conta e diz de onde vem cada informação. Se um modelo não existir no ZapSign, ele não aparece na tela de Contratos.
Passo 1 — Conectar a sua conta do ZapSign
- 1Abra a tela de conexãoVá em Configurações › Certificados digitais. Você verá um card do ZapSign.
- 2Clique em ConfigurarNo card do ZapSign, clique no botão Configurar (se já tiver conectado antes, o botão aparece como Editar).
- 3Cole a chave do ZapSignNo campo API Key, cole a chave da sua conta do ZapSign. O link Obter chave, logo abaixo do campo, abre a página certa dentro do ZapSign para você copiar essa chave.
- 4Confira se a chave está certaClique em Testar chave. Se aparecer a mensagem de conexão OK, está tudo certo. Se der erro, confira se copiou a chave completa.
- 5SalveClique em Salvar. O card passa a mostrar a etiqueta verde Ativo, indicando que a conexão está funcionando.
A chave é guardada de forma criptografada e segura, nunca fica visível no navegador. Ao editar a conexão depois, deixe o campo da chave em branco para manter a chave atual sem precisar digitá-la de novo.
Passo 2 — Aviso de status (webhook automático)
O webhook é o que faz o ZapSign avisar o Fluxo automaticamente toda vez que um contrato muda de situação (por exemplo, quando é assinado). A boa notícia: você não precisa configurar nada. Assim que a chave é conectada no Passo 1, o Fluxo registra esse aviso sozinho, de forma segura, dentro da sua conta do ZapSign.
Se em algum momento você colou manualmente um endereço de webhook com ?secret= na URL, dentro de Configurações › Integrações › Webhooks do ZapSign, pode apagá-lo — o novo aviso é registrado automaticamente e de forma mais segura (o segredo não fica mais na URL).
Passo 3 — Dizer de onde vem cada dado (mapear variáveis)
Cada modelo de contrato tem campos que precisam ser preenchidos — por exemplo o nome do cliente, o e-mail, a data. No ZapSign esses campos são chamados de variáveis. O mapeamento é você indicar, para cada variável, de onde o Fluxo deve puxar aquela informação. Feito uma vez, todo contrato daquele modelo já sai preenchido automaticamente.
- 1Abra a tela ContratosNela aparece a lista dos modelos da sua conta do ZapSign. A coluna do meio mostra se cada modelo já está Configurado (verde) ou Não configurado.
- 2Escolha o modeloNa linha do modelo desejado, clique em Mapear variáveis.
- 3Veja a lista de camposAbre uma janela com todas as variáveis daquele modelo. As que têm um **asterisco (*) são obrigatórias** — convém sempre preenchê-las.
- 4Indique a origem de cada campoAo lado de cada variável há um seletor que começa em — não mapear —. Clique nele e escolha de onde vem aquele dado (as opções estão explicadas abaixo).
- 5SalveClique em Salvar mapeamento. O modelo passa a aparecer como Configurado na lista.
Ao escolher a origem de cada variável, você tem estas opções:
- Um campo do contato (nome, telefone, e-mail e outros): o Fluxo preenche sozinho com os dados da pessoa em atendimento, um por contrato.
- 📝 Valor fixo: um texto que é sempre o mesmo em todos os contratos daquele modelo. Você digita o texto no campo que aparece.
- 📅 Data de hoje: preenche com a data do dia em que o contrato é enviado. Você escolhe entre o formato Abreviado (01/01/2025) ou Completo (1º de janeiro de 2025).
- Campos personalizados: se o seu escritório criou campos extras no cadastro de contatos, eles também aparecem aqui para serem usados.
As variáveis que você deixar em — não mapear — simplesmente ficam em branco no contrato. Ainda assim, procure sempre mapear as marcadas com asterisco (*), que são obrigatórias no modelo.
Depois de mapeado, o modelo fica pronto para uso: quando o Robô enviar um contrato, ele usa exatamente esse mapeamento para preencher o documento certo com os dados corretos.
Problemas comuns
- "Não foi possível carregar os modelos" na tela Contratos: a conexão com o ZapSign não está funcionando. Volte a Configurações › Certificados digitais e confira a chave (use o botão Testar chave).
- "Nenhum modelo cadastrado": a conexão está certa, mas ainda não há modelos criados na sua conta do ZapSign. Crie os modelos dentro do ZapSign e eles aparecerão aqui.
- Contratos param de ser enviados ou atualizados: verifique se a conexão continua Ativa. O botão de lixeira no card remove a integração — ao remover, os documentos deixam de ser enviados e de receber atualizações.
Clicar na lixeira no card do ZapSign desconecta a conta. A partir daí, os contratos deixam de ser enviados e de receber atualizações de status até você configurar tudo de novo.