'%3e%3cpath%20fill-rule='evenodd'%20clip-rule='evenodd'%20d='M6.99935%2012.8327C10.221%2012.8327%2012.8327%2010.221%2012.8327%206.99935C12.8327%203.77769%2010.221%201.16602%206.99935%201.16602C3.77769%201.16602%201.16602%203.77769%201.16602%206.99935C1.16602%2010.221%203.77769%2012.8327%206.99935%2012.8327Z'%20stroke='%23666666'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3cpath%20d='M1.16602%207H12.8327'%20stroke='%23666666'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3cpath%20fill-rule='evenodd'%20clip-rule='evenodd'%20d='M6.99935%2012.8327C8.28802%2012.8327%209.33268%2010.221%209.33268%206.99935C9.33268%203.77769%208.28802%201.16602%206.99935%201.16602C5.71068%201.16602%204.66602%203.77769%204.66602%206.99935C4.66602%2010.221%205.71068%2012.8327%206.99935%2012.8327Z'%20stroke='%23666666'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3cpath%20d='M2.875%202.95898C3.93063%204.01461%205.38896%204.66754%206.99978%204.66754C8.61062%204.66754%2010.069%204.01461%2011.1246%202.95898'%20stroke='%23666666'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3cpath%20d='M11.1246%2011.0425C10.069%209.98691%208.61062%209.33398%206.99978%209.33398C5.38896%209.33398%203.93063%209.98691%202.875%2011.0425'%20stroke='%23666666'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3c/g%3e%3cdefs%3e%3cclipPath%20id='clip0_1267_9109'%3e%3crect%20width='14'%20height='14'%20fill='white'/%3e%3c/clipPath%3e%3c/defs%3e%3c/svg%3e)
Se seu produto já possui um fluxo de trabalho onde contratos são gerados (por exemplo, integração de RH, originação de empréstimos, registro de fornecedores), a assinatura embutida elimina o redirecionamento e mantém os usuários no fluxo.
Por que embeber assinatura em vez de redirecionar?
Redirecionar usuários para uma página de assinatura de terceiros cria atrito: troca de contexto, descontinuidade de marca e taxa de abandono. A assinatura embutida mantém o usuário dentro da sua aplicação ao longo do processo de assinatura. A interface de assinatura aparece dentro de um iframe ou componente nativo, com a sua marca e estilo, enquanto o motor de assinatura roda no backend do provedor.
Três abordagens de embebedimento comparadas
| Esforço de desenvolvimento | Controle de marca | |
|---|---|---|
| Embebedimento de iframe | Baixa (apenas frontend) | Moderada — iframe estilizado |
| API + UI personalizado | Alta (full stack) | Completa — construa sua própria UI |
| SDK para mobile | Média (específico para plataforma) | Experiência nativa completa |
Quando embeber assinatura
A assinatura embutida não é sempre a escolha certa. Aqui estão os cenários onde ela oferece o maior valor.
Portais corporativos que servem funcionários ou clientes podem embeber assinatura para reconhecimentos de políticas, aprovações internas e acordos de auto-serviço sem enviar os usuários para uma ferramenta externa.
Quando a volume de assinaturas é alto (milhares por dia), cada redirecionamento custa conversão. A assinatura embutida reduz a taxa de abandono e melhora as taxas de conclusão, impactando diretamente a receita.
A assinatura embutida oferece controle total sobre a jornada do usuário, facilitando a implementação de trilhas de auditoria personalizadas, divulgações regulatórias e captura de consentimento dentro do contexto da sua própria aplicação.
O fluxo da API de assinatura embutida
Uma implementação típica de assinatura embutida segue esta sequência.
Crie envelope via API
Sua backend chama a API de assinatura para criar um envelope: carregar o documento, definir campos de assinatura, definir papéis de assinante e configurar requisitos de autenticação. A API retorna um ID de envelope.
Gere URL de assinatura
Para cada assinante, solicite uma URL de assinatura da API. A URL inclui um token único que autentica o assinante para esse envelope específico. Opcionalmente passe autenticação do destinatário (código de acesso, OTP por SMS, eID).
Embrulhe em iframe ou SDK
Renderize a URL de assinatura em um iframe (web) ou SDK móvel (iOS/Android). A interface de assinatura carrega dentro da sua aplicação. Personalize a aparência para combinar com as cores, fontes e logotipo da sua marca.
Trate webhook de conclusão
Quando o assinante completar (ou recusar), a plataforma de assinatura envia um webhook para sua backend. Use isso para atualizar o estado da sua aplicação, acionar próximos passos ou notificar outras partes.
Recupere o documento assinado
Baixe o documento assinado e o pacote de evidências (certificado de conclusão, trilha de auditoria) via API. Armazene-os em seu sistema ou armazenamento em nuvem.
Considerações técnicas para assinatura embutida
Cross-origin e CSP
A embedding de iframe requer que o domínio de assinatura seja permitido em sua Política de Segurança de Conteúdo. Configure os cabeçalhos frame-ancestors e child-src. A maioria das plataformas de assinatura oferece um mecanismo de lista branca para seus domínios.
Confiabilidade de webhook
Os webhooks podem falhar devido a problemas de rede. Implemente manipuladores de webhook idempotentes e um fallback de polling que verifica periodicamente o status do envelope. Nunca dependa exclusivamente de webhooks para transições de estado críticas.
Responsividade móvel
A interface de assinatura deve funcionar em dispositivos móveis. Teste a assinatura baseada em iframe no iOS Safari e Android Chrome. Algumas implementações de prancheta de assinatura têm problemas de eventos de toque em dispositivos móveis. Use SDKs para aplicativos móveis nativos.
Limites de taxa e loteamento
A assinatura embutida em alta volume pode atingir os limites de taxa da API. Implemente fila de solicitações e criação em lote onde suportado. Monitore o uso da API e configure alertas para limites aproximados.
Como a assinatura embutida do eSign.AI funciona
O eSign.AI oferece assinatura embutida white-label para produtos SaaS que precisam de assinatura dentro da própria interface.
iframe e SDK de componente
Embrague a experiência de assinatura do eSign.AI dentro do seu produto por meio de um iframe ou componente React/Vue. O assinante nunca sai da sua aplicação. A assinatura embutida suporta todas as funcionalidades do eSign.AI: roteamento multipartite, verificação de identidade, QES, rastreamento de auditoria.
Webhooks para status em tempo real
Configure webhooks para receber eventos de assinatura: envelope enviado, visualizado, assinado, concluído, recusado. Seu aplicativo pode acionar workflows downstream (ativação de contrato, notificação, cobrança) imediatamente após a conclusão da assinatura.
API de assinatura embutida: latência, SLAs e webhooks
Especificações de desempenho para planejamento de integração de API.
Parâmetros de latência da API
eSign.AI: criar envelope 200-400 ms, obter status 50-100 ms, baixar PDF assinado 300-800 ms. DocuSign: criar envelope 300-600 ms, obter status 80-150 ms. Adobe Sign: criar envelope 400-800 ms. Carregamento do iframe de assinatura embutida: eSign.AI 1-2 segundos, DocuSign 2-4 segundos.
Confiabilidade de webhook
Webhooks do eSign.AI: tempo limite de 30 segundos, 3 tentativas com backoff exponencial (5 min, 30 min, 2 horas), assinatura HMAC para verificação de carga útil. DocuSign: tempo limite de 10 segundos, janela de retry de 24 horas. Adobe Sign: tempo limite de 3 segundos, 6 tentativas em 72 horas. Para workflows downstream em tempo real, o eSign.AI tem a entrega de webhook mais confiável.
Perguntas frequentes
Não. A validade jurídica da assinatura depende do método de assinatura (SES, AES, QES), verificação de identidade e pacote de evidências — não de se a interface de assinatura é embutida ou redirecionada. A assinatura embutida gera a mesma evidência jurídica que a assinatura independente.
