Blog

Como integrar a ZapSign ao ProcStudio: passo a passo

Bruno Pellizzetti • • 11 min de leitura
Como integrar a ZapSign ao ProcStudio: passo a passo

Se o escritório já usa a ZapSign para colher assinaturas, os envelopes podem sair direto do ProcStudio, sem baixar o PDF e subir em outro sistema. O documento assinado volta sozinho para o envelope.

A integração é feita uma vez, por um administrador do time. Depois disso, todo envelope com o método ZapSign sai pela conta do escritório.

As telas abaixo seguem a ordem em que aparecem. As imagens são ilustrações com dados fictícios: nomes, e-mails e tokens mostrados não existem.

Antes de começar

Você vai precisar de:

  • Uma conta ZapSign com acesso de administrador, de onde sai o token.
  • Um usuário administrador no ProcStudio. Quem não é administrador vê a mensagem "Acesso Restrito" nessa tela.
  • Créditos na ZapSign, se for usar autenticações pagas (WhatsApp, biometria e outras). A assinatura na tela e o código por e-mail não têm custo adicional.

O token da ZapSign vale para a empresa inteira na ZapSign, não para um usuário. Por isso ele é cadastrado uma vez, no time do ProcStudio, e serve para todos.

Passo 1: copie o token na ZapSign

No painel da ZapSign, abra Configurações > Integrações e a aba API ZapSign.

Ilustração esquemática do painel da ZapSign com a API ativada, o campo Token de acesso e o botão Copiar.

  1. Confirme que a API está ativada.
  2. No campo Token de acesso, clique em COPIAR.
  3. Confira se a seção Webhooks também está ativada. É por ela que a ZapSign avisa o ProcStudio quando alguém assina.

Trate o token como uma senha. Não mande por e-mail nem por mensagem: copie e cole direto no ProcStudio.

Passo 2: cole o token no ProcStudio

No ProcStudio, abra o menu lateral Assinaturas > ZapSign. A tela se chama Configuração ZapSign.

Tela Configuração ZapSign no ProcStudio, com o menu Assinaturas aberto, o aviso de onde obter o token e o campo Token da API ainda vazio, ao lado do botão Salvar.

  1. Cole o token no campo Token da API.
  2. Clique em Salvar — o botão só habilita depois que o campo é preenchido.

O campo fica mascarado. Depois de salvo, o token não volta a aparecer na tela.

Passo 3: confira a conexão

Depois de salvar, o card mostra Token API Configurado, com o token oculto, e os botões Verificar Conexão e Remover Token.

Token API Configurado, faixa verde Conexão ativa e os botões Verificar Conexão e Remover Token.

Clique em Verificar Conexão. Com tudo certo, aparece a faixa verde Conexão ativa.

Se aparecer erro, o motivo mais comum é token copiado pela metade ou de outra conta. Remova, copie de novo na ZapSign e salve outra vez.

Passo 4: veja os dados da conta ZapSign

Logo abaixo, o ProcStudio mostra as Informações da conta ZapSign, lidas direto da ZapSign.

Informações da conta ZapSign: plano Equipe, 145 créditos, status Pago, validade, período mensal e tabela de usuários da conta.

Em Plano aparecem o Nome do plano, os Créditos disponíveis, o Status (Pago, Teste grátis etc.), a Validade e o Período (Mensal ou Anual).

A tabela Usuários da conta lista as pessoas cadastradas na ZapSign, o grupo de cada uma (Proprietário, Administrador ou Limitado aos próprios documentos) e se o e-mail foi verificado. Essa lista volta a ser usada no passo 7.

Passo 5: confira o webhook

O webhook é o aviso de volta: quando o signatário assina na ZapSign, ela avisa o ProcStudio, que baixa o documento assinado e atualiza o envelope.

Webhook URL com selo Produção, fingerprint do secret e Registro na ZapSign com selo Registrado.

O registro acontece sozinho ao salvar o token. Confira só o selo de Registro na ZapSign: ele deve estar como Registrado, com a mensagem "A ZapSign vai avisar este sistema a cada assinatura. Nada a fazer."

