Guias

O Guia Completo para Assinaturas Eletrónicas de Marca Branca para SaaS

"Interface escura: 'Firma.dev' seta aponta para 'O Seu Logotipo' com texto claro 'Marca branca para SaaS'."

Se está a criar um produto SaaS com assinaturas eletrónicas, tem duas opções. Pode adicionar uma ferramenta de assinatura que recorde aos seus utilizadores que estão a utilizar o software de outra pessoa. Ou pode aplicar white-label a toda a experiência para que pareça nativa do seu produto.

A maioria dos programadores pensa que aplicar white-label significa apenas trocar um logótipo. Na prática, é mais profundo do que isso. Um fluxo de assinatura eletrónica em white-label completo envolve logótipos personalizados, temas de cores, domínios de email, modelos de email personalizados, controlo de notificações e interfaces incorporadas. E para produtos SaaS multi-tenant, precisa de ter a capacidade de aplicar white-label não apenas para a sua marca, mas também para a marca de cada um dos seus clientes.

Para uma visão geral completa do que uma API de assinatura eletrónica white-label abrange, comece aqui.

Este guia cobre tudo o que precisa para criar uma experiência de assinatura totalmente personalizada com a Firma.dev.

Dois Níveis de White-Labeling

Eis o que a maioria das APIs de assinatura eletrónica não tem em conta: as empresas de SaaS necessitam frequentemente de white-labeling a dois níveis.

  • Nível 1: A sua marca. Os emails de assinatura vêm do seu domínio. A interface de assinatura mostra o seu logótipo e as suas cores. Toda a experiência está incorporada na sua aplicação. Os seus clientes nunca veem o provedor de API subjacente.

  • Nível 2: A marca dos seus clientes. Cada um dos seus clientes obtém a sua própria experiência personalizada. Os utilizadores deles veem emails do domínio deles, não do seu. A interface de utilizador de assinatura mostra o logótipo e a paleta de cores deles. Os documentos e modelos são isolados. O uso é monitorizado separadamente.

Uma plataforma de gestão imobiliária, por exemplo, pode querer o Nível 2. Cada empresa de gestão imobiliária na plataforma envia contratos de arrendamento a partir do seu próprio domínio (leases@acmeproperties.com), e os seus inquilinos veem o logótipo e a imagem de marca dessa empresa ao longo de todo o fluxo de assinatura.

Um SaaS de RH pode precisar apenas do Nível 1. A experiência de assinatura é personalizada com a marca da plataforma de RH, e todos os colaboradores dos seus clientes interagem com essa marca única.

A Firma.dev suporta ambos. A chave são os Workspaces de Clientes.

Workspaces de Clientes: Separação Segura por Conceção

Os Workspaces de Clientes permitem-lhe criar ambientes isolados para cada um dos seus clientes. Cada workspace tem o seu próprio:

  • Modelos

  • Pedidos de assinatura e documentos

  • Monitorização de utilização de envelopes

  • Logótipo e tema de cores

  • Configuração de domínio de email

  • Modelos de email

  • Chave de API (opcional, para acesso limitado ao workspace)

Não há exposição entre workspaces. O Cliente A não pode ver os documentos do Cliente B. Os modelos criados num workspace não aparecem noutro. Os relatórios de utilização são limitados a cada workspace.

Isto não se trata apenas de organização. Trata-se de segurança e conformidade. Se serve clientes empresariais ou opera em indústrias reguladas (saúde, finanças, legal), o isolamento de dados não é opcional. Os workspaces dão-lhe essa separação sem ter de desenvolver o isolamento de tenants por si mesmo.

Para plataformas SaaS que gerem documentos e fluxos de trabalho específicos de clientes, os workspaces são a base. Cria um workspace para cada conta de cliente, e tudo flui a partir daí.

Os Seis Pilares do White-Labeling

1. Imagem de Marca Visual

A camada mais visível do white-labeling. A Firma.dev permite-lhe controlar o aspeto e a sensação da experiência de assinatura tanto ao nível da empresa como do workspace.

