Como fazer White-Label de uma API de Assinatura de Documentos no seu Produto SaaS

Se está a integrar uma API de assinatura de documentos no seu produto, os seus clientes não devem sentir que estão a utilizar o software de outra pessoa. A experiência de assinatura deve parecer e sentir-se como o seu produto, não uma ferramenta de terceiros.

A marca branca torna isso possível. Mas a maioria dos desenvolvedores acha que marca branca significa apenas colocar o seu logotipo em algo. Na prática, é mais subtil. Uma integração de API de assinatura digital totalmente personalizada envolve três camadas distintas, e nem sempre precisa de todas.

Este guia descompacta o que cada camada faz, quando usá-la e como implementar uma API de assinatura PDF com marca branca que se encaixa no seu produto.

O que a marca branca realmente significa para assinaturas eletrónicas

Quando um cliente assina um documento através da sua aplicação, vários pontos de contato carregam a marca:

• O e-mail que os notifica de que um documento está pronto para assinar

• A própria interface de assinatura

• Notificações de conclusão e lembretes

• Quaisquer termos legais ou etapas de aceitação

Por padrão, a maioria das APIs de assinatura marca todos eles com o seu próprio nome. Marca branca permite substituir essa marca pela sua, ou removê-la completamente.

O objetivo é simples: os seus clientes interagem com a sua marca ao longo de todo o fluxo de trabalho de assinatura. Eles nunca veem o fornecedor da API subjacente.

As três camadas da marca branca

Camada 1: Domínios de e-mail personalizados

A vitória mais rápida. Em vez de enviar pedidos de assinatura a partir de noreply@signatureprovider.com, os e-mails vêm do seu domínio, como documents@yourcompany.com.

Isso requer configuração de DNS (registos SPF, DKIM e DMARC) para verificar a propriedade do domínio e garantir a entregabilidade. Uma vez configurado, todos os e-mails enviados parecem vir diretamente de si.

Para produtos SaaS multi-inquilino, pode levar isso ainda mais longe. Algumas APIs de assinatura de documentos suportam domínios de e-mail a nível de espaço de trabalho, permitindo que cada um dos seus clientes envie do seu próprio domínio. Uma plataforma de gestão de propriedades, por exemplo, poderia ter e-mails de assinatura a vir de leases@buildingname.com para cada propriedade.

Se está à procura de uma implementação rápida, consulte Como Personalizar os Seus E-Mails e Links de Assinatura Eletrónica para um guia passo a passo.

Camada 2: Controlo de notificações

E-mails personalizados são bons. O controlo total sobre as notificações é melhor.

A maioria das APIs de assinatura digital envia quatro tipos de e-mails automáticos: pedidos de assinatura, confirmações de conclusão, avisos de expiração e avisos de cancelamento. Uma configuração de marca branca permite desativar qualquer um ou todos eles por pedido de assinatura.

Por que gostaria de desativá-los? Porque pode querer:

• Enviar links de assinatura através da sua própria infraestrutura de e-mail

• Integrar notificações em fluxos de comunicação existentes com o cliente

• Controlar o tempo de lembretes e acompanhamentos

• Combinar modelos de e-mail com a voz da sua marca

Quando desativa os e-mails da API, recupera URLs de assinatura diretamente da API e distribui-os como quiser. Isto é especialmente útil se já tem uma infraestrutura de e-mail transacional (SendGrid, Postmark, Customer.io) e deseja que as notificações de assinatura fluam pelo mesmo sistema.

Camada 3: Experiências de assinatura incorporadas

Esta é a solução completa de marca branca. Em vez de redirecionar os utilizadores para uma página de assinatura de terceiros, incorpora a interface de assinatura diretamente na sua aplicação.

Com assinatura incorporada, todo o fluxo de trabalho acontece dentro do seu produto. Os utilizadores nunca saem do seu domínio. Eles veem o seu cabeçalho, o seu rodapé, a sua navegação. A interface de assinatura aparece como parte integrante do seu app.

