Se está a construir um produto SaaS com assinaturas eletrónicas, tem duas escolhas. Pode acrescentar uma ferramenta de assinatura que relembre os seus utilizadores de 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 trocar um logótipo. Na prática, é mais profundo do que isso. Um fluxo de assinatura eletrónica totalmente personalizado 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 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 abrange 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 ignora: as empresas de SaaS precisam frequentemente de aplicar white-label a 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 isto é incorporado na sua aplicação. Os seus clientes nunca veem o fornecedor da API subjacente.
Nível 2: As marcas dos seus clientes. Cada um dos seus clientes obtém a sua própria experiência personalizada. Os utilizadores deles veem e-mails do domínio deles, não do seu. A interface de assinatura mostra o logótipo e a paleta de cores deles. Os documentos e modelos sã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 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 funcionários 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
Acompanhamento de utilização de envelopes
Logótipo e tema de cores
Configuração do domínio de e-mail
Modelos de e-mail
Chave de API (opcional, para acesso com âmbito de 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 é apenas uma questão de organização. Trata-se de segurança e conformidade. Se serve clientes empresariais ou opera em setores regulados (saúde, finanças, jurídico), o isolamento de dados não é opcional. Os workspaces proporcionam essa separação sem que tenha de construir o isolamento de inquilinos por si próprio.
Para plataformas SaaS que gerem documentos e fluxos de trabalho específicos do cliente, 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. Identidade 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 aparecer nos e-mails de assinatura e na interface de assinatura. Para produtos multi-tenant, cada workspace pode ter o seu próprio logótipo que substitui o predefinido da empresa. Quando o logótipo de um workspace é removido, volta automaticamente ao 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 workspace.
Ocultar marca da Firma.dev. Ative show_custom_branding_only ao nível da empresa para remover totalmente toda a marca da Firma.dev da experiência de assinatura. Combinado com um logótipo e um 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 se deve mostrar molduras para 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 do workspace herdam das definições da empresa quando definidas como nulas.
Tudo isto segue uma hierarquia em cascata: a definição do workspace tem prioridade, depois a definição da empresa e, por fim, as predefinições da Firma.dev. Isto significa que pode definir a identidade visual 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 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 vêm do seu próprio domínio.
Pode configurar isto em dois níveis:
Ao nível da empresa: Todos os workspaces herdam o seu domínio. Os e-mails saem como documents@yourcompany.com.
Ao nível do workspace: Cada workspace 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 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 resolve-se através de uma cadeia de contingência, com as definições do workspace 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 como 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 assinatura, 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 do 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 workspace 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 marca dos e-mails. O controlo total de notificações permite-lhe substituí-los inteiramente.
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 um ou todos eles.
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 a correspondência com a sua infraestrutura de e-mail existente (SendGrid, Postmark, Customer.io)
Controlar o timing para lembretes e acompanhamentos
Despoletar notificações com base na sua própria lógica de negócio
Integrar notificações de assinatura nos fluxos de comunicação com clientes existentes
Algumas equipas utilizam domínios e modelos personalizados com a Firma.dev a tratar do envio. Outras desativam tudo e assumem o controlo de 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 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 documentos sem sair da sua aplicação. Combinado com a identidade visual personalizada e a opçã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, coloque 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.
Os botões dentro da interface de assinatura incorporada também são personalizáveis. Os administradores do workspace podem substituir as etiquetas dos botões de visualização de assinatura por idioma em todos os nove idiomas suportados, para que o texto que um signatário clica corresponda ao vocabulário do seu produto em vez das predefinições da Firma.dev. Ao contrário da maioria das definições nesta página, as substituições de etiquetas de botões aplicam-se apenas ao nível do workspace, sem uma predefinição ao nível da empresa para herdar. Para o passo a passo completo e a lista de chaves de botões suportadas, consulte etiquetas de botões de assinatura personalizáveis.
Para produtos onde a preparação de documentos é um fluxo de trabalho essencial, os editores incorporados valem o esforço de implementação. A sua aplicação parece coesa e os utilizadores nunca precisam de mudar de contexto para uma interface de terceiros. Consulte o Guia de Assinatura Incorporável para obter detalhes completos de implementação.
A Hierarquia de Definições
Todas as definições de marca e configuração na Firma.dev seguem uma hierarquia em cascata:
Definição do workspace (prioridade máxima)
Definição da empresa
Predefinição da Firma.dev (prioridade mais baixa)
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 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 marca da sua plataforma ao nível da empresa e, em seguida, deixe 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 os pontos de contacto mais importantes? Logótipos e cores? E-mails? A interface 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 marca por cliente, planeie a estrutura do seu workspace com antecedência. Crie um workspace ao integrar cada cliente e associe toda a atividade deles a esse workspace.
Configure primeiro a identidade 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 e-mail. Registe o seu domínio, adicione os registos DNS e verifique. Esta é a alteração de maior impacto para a maioria dos produtos, uma vez que é a primeira coisa que os destinatários notam.
Personalize os modelos de e-mail. Obtenha os modelos predefinidos, 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 de quais componentes precisa. Apenas assinatura? Edição 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 e-mail, o conteúdo do e-mail, a interface de assinatura e a notificação de conclusão. Certifique-se de que cada passo se assemelha ao seu produto.
Para a referência técnica completa da API com exemplos de código para cada funcionalidade aqui abordada, consulte o Guia de White Labeling da Firma.dev.
Quanto Custa
As plataformas de assinatura eletrónica corporativas cobram frequentemente taxas premium pelo white-labeling. Por vezes, é um extra separado. Outras vezes, está bloqueado atrás de um nível de preço mais elevado.
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, Workspaces de Clientes. Tudo incluído.
Pagamento consoante a utilização a €0,049 por envelope. Sem contratos. Sem mínimos. Sem taxas extra para personalizar a sua experiência de assinatura.
Como Começar
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¢ USD) e tenha acesso a logótipos, cores, domínios personalizados, modelos de e-mail, interfaces incorporadas e Workspaces de Clientes.
Comece a utilizar a Firma.dev gratuitamente, sem necessidade de cartão de crédito.
Artigos relacionados
A nossa plataforma foi projetada para capacitar empresas de todos os tamanhos a trabalhar de forma mais inteligente e alcançar seus objetivos com confiança.