Logótipos personalizados. Carregue o logótipo da sua empresa (PNG ou JPEG, até 2 MB) para que apareça nos emails de assinatura e na interface de assinatura. Para produtos multi-tenant, cada workspace pode ter o seu próprio logótipo que substitui o padrão da empresa. Quando o logótipo de um workspace é removido, este reverte automaticamente para o logótipo da empresa.

Temas de cores. Personalize toda a paleta de cores da experiência de assinatura utilizando valores hexadecimais. Controla seis definições: cor de destaque principal, primeiro plano principal (texto nos botões), fundo da página, cor do texto, fundo do cartão/painel e cor do limite. Tal como os logótipos, as cores podem ser definidas ao nível da empresa e substituídas por workspace.

Ocultar marca da Firma.dev. Ative show_custom_branding_only ao nível da empresa para remover completamente toda a marca da Firma.dev da experiência de assinatura. Combinando isto com um logótipo e tema de cores personalizados, os seus utilizadores nunca verão qualquer indicação de que uma API de terceiros está envolvida.

Definições de exibição. Ajuste detalhes adicionais como mostrar ou não caixas para desenhar a assinatura e marcas de água em documentos parciais. Estas definições estão disponíveis em ambos os níveis, e as definições do workspace herdam das definições da empresa quando definidas como nulas.

Todas estas definições seguem uma hierarquia em cascata: a definição do workspace tem prioridade, depois a definição da empresa e, por fim, os padrões da Firma.dev. Isto significa que pode definir uma imagem de marca para toda a empresa e substituí-la seletivamente para workspaces específicos. Consulte o Guia de White Labeling para obter a referência completa da API.

2. Domínios de Email Personalizados

Por padrão, os emails de pedido de assinatura são enviados a partir do domínio da Firma.dev. Com domínios de email personalizados, eles passam a vir do seu.

Pode configurar isto em dois níveis:

Ao nível da empresa: Todos os workspaces herdam o seu domínio. Os emails saem como documents@yourcompany.com.

Ao nível do workspace: Cada workspace pode ter o seu próprio domínio. Os emails do Cliente A vêm de sign@customera.com. Os do Cliente B vêm de contracts@customerb.com.

A configuração envolve a adição de registos DNS (SPF, DKIM, DMARC) para verificar a propriedade e garantir a entrega. O processo é baseado em API: adicione o domínio, verifique a propriedade com um registo TXT, finalize para receber os seus registos DNS de envio e depois verifique-os. Uma vez verificado, o domínio fica ativo imediatamente.

Para um passo a passo detalhado, consulte Como Aplicar White-Label aos Seus Emails de Assinatura Eletrónica e Links de Assinatura.

3. Endereço de Remetente de Email Personalizado

Além do domínio, também pode controlar a parte local do endereço do remetente. Por padrão, os emails de um domínio personalizado usam support@yourdomain.com. Defina o email_local_part para alterar isto para algo como noreply, signing ou documents.

O endereço completo do remetente é construído a partir de três componentes: o nome do remetente (a pessoa que iniciou o pedido de assinatura), a parte local e o domínio. Cada componente é resolvido através de uma cadeia de contingência, com as definições de workspace a terem prioridade sobre as definições de empresa, que por sua vez têm prioridade sobre os padrões da Firma.dev.

Por exemplo, se definir email_local_part como noreply e o seu domínio verificado for sign.acmecorp.com, os emails serão enviados como Jane Smith <noreply@sign.acmecorp.com>.

4. Modelos de Email Personalizados

A Firma.dev envia 11 tipos de emails automatizados ao longo do ciclo de vida da assinatura: convites de assinatura, notificações do próximo signatário, notificações de reenvio, lembretes, avisos de expiração, avisos de cancelamento, avisos de recusa (tanto para signatários como para administradores), confirmações de conclusão e alertas de alteração de identidade de signatários.

Pode personalizar a linha de assunto e o corpo em HTML de cada tipo de email, com placeholders dinâmicos para detalhes do signatário, informações do documento e imagem de marca da equipa. Placeholders como {{signer_name}}, {{signing_link}}, {{company_logo}} e {{team_name}} permitem-lhe criar modelos que parecem totalmente nativos do seu produto.

