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

Procura a análise detalhada completa? Este artigo aborda os conceitos e decisões fundamentais. Para uma demonstração detalhada de todos os recursos de marca própria, incluindo logótipos, temas de cores, modelos de e-mail personalizados, endereços do remetente e exemplos de código, consulte O Guia Completo para Assinaturas Eletrónicas de Marca Própria para 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 terceiros. A experiência de assinatura deve ter a aparência e a sensação do seu produto, não de uma ferramenta externa.

A marca própria torna isso possível. Mas a maioria dos programadores pensa que marcar com marca própria significa apenas colocar o seu logótipo em algo. Na prática, é mais complexo. Uma integração de API de assinatura digital totalmente personalizada envolve identidade visual, personalização de e-mail, controlo de notificações e interfaces integradas, e nem sempre precisa de todos estes elementos. Para conhecer o âmbito completo do que pode personalizar, consulte a visão geral do recurso API de assinatura eletrónica de marca própria.

Este guia detalha o que faz cada camada, quando usá-la e como implementar uma API de assinatura de PDF em marca própria que se adapte ao seu produto.

O que a marca própria realmente significa para as assinaturas eletrónicas

Quando um cliente assina um documento através da sua aplicação, vários pontos de contacto contêm a marca:

• A própria interface de assinatura (logótipo, cores, layout)

• O e-mail que o notifica de que um documento está pronto para ser assinado

• O endereço do remetente e o modelo de e-mail

• As notificações de conclusão e de lembrete

• Quaisquer termos jurídicos ou etapas de aceitação

Por predefinição, a maioria das APIs de assinatura personaliza todos estes pontos com o seu próprio nome. A marca própria permite-lhe substituir essa marca pela sua, ou removê-la por completo.

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

As quatro camadas de marca própria

Camada 1: Identidade visual

O impacto mais imediato. Carregue o seu logótipo, defina a sua paleta de cores e oculte completamente a marca do fornecedor da API da experiência de assinatura.

Com o Firma.dev, pode controlar seis definições de cores (destaque principal, texto do primeiro plano, fundo, cor do cartão e cor do limite) e carregar logótipos ao nível da empresa e do espaço de trabalho. Para produtos SaaS multi-inquilino, isto significa que cada um dos seus clientes pode ter a sua própria identidade visual distinta no fluxo de assinatura.

Ative show_custom_branding_only e a interface de assinatura parecerá ter sido construída pela sua equipa. Sem logótipos de terceiros, sem esquemas de cores desconhecidos.

Esta camada demora minutos a implementar e tem o maior impacto visível. Comece aqui mesmo que planeie adicionar as outras camadas mais tarde.

Camada 2: Domínios e modelos de e-mail personalizados

Em vez de enviar pedidos de assinatura de noreply@signatureprovider.com, os e-mails vêm do seu domínio, como documents@yourcompany.com. Também pode controlar a parte local do endereço do remetente (a parte antes do @), de modo a poder usar noreply, signing, contracts, o que melhor se adaptar ao seu produto.

Além do remetente, pode personalizar os próprios modelos de e-mail. O Firma.dev suporta modelos HTML personalizados para 11 tipos de e-mail (convites de assinatura, conclusões, lembretes, expirações e muito mais), com marcadores de posição dinâmicos para nomes de signatários, ligações de assinatura, logótipos de empresas e detalhes da equipa. Defina modelos ao nível da empresa para garantir consistência e substitua-os por espaço de trabalho quando necessário.

Para produtos SaaS multi-inquilino, os domínios de e-mail ao nível de espaço de trabalho significam que cada um dos seus clientes pode enviar a partir do seu próprio domínio. Uma plataforma de gestão imobiliária poderia fazer com que os e-mails de assinatura viessem de leases@buildingname.com para cada propriedade.

Se procura uma implementação rápida, consulte Como Personalizar com Marca Própria os Seus E-mails e Ligações de Assinatura Eletrónica para obter um guia passo a passo.

Camada 3: Controlo de notificações

E-mails de marca própria e modelos personalizados são ótimos. O controlo total sobre as notificações é ainda melhor.

A maioria das APIs de assinatura digital envia e-mails automáticos para pedidos de assinatura, confirmações de conclusão, avisos de expiração e avisos de cancelamento. Uma configuração de marca própria permite-lhe desativar qualquer um ou todos estes avisos por pedido de assinatura.

Porque haveria de querer desativá-los? Porque pode querer:

• Enviar ligações de assinatura através da sua própria infraestrutura de e-mail

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

• Controlar o tempo dos lembretes e acompanhamentos

• Disparar e-mails com base na sua própria lógica de negócio

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

Camada 4: Experiências de assinatura integradas

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

