É possível integrar a HeroSpark com ferramentas para assinatura eletrônica e digital como o Zapsign.
Passo 1 - Habilitar Token de Acesso no Zapsign
Em sua conta Zapsign clique no menu “Configurações/Integrações”, navegue até “API - Zapsign” e habilite a chave no local indicado. Copie o código do “Token de acesso” e guarde para os próximos passos.
É obrigatório contratar um Plano de API no Zapsign para utilizar a API.
Passo 2 - Criar Modelo e variáveis no Docx Zapsign
Dentro do documento Docx, configure os campos dinâmicos com as variáveis HeroSpark. Clique aqui para ver a listagem de todas as variáveis HeroSpark disponíveis.
Exemplo de preenchimento das variáveis dentro do Docx (Atenção para não inserir espaços e manter os colchetes):
NOME {{buyer_name}}, inscrito no CPF sob o nº {{buyer_document_id}}, residente e domiciliado à Rua {{buyer_address_street}}, nº {{buyer_address_number}}, Bairro {{buyer_district}}, Cidade {{buyer_city}}, Estado de {{buyer_state}}, CEP {{buyer_zip_code}} doravante denominado "CONTRATANTE ".
Clique no menu “Modelos”, selecione o tipo “Docx”e crie o modelo fazendo o upload do documento com as variáveis configuradas.
Passo 3 - Copiar o ID do Modelo Zapsign
Cada modelo no Zapsign possui um ID. Ao clicar no modelo, acesse a sua URL e copie o ID que é o código que está após https://app.zapsign.com.br/conta/modelos/. Guarde o código para ser utilizado nos próximos passos.
Passo 4 - Criar automação na HeroSpark
O documento será enviado para o e-mail do Signatário após o disparo da automação na HeroSpark.
Escolha a automação de preferência, nesse exemplo, usamos a automação de “Pagamento confirmado”. Clique em “Usar este modelo” e na próxima tela, selecione a opção “Gerar um Webhook” e clique em “OK”.
Passo 5 - Configurar o Webhook na HeroSpark
Na tela de “Edição e visualização” preencha os campos abaixo da seguinte forma:
A. Filtro de disparo: Aplicar em todos os produtos ou filtrar para um produto específico
B. Edição de webhook - URL: https://api.zapsign.com.br/api/v1/models/create-doc/
C. Método: Post
D. Header - Adicione as duas chaves:
Chave: Content-Type Valor: application/json
Chave: Authorization Valor: Bearer Cole aqui o Token de acesso do Passo 1
E. Body - Copie e cole o código abaixo:
{
"data": [
{
"de": "{{'{{'}}Insira aqui o nome da variável{{'}}}}",
"para": "{{Insira aqui o nome da variável}}"
},
{
"de": "{{'{{'}}Insira aqui o nome da variável{{'}}}}",
"para": "{{Insira aqui o nome da variável}}"
},
{
"de": "{{'{{'}}Insira aqui o nome da variável{{'}}}}",
"para": "{{Insira aqui o nome da variável}}"
},
{
"de": "{{'{{'}}Insira aqui o nome da variável{{'}}}}",
"para": "{{Insira aqui o nome da variável}}"
},
{
"de": "{{'{{'}}Insira aqui o nome da variável{{'}}}}",
"para": "{{Insira aqui o nome da variável}}"
},
{
"de": "{{'{{'}}Insira aqui o nome da variável{{'}}}}",
"para": "{{Insira aqui o nome da variável}}"
},
{
"de": "{{'{{'}}Insira aqui o nome da variável{{'}}}}",
"para": "{{Insira aqui o nome da variável}}"
},
{
"de": "{{'{{'}}Insira aqui o nome da variável{{'}}}}",
"para": "{{Insira aqui o nome da variável}}"
}
],
"lang": "pt-br",
"brand_name": "Insira aqui o nome do Remetente para o envio do email",
"external_id": null,
"signer_name": "{{buyer_name}}",
"template_id": "Insira aqui o ID do modelo Docx no Zapsign",
"signer_email": "{{buyer_email}}",
"signer_phone_number": "{{buyer_phone_raw}}",
"send_automatic_email": true,
"disable_signer_emails": false,
"reminder_every_n_days": 3,
"allow_refuse_signature": false,
"send_automatic_whatsapp": false,
"disable_signers_get_original_file": false
}
Faça as seguintes alterações nos locais indicados acima:
-
brand_name: Insira o remetente do e-mail enviado junto com o documento
-
template_id: Insira o ID do modelo do Passo 3
-
reminder_every_n_days: Intervalo de dias para lembrete ao signatário
-
Body:
Para cada variável inserida no Docx é necessário criar um De/Para no Body e no exemplo abaixo, o Docx possui oito variáveis, portanto, teremos oito De/Para.
Substitua apenas o nome da variável mantendo os colchetes, aspas e atenção para não inserir espaços.
Exemplo do Body com as variáveis:
{
"data": [
{
"de": "{{'{{'}}buyer_name{{'}}}}",
"para": "{{buyer_name}}"
},
{
"de": "{{'{{'}}buyer_document_id{{'}}}}",
"para": "{{buyer_document_id}}"
},
{
"de": "{{'{{'}}buyer_address_street{{'}}}}",
"para": "{{buyer_address_street}}"
},
{
"de": "{{'{{'}}buyer_address_number{{'}}}}",
"para": "{{buyer_address_number}}"
},
{
"de": "{{'{{'}}buyer_district{{'}}}}",
"para": "{{buyer_district}}"
},
{
"de": "{{'{{'}}buyer_city{{'}}}}",
"para": "{{buyer_city}}"
},
{
"de": "{{'{{'}}buyer_state{{'}}}}",
"para": "{{buyer_state}}"
},
{
"de": "{{'{{'}}buyer_zip_code{{'}}}}",
"para": "{{buyer_zip_code}}"
}
],
"lang": "pt-br",
"brand_name": "Empresa XPTO",
"external_id": null,
"signer_name": "{{buyer_name}}",
"template_id": "8500f538-2796-409e-a54e-bfdaeb99bhrt",
"signer_email": "{{buyer_email}}",
"signer_phone_number": "{{buyer_phone_raw}}",
"send_automatic_email": true,
"disable_signer_emails": false,
"reminder_every_n_days": 3,
"allow_refuse_signature": false,
"send_automatic_whatsapp": false,
"disable_signers_get_original_file": false
}
E. Clique em “Automação ativada” e “Salvar edição”
Repita os mesmos passos caso tenha criado mais de uma automação no Piloto Automático. Atenção ao ID do modelo e nome das variáveis inseridas no Docx e Body.
Integração finalizada! Agora após o disparo da automação de Pagamento confirmado o documento será enviado por email para assinatura do Signatário.
Problemas?
Caso você tenha problemas, entre em contato diretamente com o suporte Zapsign.