Item Para que serve
Webhook URL (selo Produção) Endereço que a ZapSign chama. O botão Copiar serve para atendimento de suporte; não é preciso colar em lugar nenhum
Secret fingerprint Resumo da chave secreta do webhook, para conferir qual chave está em uso sem expô-la
Rotacionar secret Troca a chave secreta. Use só se houver suspeita de vazamento; a anterior deixa de valer
Registrar novamente Refaz o registro na ZapSign

Se o selo estiver como Falhou ou Não registrado, clique em Registrar webhook agora. Sem webhook, o documento é assinado na ZapSign, mas o ProcStudio não fica sabendo e o envelope continua em "aguardando assinatura".

Passo 6: defina a autenticação padrão dos signatários

O card Autenticação padrão dos signatários define como as pessoas comprovam a identidade na hora de assinar. Vale para todo signatário ZapSign sem configuração própria no envelope — inclusive Cliente e Advogado, que usam o que estiver aqui enquanto não tiverem uma autenticação própria naquele envelope. A exceção é o advogado que assina com pré-assinatura A1: ele não passa pela ZapSign, e a tela recusa configurar autenticação para ele.

Autenticação padrão e autenticação avançada, com os custos adicionais em créditos de cada opção paga.

Enquanto nada for salvo, o selo mostra Padrão do sistema — que é Código por e-mail, sem assinatura na tela. Vale saber: com esse padrão, todo signatário precisa de e-mail válido cadastrado, ou o envio falha.

Autenticação padrão

Opção O que faz Custo adicional
Assinatura na tela Assinatura manuscrita ou digitada, pelo celular ou computador Sem custo
Código por e-mail Código de confirmação enviado ao e-mail do signatário no momento da assinatura Sem custo
Código por SMS Código enviado por SMS quando o signatário finaliza a assinatura Não informado pela ZapSign
Código por WhatsApp Código enviado no WhatsApp quando o signatário finaliza a assinatura 5 créditos (R$ 0,50)
Certificado digital O signatário assina com o próprio certificado digital 5 créditos (R$ 0,50)

Regras da ZapSign que a tela já aplica:

  • Assinatura na tela combina com um canal de código: e-mail, SMS ou WhatsApp.
  • Certificado digital não combina com os outros. Com ele, não é possível posicionar a assinatura no PDF, e quem assina com certificado deve ser o último.
  • O código por SMS ou WhatsApp não é o envio do link. Ele chega quando a pessoa finaliza a assinatura, para provar que ela tem aquele número.

Autenticação avançada

Opção O que faz Custo adicional
Selfie Pede uma foto do rosto, que entra no relatório de assinaturas Sem custo
Foto do documento de identidade Pede foto do RG ou da CNH Sem custo
CPF Simples Pede o CPF, sem validar na Receita Federal Sem custo
CPF Avançado Valida nome e data de nascimento na Receita Federal Sem custo
Reconhecimento facial Grava o rosto e compara com a foto do documento 15 créditos (R$ 1,50)
Biometria facial — Prova de vida Grava o rosto para provar que a pessoa está presente 15 créditos (R$ 1,50)
Biometria Gov+ Compara o rosto com as bases da Serpro; só para quem tem CNH 35 créditos (R$ 3,50)
Validação de Identidade Presença, análise do documento e correspondência com a pessoa 50 créditos (R$ 5,00)

Os quatro métodos de biometria são mutuamente exclusivos: escolha no máximo um. Ao marcar uma biometria, Selfie e Foto do documento são desmarcadas, porque ela já cobre essas evidências. Para a Biometria Gov+ e para o CPF Avançado, o signatário precisa ter CPF cadastrado no ProcStudio — sem ele, o envio do envelope falha.

Os custos são cobrados em créditos da ZapSign, por uso. Se o saldo não cobrir uma opção paga, a tela não deixa marcá-la e mostra o link para comprar créditos.

Clique em Salvar pré-configuração. Para desfazer, use Voltar ao padrão do sistema.

Passo 7: escolha o enviador padrão

O enviador padrão decide em nome de quem o convite de assinatura chega ao signatário.

Cards Enviador padrão, Recusa de assinatura e Defaults do time, com lembrete a cada 3 dias.

  1. Se quem criou o envelope também é usuário da conta ZapSign, o convite sai em nome dessa pessoa.
  2. Se não for, sai em nome do enviador escolhido aqui.
  3. Sem escolha, sai em nome do Dono da conta ZapSign (padrão).