Os modelos seguem a mesma hierarquia em cascata de tudo o resto. Defina modelos para toda a empresa para consistência e depois substitua modelos específicos por workspace quando necessário. Também pode obter os modelos padrão incorporados da Firma.dev como ponto de partida, disponíveis em 9 idiomas, incluindo inglês, espanhol, francês, alemão e português.

Para mais detalhes, consulte Modelos de Email Personalizados para a Sua API de Assinatura Eletrónica.

5. Controlo de Notificações

Domínios e modelos personalizados alteram a imagem de marca dos emails. O controlo total de notificações permite-lhe substituí-los por completo.

Os emails automatizados da Firma.dev podem ser desativados por pedido de assinatura com quatro definições booleanas: send_signing_email, send_finish_email, send_expiration_email e send_cancellation_email. Desative qualquer uma ou todas.

Quando os emails estão desativados, obtém os URLs de assinatura a partir da API e envia as notificações através do seu próprio sistema. Isto permite-lhe:

  • Adequar-se à sua infraestrutura de email existente (SendGrid, Postmark, Customer.io)

  • Controlar o timing de lembretes e acompanhamentos

  • Disparar notificações com base na sua própria lógica de negócios

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

Algumas equipas utilizam domínios e modelos personalizados com a Firma.dev a tratar do envio. Outras desativam tudo e gerem toda a camada de comunicação. Ambas as abordagens funcionam.

6. Experiências Incorporadas

A experiência de assinatura não deve parecer um redirecionamento para outro produto. As interfaces incorporadas permitem-lhe criar todo o fluxo de trabalho dentro da sua aplicação.

A Firma.dev disponibiliza três componentes incorporáveis:

Interface de assinatura. Incorpore o fluxo de assinatura para que os destinatários assinem documentos sem sair da sua aplicação. Combinado com branding personalizado e show_custom_branding_only, os utilizadores veem o seu logótipo, as suas cores e a sua navegação ao longo de todo o processo.

Editor de modelos. Permita que os seus utilizadores (ou os utilizadores dos seus clientes) criem e editem modelos diretamente na sua aplicação. Carregue documentos, coloque campos de assinatura, defina funções de signatários, tudo dentro da sua interface de utilizador.

Editor de pedidos de assinatura. Configure pedidos de assinatura, adicione destinatários, defina a ordem de assinatura e pré-visualize documentos sem sair do seu produto.

Todos os três utilizam autenticação JWT. O seu back-end gera um token de curta duração e o front-end carrega o componente num iframe com esse token. Nenhuma chave de API é exposta ao cliente.

Os botões dentro da interface de assinatura incorporada também são personalizáveis. Os administradores de workspace podem substituir os rótulos dos botões da visualização de assinatura por idioma em todos os nove idiomas suportados, para que o texto que um signatário clica corresponda à linguagem do seu produto em vez dos padrões da Firma.dev. Ao contrário da maioria das definições nesta página, as substituições de rótulos de botões aplicam-se apenas ao nível do workspace, sem um padrão ao nível da empresa para herdar. Para o passo a passo completo e a lista de chaves de botões suportadas, consulte rótulos de botões de assinatura personalizáveis.

Para produtos onde a preparação de documentos é um fluxo de trabalho central, os editores incorporados valem o esforço de implementação. A sua aplicação torna-se coesa e os utilizadores nunca mudam de contexto para uma interface de terceiros. Consulte o Guia de Assinatura Incorporável para obter os detalhes completos de implementação.

A Hierarquia de Definições

Todas as definições de branding e configuração na Firma.dev seguem uma hierarquia em cascata:

  1. Definição do workspace (prioridade máxima)

  2. Definição da empresa

  3. Padrão da Firma.dev (prioridade mínima)

Isto permite-lhe definir padrões para toda a empresa e substituí-los por workspace. Ao nível do workspace, definir qualquer valor como null significa "herdar da empresa". Isto aplica-se a logótipos, cores, domínios de email, modelos de email, endereços de remetentes e definições de exibição.

