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

Procura o detalhamento completo? Este artigo aborda os principais conceitos e decisões. Para obter um guia completo de todos os recursos de white-label, incluindo logótipos, personalização de cores, modelos de e-mail personalizados, endereços de remetente e exemplos de código, consulte o Guia Completo de Assinaturas Eletrónicas White-Label 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 outra pessoa. A experiência de assinatura deve ter o aspeto e a sensação do seu produto, não de uma ferramenta de terceiros.

O white-label torna isso possível. Mas a maioria dos programadores pensa que o white-label significa apenas colocar o seu logótipo em algo. Na prática, é mais dinâmico. Uma integração de API de assinatura digital totalmente personalizada envolve branding visual, personalização de e-mail, controlo de notificações e interfaces incorporadas, e nem sempre precisará de todos estes elementos.

Este guia detalha o que faz cada camada, quando a utilizar e como implementar uma API de assinatura de PDFs white-labeled que se adapta ao seu produto.

O que significa realmente o white-label para assinaturas eletrónicas

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

• 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 legais ou etapas de aceitação

Por predefinição, a maioria das APIs de assinatura personaliza todos estes pontos com o seu próprio nome. O White-labeling permite-lhe substituir esse branding pelo seu próprio, ou removê-lo completamente.

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

As quatro camadas de white-labeling

Camada 1: Branding visual

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

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

Ative a opção show_custom_branding_only e a interface de assinatura parecerá ter sido criada 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 por aqui, mesmo que planeie adicionar as outras camadas mais tarde.

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

Em vez de enviar pedidos de assinatura a partir de noreply@signatureprovider.com, os e-mails são enviados a partir do seu domínio, como documentos@asuafirma.com. Também controla a parte local do endereço do remetente (a parte antes do @), de modo a poder utilizar noreply, assinatura, contratos ou o que melhor se adaptar ao seu produto.

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

Para produtos SaaS multi-tenant, os domínios de e-mail ao nível do 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 de propriedades poderia fazer com que os e-mails de assinatura fossem originados de arrendamentos@nomedoedificio.com para cada propriedade.

Se procura uma implementação rápida, consulte Como Fazer White-Label dos Seus E-mails de Assinatura Eletrónica e Ligações de Assinatura para ver um passo a passo.

Camada 3: Controlo de notificações

E-mails de marca e modelos personalizados são bons. O controlo total sobre as notificações é 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 white-label permite-lhe desativar qualquer um ou todos estes por pedido de assinatura.

Por que quereria desativá-los? Porque poderá querer:

• Enviar ligações 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 dos lembretes e acompanhamentos

• Despoletar e-mails com base na sua própria lógica de negócios

Quando desativa os e-mails da API, recupera 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 pretender que as notificações de assinatura fluam através do mesmo sistema.

Camada 4: Experiências de assinatura incorporadas

Esta é a solução completa de white-label. 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 a assinatura incorporada, todo o fluxo de trabalho acontece dentro do seu produto. Os utilizadores nunca saem do seu domínio. Veem o seu cabeçalho, a sua navegação, o seu design. A interface do utilizador de assinatura surge como uma parte integrada da sua aplicação, renderizada com o seu logótipo e cores.

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

• Assinatura: O fluxo real de assinatura de documentos

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

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

As experiências incorporadas utilizam tipicamente 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. Não há chaves de API expostas ao cliente.

Para produtos SaaS onde a assinatura de documentos é uma funcionalidade principal, a assinatura incorporada costuma valer o esforço de implementação. O seu produto parecerá mais coeso e manterá o controlo total sobre a experiência do utilizador.

Escolher a abordagem certa

Nem todas as integrações precisam de um white-label completo. Eis como decidir:

O logótipo, as cores e os e-mails de marca funcionam bem quando a assinatura é uma funcionalidade secundária. Os seus clientes obtêm uma experiência profissional e personalizada sem um esforço significativo de desenvolvimento. A implementação demora algumas horas, maioritariamente na configuração do DNS e num par de chamadas de API para o branding visual.

O mencionado acima + modelos de e-mail personalizados adequa-se a produtos nos quais deseja comunicações personalizadas com a sua marca sem substituir a sua infraestrutura de e-mail. Personaliza o conteúdo e o HTML dos e-mails de assinatura enquanto a Firma.dev lida com a entrega. Isto adiciona uma ou duas horas de trabalho de modelos.

O mencionado acima + controlo de notificações é o passo certo quando pretende ser o proprietário por completo da camada de comunicação. Pode ter requisitos específicos de conformidade em torno do e-mail ou pretende 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 incorporada completa é a escolha certa quando a assinatura é fulcral para o seu produto. Plataformas de RH, ferramentas de gestão de contratos, software imobiliário, sistemas de acolhimento de cuidados de saúde. Se os seus clientes passam muito tempo em fluxos de trabalho de assinatura, a integração dessa experiência compensa. Pode esperar de alguns dias a uma semana de trabalho de integração, dependendo de quantos componentes vai incorporar.

Considerações de implementação

Algumas coisas em que deve pensar antes de começar:

1. Espaços de trabalho e multi-tenancy. Se está a construir um produto SaaS multi-tenant, 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, branding e (opcionalmente) domínio de e-mail. Isto mantém os dados perfeitamente separados sem ter de construir o isolamento de tenants por si mesmo.

2. A hierarquia de definições. As definições de branding na 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 o branding 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 da 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-4 horas é o típico). Valide as origens de mensagens iframe se estiver a lidar com eventos de componentes incorporados.

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

5. Custo. As plataformas de assinatura corporativas cobram frequentemente taxas elevadas pelos recursos de white-labeling. Alguns fornecedores incluem o white-labeling em todos os escalões de preços. A Firma.dev inclui todas as capacidades de white-labeling com preços pay-as-you-go de 0,029 € por envelope (~3¢ USD), sem contratos ou mínimos.

Começar

Se está a avaliar APIs de assinatura de documentos para uma integração com o conceito de white-label, comece por mapear quais os pontos de contacto mais importantes para os seus clientes. Preocupam-se com a personalização de marca dos e-mails? Precisam do fluxo de assinatura incorporado? As respostas guiarão o âmbito da sua implementação.

Para um passo a passo técnico detalhado, o Guia de White-Labeling da Firma.dev aborda domínios de e-mail personalizados, definições de notificação e componentes incorporados com exemplos de código.

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