Escolha na lista e clique em Salvar.

Passo 8: decida sobre a recusa de assinatura

Marque Permitir recusa de assinatura pelos signatários para que a pessoa possa recusar na ZapSign, informando o motivo.

Se alguém recusar, o envelope é pausado para análise do escritório. O advogado decide o próximo passo. Clique em Salvar para gravar.

Passo 9: ajuste lembretes e ordem de assinatura

As duas opções de Defaults do time valem só para envelopes ZapSign; físico e gov.br não as usam.

  • Enviar lembrete a cada (dias): a ZapSign reenvia o e-mail de assinatura a quem ainda não assinou, nesse intervalo. Em branco, não há lembretes.
  • Exigir ordem sequencial entre signatários: marcada, o próximo signatário só é avisado depois que o anterior assinar. Desmarcada, todos recebem o link ao mesmo tempo.

Clique em Salvar defaults.

Passo 10: envie um envelope de teste

Antes do primeiro documento de verdade, faça um teste.

Envelope de teste criado e painel de falhas de sincronização sem nenhuma falha.

Clique em Enviar envelope de teste. Com tudo certo, aparece Envelope #N criado, com o número do envelope no seu time.

Passo 11: acompanhe as falhas de sincronização

No fim da tela fica Falhas de sincronização, que lista problemas na comunicação com a ZapSign, por exemplo um documento que não chegou a ser criado lá.

O filtro alterna entre Não resolvidas, Resolvidas e Todas. O estado esperado é "Nenhuma falha de sincronização." Se aparecer alguma, corrija a causa (token, créditos, contato do signatário) e marque como resolvida.

Checklist

  • API e Webhooks ativados na ZapSign, token copiado.
  • Token salvo em Assinaturas > ZapSign.
  • Verificar Conexão mostra Conexão ativa.
  • Plano e créditos aparecem em Informações da conta ZapSign.
  • Registro na ZapSign com o selo Registrado.
  • Autenticação padrão salva.
  • Enviador padrão, recusa e lembretes revisados.
  • Envelope de teste criado, sem falhas de sincronização.

Perguntas frequentes

Uso o token de produção ou o de sandbox? O de produção. Sandbox e produção são contas separadas na ZapSign, com tokens diferentes. O ProcStudio se conecta à produção (veja o selo Produção ao lado da Webhook URL), e um token de sandbox é recusado como se fosse inválido.

Meu cliente não tem e-mail. Ele consegue assinar? Consegue. O e-mail só é obrigatório quando o código de confirmação vai por e-mail. Você pode usar Código por SMS ou Código por WhatsApp, com o celular do cliente cadastrado no ProcStudio, ou apenas a Assinatura na tela.

Quanto custa cada assinatura? Assinatura na tela e código por e-mail não têm custo adicional; a ZapSign não informa custo para o código por SMS. As opções pagas são cobradas em créditos, por uso: WhatsApp e certificado digital (5 créditos, R$ 0,50), reconhecimento facial e prova de vida (15 créditos, R$ 1,50), Biometria Gov+ (35 créditos, R$ 3,50) e Validação de Identidade (50 créditos, R$ 5,00). O saldo aparece em Informações da conta ZapSign. A ZapSign pode mudar essa tabela; vale o valor exibido na tela.

Posso usar outra autenticação num envelope específico? Sim. O que se salva nesta tela é o padrão. Dentro do envelope, cada signatário pode ter uma autenticação própria.

Troquei o token na ZapSign. E agora? Clique em Remover Token, cole o novo e salve. Depois confira se a conexão está ativa e se o webhook continua Registrado.

O documento foi assinado, mas o envelope continua "aguardando assinatura". Quase sempre é o webhook. Confira se o selo está Registrado e se os Webhooks estão ativados na ZapSign. Se não estiverem, ative e clique em Registrar novamente.

Depois de assinado, o PDF pode ser conferido em qualquer validador: veja como validar assinatura digital em PDF.

ZapSignassinatura eletrônicaintegração ZapSignautenticação de signatáriosenvelope de assinatura