Para produtos multi-tenant, esta hierarquia é poderosa. Defina a imagem de marca da sua plataforma ao nível da empresa e, em seguida, permita que cada workspace de cliente defina a sua própria identidade onde for necessário.

Lista de Verificação de Implementação

Antes de começar:

Defina o seu âmbito de white-labeling. Quais são os pontos de contacto mais importantes? Logótipos e cores? Emails? A interface de assinatura? Criação de modelos? Desenhe a jornada do utilizador e identifique onde a marca de terceiros quebraria a experiência.

Decida entre marca única ou multi-marca. Se necessitar de branding por cliente, planeie a estrutura de workspaces desde cedo. Crie um workspace ao integrar cada cliente e limite toda a atividade deles a esse workspace.

Configure primeiro a imagem de marca visual. Carregue o seu logótipo e configure o seu tema de cores ao nível da empresa. Isto demora minutos e melhora imediatamente a experiência de assinatura para todos os utilizadores.

Adicione o seu domínio de email. Registe o seu domínio, adicione os registos DNS e verifique. Esta é a alteração com maior impacto para a maioria dos produtos, pois é a primeira coisa em que os destinatários reparam.

Personalize os modelos de email. Obtenha os modelos padrão, adapte o texto e o HTML para corresponder ao tom da sua marca e defina-os ao nível da empresa ou do workspace.

Planeie a sua estratégia de incorporação. Se vai incorporar, decida quais os componentes de que precisa. Apenas de assinatura? Editor de modelos também? A interface de assinatura incorporável é o ponto de partida mais comum. Os editores de modelos e de pedidos de assinatura acrescentam mais valor para produtos onde a preparação de documentos faz parte do fluxo de trabalho principal.

Teste todo o fluxo. Envie um pedido de assinatura através de todos os pontos de contacto. Verifique o remetente do email, o conteúdo do email, a interface de assinatura e a notificação de conclusão. Certifique-se de que cada passo parece pertencer ao seu produto.

Para obter a referência técnica completa da API com exemplos de código para cada funcionalidade abordada aqui, consulte o Guia de White Labeling da Firma.dev.

Quanto Custa Isto

As plataformas de assinatura eletrónica corporativas cobram frequentemente taxas elevadas por white-labeling. Por vezes, é um add-on separado. Por vezes, está bloqueado atrás de um plano de preços mais elevado.

A Firma.dev inclui todas as capacidades de white-labeling em todos os níveis de preço. Domínios de email personalizados, editores incorporados, assinatura incorporada, Workspaces de Clientes. Tudo incluído.

Pague à medida que utiliza a 0.049 por envelope. Sem contratos. Sem mínimos. Sem taxas adicionais para aplicar a sua marca na sua experiência de assinatura.

Introdução

A Firma.dev inclui todas as capacidades de white-labeling em todos os níveis de preço. Sem planos premium, sem restrições de funcionalidades. Pague 0.049 € por envelope (~5 cêntimos de dólar) e obtenha acesso a logótipos, cores, domínios personalizados, modelos de email, interfaces incorporadas e Workspaces de Clientes.

Comece a utilizar a Firma.dev gratuitamente, sem necessidade de cartão de crédito.

  1. Cabeçalho

Imagem de Fundo

Pronto para adicionar assinaturas eletrónicas à sua aplicação?

Comece gratuitamente. Não é necessário cartão de crédito. Pague apenas 0,049 € por envelope quando estiver pronto para começar.

Imagem de Fundo

Pronto para adicionar assinaturas eletrónicas à sua aplicação?

Comece gratuitamente. Não é necessário cartão de crédito. Pague apenas 0,049 € por envelope quando estiver pronto para começar.

Imagem de Fundo

Pronto para adicionar assinaturas eletrónicas à sua aplicação?

Comece gratuitamente. Não é necessário cartão de crédito. Pague apenas 0,049 € por envelope quando estiver pronto para começar.