Conecte qualquer cenário Make.com ao SignDocs Brasil. Assinatura eletrônica com biometria facial, OTP, clickwrap e ICP-Brasil A1 — validade jurídica plena no Brasil (MP 2.200-2). 10 ações, 1 search e 1 trigger instantâneo, sem escrever código.
Plataforma low-code maior que o Zapier na América Latina, com módulos nativos para Google Workspace, Slack, WhatsApp Business, Telegram, HubSpot, Pipedrive, RD Station, ClickUp, Notion, e mais 1500 apps. Você desenha o fluxo arrastando blocos.
O app SignDocs Brasil está em estágio de app privado enquanto aguarda aprovação no Marketplace público (~2-4 semanas). Para receber o link de instalação privado, preencha o formulário no fim desta página ou escreva para suporte@signdocs.com.br com o assunto "Make.com early access".
Plano Make.com necessário: qualquer plano pago (Core ou superior). O Free não permite Custom Apps com trigger instantâneo.
O app usa o fluxo OAuth2 client_credentials (servidor-a-servidor). Make.com troca seu client_secret por um access_token e renova automaticamente.
| Campo | Valor |
|---|---|
| Ambiente | Produção ou Homologação (HML) |
| Client ID | Gerado no API Dashboard (self-service, ~3 min) |
| Client Secret | Gerado junto com o Client ID (mostrado uma única vez) |
| Escopos | transactions:read transactions:write evidence:read webhooks:write — ou deixe em branco para receber tudo que a credencial tem provisionado |
Make.com inclui valores de conexão em blueprints exportados se você não escolher "exportar sem secrets". Compartilhar blueprints com client_secret embutido viola o AUP §7-A.
| Módulo | Endpoint |
|---|---|
| Criar Sessão de Assinatura | POST /v1/signing-sessions |
| Obter Status da Sessão | GET /v1/signing-sessions/{id}/status |
| Cancelar Sessão de Assinatura | POST /v1/signing-sessions/{id}/cancel |
| Criar Envelope | POST /v1/envelopes |
| Adicionar Sessão ao Envelope | POST /v1/envelopes/{id}/sessions |
| Obter Envelope | GET /v1/envelopes/{id} |
| Gerar Carimbo Combinado | POST /v1/envelopes/{id}/combined-stamp |
| Enviar Documento para a Transação | POST /v1/transactions/{id}/document |
| Obter URLs de Download | GET /v1/transactions/{id}/download |
| Obter Evidence Pack | GET /v1/transactions/{id}/evidence |
O documento é enviado inline (base64) na criação da sessão ou do envelope, ou anexado depois à transação que a sessão criou. Download e evidência são sempre buscados por transactionId — nunca por um ID de documento. Os módulos de download devolvem URLs pré-assinadas em JSON, válidas por 1 hora; encadeie um HTTP → Get a file para trazer os bytes.
Você escolhe policy.profile — CLICK_ONLY, CLICK_PLUS_OTP, BIOMETRIC, BIOMETRIC_PLUS_OTP, DIGITAL_CERTIFICATE ou CUSTOM — e a API expande em etapas. DIGITAL_SIGN_A1 é um tipo de etapa, alcançável só via CUSTOM: não é um perfil.
Listar Transações — paginação por cursor (nextToken) sobre GET /v1/transactions, com filtros de status, userExternalId, grupo de documentos e intervalo de datas. Não há endpoint de listagem de envelopes na API: guarde o envelopeId no seu sistema ou acompanhe pelos eventos ENVELOPE.*.
Receber Eventos do SignDocs Brasil — registra um webhook ao ativar o cenário, remove ao desativar. Verifica HMAC-SHA256 com tolerância de 300s. Inscrição em qualquer um dos 20 tipos de evento: TRANSACTION.*, STEP.*, SIGNING_SESSION.*, ENVELOPE.*, QUOTA.WARNING, API.DEPRECATION_NOTICE.
Cada nova linha em uma planilha gera uma sessão de assinatura e dispara um e-mail com o link pronto.
Reaja a TRANSACTION.COMPLETED baixando o Evidence Pack e marcando o contato no CRM.
Envelopes coordenam múltiplos signatários sobre o mesmo doc. Notifique o canal #contratos quando o evento ENVELOPE.ALL_SIGNED chegar.
signingUrlO módulo Criar Sessão de Assinatura retorna um campo computado signingUrl já montado como {url}?cs={clientSecret}. Cole-o direto em corpos de e-mail, mensagens de Slack ou WhatsApp — é a única URL que o signatário precisa abrir.
Sem o app oficial, você precisaria concatenar os dois campos manualmente em todo cenário.
https://hook.make.com/...) ao ativar o cenário.POST /v1/webhooks com essa URL e os eventos selecionados.webhookId e secret.X-SignDocs-Signature (HMAC-SHA256) e X-SignDocs-Timestamp (Unix).DELETE /v1/webhooks/{id} automaticamente.Toda ação mutadora expõe um campo avançado Idempotency Key, default {{uuid}}. Cada execução do cenário gera um UUID novo — o que normalmente é desejado. Para replay-safe, pin manualmente: signing-session-{{1.row_id}} reutiliza a mesma chave em re-runs do mesmo bundle.
| Status | Significado | O que verificar |
|---|---|---|
| 401 | Token inválido/expirado | Reconecte; refresh automático já foi tentado. |
| 403 (CloudFront) | Bloqueado na borda | URL pública? Ambiente da conexão = ambiente da credencial? |
| 409 | Estado incompatível | Ex.: cancelar uma sessão já concluída. O campo detail explica. |
| 422 | Payload inválido | A API responde em RFC 7807 (application/problem+json); o campo detail diz o que falhou. |
| 429 | Rate limit | Make respeita Retry-After; se persistir, suba seu plano. |
O uso deste app está sujeito ao AUP §7-A. Resumo:
sk_live em cenários de testeclient_secret embutidoEnquanto o app não está no Marketplace público, distribuímos por convite. Preencha abaixo para receber o link de instalação privado em até 1 dia útil.
signdocs-brasil no Make Community