Com a assinatura integrada, todo o fluxo de trabalho acontece dentro do seu produto. Os utilizadores nunca saem do seu domínio. Eles veem o seu cabeçalho, a sua navegação, o seu design. A interface gráfica de assinatura aparece como uma parte integrada da sua aplicação, renderizada com o seu logótipo e cores.

A maioria das APIs de assinatura de PDF oferece componentes de integração para:

• Assinatura: O fluxo real de assinatura do documento

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

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

As experiências integradas utilizam normalmente a autenticação JWT (JSON Web Token). O seu backend gera um token de curta duração e o frontend carrega o componente integrado com esse token. Sem chaves de API expostas ao cliente.

A personalização do fluxo integrado vai agora um passo além da própria interface. O texto do botão apresentado ao signatário é personalizável por idioma, pelo que os botões dentro da sua visualização de assinatura integrada podem corresponder ao vocabulário do seu produto em vez de herdarem predefinições genéricas. Consulte rótulos de botões de assinatura personalizáveis para saber como configurá-los.

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

Escolher a abordagem certa

Nem todas as integrações precisam de marca própria completa. Veja como decidir:

Logótipo, cores e e-mails personalizados funcionam bem quando a assinatura é uma funcionalidade secundária. Os seus clientes obtêm uma experiência profissional e personalizada sem um esforço de desenvolvimento significativo. A implementação demora algumas horas, maioritariamente configuração de DNS e algumas chamadas de API para a identidade visual.

O anterior + modelos de e-mail personalizados adapta-se a produtos onde deseja comunicações personalizadas sem substituir a sua infraestrutura de e-mail. Personaliza o conteúdo e o HTML dos e-mails de assinatura enquanto o Firma.dev trata da entrega. Isto adiciona uma ou duas horas de trabalho de modelos.

O anterior + controlo de notificações é a escolha certa quando deseja dominar inteiramente a camada de comunicação. Pode ter requisitos de conformidade específicos em relação ao e-mail ou quer que as notificações de assinatura fluam através do seu sistema transacional existente. Isto adiciona um ou dois dias de trabalho de integração.

Experiência integrada completa é 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 integração de cuidados de saúde. Se os seus clientes passam muito tempo em fluxos de trabalho de assinatura, integrar essa experiência compensa. Conte com alguns dias a uma semana de trabalho de integração, dependendo de quantos componentes integrar.

Considerações de implementação

Alguns aspetos a ter em conta antes de começar:

1. Espaços de trabalho e arquitetura multi-inquilino. Se estiver a criar um produto SaaS multi-inquilino, procure uma API de assinatura de documentos que suporte espaços de trabalho do cliente. Cada um dos seus clientes obtém um ambiente isolado com os seus próprios modelos, histórico de assinaturas, marca própria e (opcionalmente) domínio de e-mail. Isto mantém os dados devidamente separados sem ter de criar a isolação de inquilino por si próprio.

2. A hierarquia de definições. As definições de personalização de marca no Firma.dev funcionam em cascata: o espaço de trabalho sobrepõe-se à empresa, a empresa sobrepõe-se às predefinições. Isto significa que define a personalização ao nível da empresa uma vez e apenas configura as sobreposições ao nível do espaço de trabalho onde for necessário. Definir um valor de espaço de trabalho como null herda as características do nível de empresa.

3. Segurança. Gere tokens JWT no seu backend, nunca no código do lado do cliente. Mantenha a expiração do token curta (1 a 4 horas é o normal). Valide as origens das mensagens do iframe se estiver a processar eventos de componentes integrados.

4. Conformidade. A marca própria não altera a validade legal das assinaturas. Uma API de assinatura digital bem concebida mantém a conformidade com o ESIGN, UETA e eIDAS, independentemente da marca. Certifique-se de que o seu fornecedor suporta os enquadramentos regulamentares relevantes para os seus clientes.

5. Custo. As plataformas de assinatura empresariais cobram frequentemente taxas elevadas por funcionalidades de marca própria. Alguns fornecedores incluem a marca própria em todos os níveis de preços. O Firma.dev inclui todas as capacidades de marca própria no preço pré-pago a 0,049 € por envelope (~5¢ USD), sem contratos nem mínimos.

Como começar

Se está a avaliar APIs de assinatura de documentos para uma integração sob marca própria, comece por mapear quais os pontos de contacto mais importantes para os seus clientes. Importam-se com a personalização de e-mails? Precisam do fluxo de assinatura integrado? As respostas guiarão o seu âmbito de implementação. Para uma perspetiva estratégica mais ampla em configurações de marca única e de multi-inquilino, consulte o guia completo de assinaturas eletrónicas de marca própria para SaaS.

Para um roteiro técnico detalhado, o Guia de Marca Própria do Firma.dev aborda domínios de e-mail personalizados, definições de notificação e componentes integrados com exemplos de código.

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