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 construir um produto SaaS com assinaturas eletrónicas, tem duas escolhas. Pode associar uma ferramenta de assinatura que recorde aos seus utilizadores que estão a usar 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 trocar um logótipo. Na prática, é mais profundo do que isso. Um fluxo de assinatura eletrónica totalmente em white-label envolve logótipos personalizados, temas de cores, domínios de e-mail, modelos de e-mail personalizados, controlo de notificações e interfaces incorporadas. E para produtos SaaS multi-tenant, precisa da capacidade de aplicar white-label não apenas para a sua marca, mas também para cada uma das marcas dos seus clientes.

Este guia cobre tudo o que precisa para construir 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 SaaS precisam frequentemente de white-labeling em dois níveis.

Nível 1: A sua marca. Os e-mails de assinatura vêm do seu domínio. A interface de assinatura mostra o seu logótipo e as suas cores. Tudo está incorporado na sua aplicação. Os seus clientes nunca veem o fornecedor de API subjacente.

Nível 2: As marcas dos seus clientes. Cada um dos seus clientes tem a sua própria experiência personalizada. Os utilizadores deles veem e-mails 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 os modelos estão isolados. A utilização é monitorizada separadamente.

Uma plataforma de gestão de propriedades, por exemplo, pode querer o Nível 2. Cada empresa de gestão de propriedades 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 Recursos Humanos pode precisar apenas do Nível 1. A experiência de assinatura é personalizada com a marca da plataforma de RH, e todos os funcionários dos seus clientes interagem com essa marca única.

A Firma.dev suporta ambos. A chave são as Áreas de Trabalho do Cliente.

Áreas de Trabalho do Cliente: Separação Segura por Conceção

As Áreas de Trabalho do Cliente permitem-lhe criar ambientes isolados para cada um dos seus clientes. Cada área de trabalho tem o seu próprio:

  • Modelos

  • Pedidos de assinatura e documentos

  • Acompanhamento de utilização de envelopes

  • Logótipo e tema de cores

  • Configuração de domínio de e-mail

  • Modelos de e-mail

  • Chave de API (opcional, para acesso com âmbito de área de trabalho)

Não existe exposição entre áreas de trabalho. O Cliente A não pode ver os documentos do Cliente B. Os modelos criados numa área de trabalho não aparecem noutra. Os relatórios de utilização estão limitados a cada área de trabalho.

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, jurídico), o isolamento de dados não é opcional. As áreas de trabalho dão-lhe essa separação sem ter de programar isolamento de tenants por si próprio.

Para plataformas SaaS que gerem documentos e fluxos de trabalho específicos de clientes, as áreas de trabalho são a base. Cria uma área de trabalho 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 ao nível da área de trabalho.

Logótipos personalizados. Carregue o logótipo da sua empresa (PNG ou JPEG, até 2 MB) para aparecer nos e-mails de assinatura e na interface de assinatura. Para produtos multi-tenant, cada área de trabalho pode ter o seu próprio logótipo que substitui o predefinido da empresa. Quando o logótipo de uma área de trabalho é 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, cor de 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 área de trabalho.

Ocultar marca da Firma.dev. Ative show_custom_branding_only ao nível da empresa para remover por completo toda a marca da Firma.dev da experiência de assinatura. Combinado 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 visualização. Ajuste detalhes adicionais, tais como mostrar molduras de desenho de assinatura e marcas de água em documentos parciais. Estas definições estão disponíveis em ambos os níveis, e as definições da área de trabalho herdam das definições da empresa quando definidas como nulas.

Tudo isto segue uma hierarquia em cascata: a definição da área de trabalho tem prioridade, depois a definição da empresa e, por fim, as predefinições da Firma.dev. Isto significa que pode definir a imagem de marca de toda a empresa e substituí-la seletivamente para áreas de trabalho específicas. Consulte o Guia de White Labeling para obter a referência completa da API.

2. Domínios de E-mail Personalizados

Por predefinição, os e-mails de pedido de assinatura são enviados a partir do domínio da Firma.dev. Com domínios de e-mail personalizados, eles passam a vir do seu.

Pode configurar isto em dois níveis:

Ao nível da empresa: Todas as áreas de trabalho herdam o seu domínio. Os e-mails saem como documents@yourcompany.com.

Ao nível da área de trabalho: Cada área de trabalho pode ter o seu próprio domínio. Os e-mails do Cliente A vêm de sign@customera.com. Os do Cliente B vêm de contracts@customerb.com.

A configuração envolve adicionar 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, em seguida, verifique-os. Uma vez verificado, o domínio fica ativo imediatamente.

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

3. Endereço de Remetente de E-mail Personalizado

Além do domínio, também pode controlar a parte local do endereço do remetente. Por predefinição, os e-mails de um domínio personalizado utilizam support@yourdomain.com. Defina o email_local_part para mudar 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 resolve-se através de uma cadeia de contingência, com as definições da área de trabalho a terem prioridade sobre as definições da empresa, que por sua vez têm prioridade sobre as predefinições da Firma.dev.

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

4. Modelos de E-mail Personalizados

A Firma.dev envia 11 tipos de e-mails automatizados ao longo do ciclo de vida da assinatura: convites para assinar, notificações de 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ário.

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

