Posso chamar a API SignDocs direto do Make sem o app oficial?

Sim, via módulos HTTP genéricos do Make. Mas você terá que gerenciar o token OAuth, a verificação HMAC dos webhooks e o tratamento de erros manualmente. O app oficial faz tudo isso por padrão.

É seguro deixar o client_secret no Make.com?

Sim. O Make armazena conexões em vault criptografado e nunca expõe o secret no editor de cenários. NÃO compartilhe blueprints com secrets embutidos — exporte sempre como 'sem credenciais'.

Quantas requisições posso fazer por minuto?

Depende do seu plano SignDocs. Headers RateLimit-Limit / RateLimit-Remaining / RateLimit-Reset acompanham toda resposta. Make.com respeita Retry-After automaticamente em 429.

Guias de Integração

Integração com Make.com (Integromat)

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.

⚡ Por que Make.com?

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.

Instalação

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 dev@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.

Configurar a conexão OAuth2

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	Fornecido no painel admin
Client Secret	Fornecido no painel admin (mostrado uma única vez)
Escopos	`transactions:read transactions:write steps:write evidence:read webhooks:write`

⚠️ Exporte cenários sem credenciais

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ódulos disponíveis

Ações (10)

Módulo	Endpoint
Criar Sessão de Assinatura	`POST /v1/signing-sessions`
Obter Status da Sessão	`GET /v1/signing-sessions/{id}`
Cancelar Sessão de Assinatura	`POST /v1/signing-sessions/{id}/cancel`
Criar Envelope	`POST /v1/envelopes`
Obter Envelope	`GET /v1/envelopes/{id}`
Adicionar Sessão ao Envelope	`POST /v1/envelopes/{id}/sessions`
Baixar Carimbo Combinado	`GET /v1/envelopes/{id}/combined-stamp`
Enviar Documento (Upload)	`POST /v1/documents`
Baixar Documento	`GET /v1/documents/{id}/content`
Obter Evidence Pack	`GET /v1/evidence/{id}`

Search

Listar Envelopes — paginação por cursor sobre GET /v1/envelopes com filtros de status e janela de criação.

Trigger instantâneo

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 19 tipos de evento: TRANSACTION.*, STEP.*, SIGNING_SESSION.*, ENVELOPE.*, QUOTA.WARNING, API.DEPRECATION_NOTICE.

Cenários prontos para copiar

1. Google Sheets → Sessão de Assinatura → Gmail

Cada nova linha em uma planilha gera uma sessão de assinatura e dispara um e-mail com o link pronto.

Watch Rows (Sheets) → Get a File (Drive) → Enviar Documento (Upload) [SignDocs] → Criar Sessão de Assinatura [SignDocs] → Send Email (Gmail) — body usa {{signingUrl}}

2. Webhook → CRM atualizado quando contrato é assinado

Reaja a TRANSACTION.COMPLETED baixando o Evidence Pack e marcando o contato no CRM.

Receber Eventos (TRANSACTION.COMPLETED) [SignDocs] → Obter Evidence Pack [SignDocs] → Update Record (HubSpot/Pipedrive/RD) → Upload File (Drive) — arquiva o PDF assinado

3. Envelope multi-signatário → Slack quando todos assinam

Envelopes coordenam múltiplos signatários sobre o mesmo doc. Notifique o canal #contratos quando o evento ENVELOPE.ALL_SIGNED chegar.

Receber Eventos (ENVELOPE.ALL_SIGNED) [SignDocs] → Baixar Carimbo Combinado [SignDocs] → Send a Message (Slack) — anexa o PDF

A mágica do `signingUrl`

O 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.

Webhooks: como o Make.com lida

Make.com gera uma URL pública (https://hook.make.com/...) ao ativar o cenário.
O app chama POST /v1/webhooks com essa URL e os eventos selecionados.
SignDocs retorna webhookId e secret.
Eventos chegam com headers X-SignDocs-Signature (HMAC-SHA256) e X-SignDocs-Timestamp (Unix).
Make valida a assinatura. Eventos com timestamp acima de 300s ou assinatura inválida retornam 401 e não disparam o cenário.
Ao desativar/excluir o cenário, o app chama DELETE /v1/webhooks/{id} automaticamente.

Idempotência

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.

Tratamento de erros

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?
422	Payload inválido	Mensagem traz `error.code` + `error.message`.
429	Rate limit	Make respeita `Retry-After`; se persistir, suba seu plano.

Conformidade e AUP

O uso deste app está sujeito ao AUP §7-A. Resumo:

✅ Rodar produção no Make com suas credenciais
✅ Compartilhar templates de cenário sem secrets
❌ Usar credenciais sk_live em cenários de teste
❌ Rodar produção em conta Make compartilhada/de equipe sem autorização escrita
❌ Compartilhar blueprints com client_secret embutido

Solicitar acesso antecipado

Enquanto 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.

Suporte

Status: status.signdocs.com.br
Issues do app: github.com/signdocsbrasil/signdocs-make-app
E-mail: dev@signdocs.com.br
Comunidade Make: tag signdocs-brasil no Make Community

Solicitar link de instalação privado