A maioria das APIs de assinatura PDF oferece componentes incorporáveis para:

• Assinatura: O fluxo de assinatura de documentos real

• Edição de modelos: Permitir que os utilizadores definam campos de assinatura e marcadores de posição

• Configuração de pedidos de assinatura: Configurar destinatários, ordem e opções

Experiências incorporadas geralmente usam autenticação JWT (JSON Web Token). O seu backend gera um token de curta duração, e o frontend carrega o componente incorporado com esse token. Nenhum API key exposto ao cliente.

Para produtos SaaS onde a assinatura de documentos é uma funcionalidade central, a assinatura incorporada geralmente vale o esforço de implementação. O seu produto parece mais coeso e mantém controlo total sobre a experiência do utilizador.

Escolhendo a abordagem certa

Nem toda integração precisa de personalização completa. Veja como decidir:

Apenas e-mails personalizados funcionam bem quando a assinatura é uma funcionalidade ocasional, não um fluxo de trabalho central. Os seus clientes recebem uma experiência profissional sem esforço significativo de desenvolvimento. A implementação leva algumas horas, principalmente a configuração de DNS.

E-mails personalizados + controle de notificações adapta-se a produtos onde deseja possuir a camada de comunicação. Pode ter requisitos de conformidade específicos em torno do e-mail, ou desejar que as notificações de assinatura correspondam aos seus modelos existentes. Isso adiciona um ou dois dias de trabalho para integrar com o seu sistema de e-mail.

Experiência totalmente incorporada é a escolha certa quando a assinatura é central para o seu produto. Plataformas de RH, ferramentas de gestão de contratos, software imobiliário, sistemas de onboarding de saúde. Se os seus clientes passam um tempo significativo nos fluxos de trabalho de assinatura, a integração dessa experiência vale a pena. Espere de alguns dias a uma semana de trabalho de integração, dependendo de quantos componentes são incorporados.

Considerações de implementação

Algumas coisas a ter em mente antes de começar:

Espaços de trabalho e multi-inquilino. Se está a construir um produto SaaS multi-inquilino, procure uma API de assinatura de documentos que suporte espaços de trabalho de clientes. Cada um dos seus clientes obtém um ambiente isolado com os seus próprios modelos, histórico de assinaturas e (opcionalmente) domínio de e-mail. Isso mantém os dados devidamente separados sem a necessidade de você construir a separação de inquilinos por conta própria.

Segurança. Gere tokens JWT no seu backend, nunca no código do lado do cliente. Mantenha a expiração do token curta (1-4 horas é típico). Valide as origens da mensagem do iframe se estiver a lidar com eventos de componentes incorporados.

Conformidade. A marca branca não altera a validade legal das assinaturas. Uma API de assinatura digital bem projetada mantém a conformidade com ESIGN, UETA e eIDAS, independentemente da marca. Certifique-se de que o seu fornecedor suporta as estruturas regulatórias relevantes para os seus clientes.

Custo. As plataformas de assinatura empresarial geralmente cobram taxas premium pelas funcionalidades de marca branca. Alguns fornecedores incluem marca branca em todos os níveis de preços. Se está preocupado com os custos, compare o que está incluído antes de se comprometer. Preços da Firma.dev incluem todas as capacidades de marca branca com preços por uso a €0,029 por envelope.

A começar

Se está a avaliar APIs de assinatura de documentos para uma integração com marca branca, comece por mapear quais os pontos de contato que mais importam para os seus clientes. Preocupam-se com a marca de e-mail? Precisam do fluxo de assinatura incorporado? As respostas guiarão o seu âmbito de implementação.

Para um guia técnico detalhado, o Guia de Marca Branca da Firma.dev cobre domínios de e-mail personalizados, configurações de notificações e componentes incorporados com exemplos de códigos.

Pronto para construir? Obtenha a sua chave API e comece a integrar em horas, não semanas.