Os modelos seguem a mesma hierarquia em cascata que tudo o resto. Defina modelos para toda a empresa para manter a consistência e, em seguida, substitua modelos específicos por área de trabalho quando necessário. Também pode obter os modelos predefinidos integrados 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 E-mail Personalizados para a Sua API de Assinatura Eletrónica.

5. Controlo de Notificações

Os domínios e modelos personalizados alteram a identidade visual dos e-mails. O controlo total de notificações permite-lhe substituí-los por completo.

Os e-mails 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 elas.

Quando os e-mails 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:

  • Fazer corresponder os envios à sua infraestrutura de e-mail existente (SendGrid, Postmark, Customer.io)

  • Controlar o tempo de envio de lembretes e acompanhamentos

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

  • Integrar notificações de assinatura nos fluxos de comunicação já existentes com os clientes

Algumas equipas utilizam domínios e modelos personalizados deixando a entrega a cargo da Firma.dev. Outras desativam tudo e gerem por completo 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 construir 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 os documentos sem sair da sua aplicação. Combinado com a imagem de marca personalizada e o 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, posicione campos de assinatura, defina funções de signatário, 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 backend gera um token de curta duração e o frontend carrega o componente num iframe com esse token. Nenhuma chave de API é exposta ao cliente.

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 parece unificada e os utilizadores nunca mudam de contexto para uma interface externa. Consulte o Guia de Assinatura Incorporável para obter todos os detalhes de implementação.

A Hierarquia das Definições

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

  1. Definição da área de trabalho (prioridade máxima)

  2. Definição da empresa

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

Isto permite-lhe definir padrões ao nível da empresa e substituí-los por área de trabalho. Ao nível da área de trabalho, definir qualquer valor como null significa "herdar da empresa". Isto aplica-se a logótipos, cores, domínios de e-mail, modelos de e-mail, endereços de remetente e definições de visualização.

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

Escolher a Abordagem Certa

Nem todos os produtos precisam de white-labeling completo. Saiba como decidir:

Abordagem

Mais Indicado Para

Tempo de Implementação

Apenas logótipo + cores

A assinatura é uma funcionalidade secundária

Menos de uma hora

Logótipo + cores + domínio de e-mail personalizado

White-label padrão para SaaS

Algumas horas (principalmente DNS)

O anterior + modelos de e-mail personalizados

Deseja comunicações personalizadas sem construir a infraestrutura de e-mail

Meio dia

O anterior + controlo de notificações

Deseja gerir por completo a camada de e-mail

1-2 dias

Experiência incorporada completa

A assinatura é central para o seu produto

3-5 dias

Se está a construir um SaaS multi-tenant onde cada cliente precisa da sua própria imagem de marca, adicione as Áreas de Trabalho do Cliente a qualquer uma destas abordagens. O modelo de área de trabalho escala tanto para 10 como para 10.000 clientes.

Checklist de Implementação

Antes de começar:

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

Decida entre marca única vs. multi-marca. Se necessitar de imagem de marca por cliente, planeie a estrutura das suas áreas de trabalho desde cedo. Crie uma área de trabalho quando acolher cada cliente e limite toda a sua atividade a essa área de trabalho.

Configure a imagem de marca visual primeiro. 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 e-mail. Registe o seu domínio, adicione os registos DNS e verifique-os. Esta é a alteração de maior impacto para a maioria dos produtos, pois é a primeira coisa em que os destinatários reparam.

Personalize os modelos de e-mail. 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 da área de trabalho.

Planeie a sua estratégia de incorporação. Se vai incorporar, decida quais os componentes de que precisa. Apenas assinatura? Também a edição de modelos? 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 o fluxo completo. Envie um pedido de assinatura por cada ponto de contacto. Verifique o remetente do e-mail, o conteúdo do e-mail, la interface de assinatura e a notificação de conclusão. Certifique-se de que cada passo pareça parte do seu produto.

Para a referência técnica completa da API com exemplos de código para cada funcionalidade descrita 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 funcionalidades de white-labeling. Por vezes é um extra pago separadamente. Outras vezes está bloqueado atrás de um plano de preços mais alto.

A Firma.dev inclui todas as capacidades de white-labeling em todos os níveis de preço. Domínios de e-mail personalizados, editores incorporados, assinatura incorporada, Áreas de Trabalho do Cliente. Tudo incluído.

Pague apenas o que utilizar a 0,029 por envelope. Sem contratos. Sem mínimos. Sem taxas adicionais para personalizar com a sua marca a experiência de assinatura.

Como Começar

A Firma.dev inclui todas as capacidades de white-labeling em todos os escalões de preço. Sem planos premium, sem funcionalidades bloqueadas. Pague €0,029 por envelope (~3¢ USD) e tenha acesso a logótipos, cores, domínios personalizados, modelos de e-mail, interfaces incorporadas e Áreas de Trabalho do Cliente.

Comece a utilizar a Firma.dev gratuitamente, não é necessário 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,029 por envelope quando estiver pronto para começar ao vivo.

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,029 por envelope quando estiver pronto para começar ao vivo.

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,029 por envelope quando estiver pronto para começar ao vivo.