Contratos & Assinatura Eletrônica
Por Conversa Labs
Por Conversa Labs
Empresas emissoras, certificado A1, templates, variáveis, auto-fill, assinatura interna/externa, página pública e validador.
Visão geral de Contratos e Assinatura Eletrônica
Visão geral O módulo Contratos & Assinatura Eletrônica da Conversa Labs permite criar, enviar, assinar e validar contratos sem sair da plataforma. Você monta documentos a partir de templates com variáveis, preenche os dados automaticamente com as informações que já existem no seu atendimento (contato, conversa, negócio no CRM, catálogo e conta), envia o link de assinatura pelos canais nativos (WhatsApp e e-mail) e acompanha o status em tempo real. O processo de assinatura é totalmente eletrônico e oferece diferentes níveis legais — desde a assinatura simples (consentimento com registro de IP e dispositivo) até a qualificada com certificado digital ICP-Brasil A1. Cada contrato gera uma trilha de auditoria imutável, um PDF final assinado e uma página pública de validação para qualquer pessoa conferir a autenticidade do documento. Pré-requisitos - O módulo de Contratos é opcional e precisa estar habilitado para a sua conta. Se você não encontra a área de Contratos, fale com um administrador. - Seu usuário precisa ter permissão para acessar e gerenciar Contratos. - Para emitir contratos é necessário cadastrar pelo menos uma empresa emissora (a parte "contratada"). Para assinatura qualificada, essa empresa precisa de um certificado digital A1. - Para enviar o link de assinatura pelos canais, tenha uma Caixa de Entrada de WhatsApp ou e-mail configurada. Passo a passo 1. Acesse a área de Contratos pela barra lateral (seção comercial, junto a Pagamentos). 2. Cadastre a sua empresa emissora e, se for usar assinatura qualificada, faça o upload do certificado A1. 3. Crie um template de contrato no editor ou faça upload de um modelo pronto, usando variáveis {{ }} nos pontos que mudam de um contrato para outro. 4. Gere um contrato a partir do template: as variáveis são preenchidas automaticamente com os dados do contato/conversa/negócio; ajuste o que faltar. 5. Defina os signatários e o nível de assinatura desejado. 6. Envie o link pelos canais nativos. A parte contratada pode assinar automaticamente; os demais signatários assinam pela página pública. 7. Acompanhe o status até a conclusão e baixe o PDF assinado. Compartilhe a página de validação quando precisar comprovar a autenticidade. Configurações & opções - Empresas emissoras: cadastre quantas precisar, cada uma com seus dados, identidade visual e certificado A1 próprio. - Templates e cláusulas: biblioteca reutilizável de modelos e cláusulas. - Níveis de assinatura: simples, avançado (com OTP) e qualificado (A1). - Configurações do módulo: retenção de documentos, carimbo de tempo (TSA) e demais ajustes. - Automação: contratos podem ser criados/enviados por Automações, Macros e Flow Builder. Casos de uso - Fechar uma venda no CRM e enviar o contrato para assinatura na mesma conversa. - Emitir contratos de prestação de serviço, propostas e termos de adesão com modelo padronizado. - Coletar assinatura por WhatsApp com OTP para maior segurança jurídica. - Gerar uma cobrança no módulo de Pagamentos logo após o contrato assinado. Dicas, limites e boas práticas - Padronize seus contratos em templates para ganhar velocidade e reduzir erros. - Escolha o nível de assinatura conforme o risco do documento — quanto maior o valor, mais forte a assinatura recomendada. - Para validade jurídica plena da assinatura qualificada, mantenha o certificado A1 vigente e, quando aplicável, configure um carimbo de tempo (TSA) credenciado. - Confira sempre se os dados auto-preenchidos estão corretos antes de enviar para assinatura. Solução de problemas - Não vejo o módulo de Contratos: ele pode não estar habilitado para a conta ou para o seu perfil — fale com um administrador. - Não consigo emitir um contrato qualificado: verifique se a empresa emissora tem um certificado A1 válido e dentro da validade. - O signatário não recebeu o link: confirme o canal (WhatsApp/e-mail) e os dados de contato do signatário. Veja também - Empresas emissoras e certificado digital A1 - Templates, variáveis e auto-preenchimento - Assinatura interna e externa - Página pública do contrato e validador
Empresas emissoras e certificado digital A1
Visão geral A empresa emissora é a parte "contratada" dos seus contratos — quem emite e, quando aplicável, assina automaticamente o documento do seu lado. Você pode cadastrar quantas empresas emissoras precisar (por exemplo, uma por marca, filial ou CNPJ), cada uma com seus próprios dados, identidade visual e certificado digital. Para usar a assinatura qualificada (ICP-Brasil), a empresa emissora precisa de um certificado digital A1 — um arquivo .pfx/.p12 protegido por senha. Esse certificado é carregado na plataforma e usado para assinar os contratos com validade jurídica reforçada. Pré-requisitos - Módulo de Contratos habilitado para a conta e usuário com permissão de administração de Contratos. - Dados cadastrais da empresa (razão social, documento, endereço, contato). - Para assinatura qualificada: um certificado A1 vigente no formato .pfx/.p12 e a respectiva senha. - O certificado A3 (token/cartão em hardware) ainda não é suportado nesta versão — apenas o A1, que é um arquivo. Passo a passo 1. Na área de Contratos, abra a seção de empresas emissoras. 2. Crie uma nova empresa emissora e preencha os dados cadastrais. 3. Adicione a identidade visual (logo e cores), que aparecerá no contrato e nas páginas públicas. 4. Para habilitar a assinatura qualificada, faça o upload do certificado A1 (.pfx/.p12) e informe a senha. 5. A plataforma valida o certificado: se a senha estiver incorreta ou o arquivo inválido, o upload é recusado com uma mensagem de erro. 6. Quando válido, são exibidos o titular do certificado e a data de validade. 7. Salve. A empresa emissora já pode ser usada ao gerar contratos. Configurações & opções - Vários emissores: mantenha tantas empresas emissoras quanto seu negócio exigir. - Identidade visual por empresa: logo e cores próprias, refletidas no documento e no validador. - Status do certificado: a plataforma mostra titular, arquivo e validade; substitua o arquivo quando renovar. - Carimbo de tempo (TSA): nas configurações do módulo é possível apontar um servidor de carimbo de tempo credenciado para reforçar a validade (a autenticação do TSA fica no ambiente, não em tela). Casos de uso - Empresa com várias marcas/CNPJs emitindo contratos sob identidades diferentes. - Operação que precisa de validade jurídica reforçada via certificado A1. - Padronizar o visual dos contratos (logo e cores) por empresa emissora. Dicas, limites e boas práticas - Mantenha o certificado A1 sempre vigente — um certificado expirado impede novas assinaturas qualificadas. - Trate a senha do certificado como um segredo: ela é necessária para assinar. - O certificado é um dado sensível — só usuários com permissão de administração devem gerenciá-lo. - Para validade plena no Brasil, combine o A1 com um carimbo de tempo (TSA) credenciado. Solução de problemas - O upload do certificado foi recusado: confira se a senha está correta e se o arquivo é um .pfx/.p12 válido e não corrompido. - A validade aparece vencida: o certificado expirou; gere/renove um novo A1 e faça o upload. - Não consigo assinar de forma qualificada: verifique se a empresa emissora selecionada tem um A1 válido carregado. - Preciso de A3 (token/cartão): ainda não é suportado nesta versão; use o A1 (arquivo). Veja também - Visão geral de Contratos e Assinatura Eletrônica - Templates, variáveis e auto-preenchimento - Assinatura interna e externa - Página pública do contrato e validador
Templates, variáveis e auto-preenchimento
Visão geral Os templates são modelos reutilizáveis dos seus contratos. Você cria um template uma vez, define os trechos variáveis com {{ }} (por exemplo, nome do cliente, documento, valor, datas) e a partir dele gera quantos contratos quiser. Na hora de gerar, as variáveis são preenchidas automaticamente com os dados que já existem no atendimento — contato, conversa, negócio no CRM, catálogo e conta — restando a você apenas revisar e ajustar o que faltar. Você pode montar o template no editor da plataforma ou fazer upload de um modelo pronto. Há também uma biblioteca de cláusulas reutilizáveis para padronizar trechos comuns entre vários templates. Pré-requisitos - Módulo de Contratos habilitado e usuário com permissão para gerenciar templates. - Conteúdo do contrato (texto base) e a lista de campos que mudam de um contrato para outro. - Para o auto-preenchimento funcionar bem, os dados de origem (contato, negócio, etc.) devem estar preenchidos. Passo a passo 1. Na área de Contratos, abra Templates e crie um novo. 2. Escreva o conteúdo no editor ou faça upload de um modelo pronto. 3. Onde o texto muda de um contrato para outro, insira uma variável no formato {{ variavel }}. 4. Reaproveite trechos comuns a partir da biblioteca de cláusulas. 5. Salve o template. 6. Para emitir, gere um contrato a partir do template: as variáveis são preenchidas automaticamente com os dados da origem (contato/conversa/negócio/catálogo/conta). 7. Revise os valores preenchidos, ajuste manualmente o que faltar e prossiga para a assinatura. Configurações & opções - Origem dos dados: as variáveis podem ser preenchidas a partir de contato, conversa, negócio do CRM, catálogo e dados da conta. - Preenchimento manual: qualquer variável pode ser editada à mão antes do envio. - Geração agêntica: o Maestro pode ajudar a redigir/preencher o contrato a partir do contexto da conversa. - Biblioteca de cláusulas: padronize cláusulas e reaproveite em vários templates. - Upload de modelos: importe um documento já formatado e transforme-o em template. Casos de uso - Um contrato de prestação de serviço padrão com nome, documento, escopo e valor variáveis. - Propostas e termos de adesão que mudam apenas alguns campos por cliente. - Reuso de cláusulas jurídicas (confidencialidade, rescisão, foro) entre diferentes templates. Dicas, limites e boas práticas - Dê nomes claros às variáveis para que o preenchimento automático e manual fique evidente. - Confira se cada {{ variavel }} foi substituída antes de enviar — variáveis vazias podem deixar lacunas no documento. - Centralize cláusulas comuns na biblioteca para manter consistência e facilitar atualizações. - Sempre revise o contrato gerado: o auto-preenchimento agiliza, mas a conferência é sua responsabilidade. Solução de problemas - Uma variável não foi preenchida: o dado de origem pode estar vazio (ex.: contato sem documento). Preencha a origem ou edite manualmente. - O texto saiu com {{ }} literal: verifique a grafia da variável no template. - O modelo enviado por upload ficou desformatado: ajuste a formatação no editor após o upload. Veja também - Visão geral de Contratos e Assinatura Eletrônica - Empresas emissoras e certificado digital A1 - Assinatura interna e externa - Página pública do contrato e validador
Assinatura interna e externa
Visão geral Um contrato costuma ter dois lados: a parte contratada (a sua empresa emissora) e os signatários externos (o cliente e demais partes). Na Conversa Labs: - A assinatura interna é a auto-assinatura da empresa contratada — feita do lado do servidor, com os dados (e, na assinatura qualificada, o certificado A1) da empresa emissora. - A assinatura externa é feita pelos signatários através de uma página pública segura, sem necessidade de cadastro ou login. Você escolhe o nível legal da assinatura conforme o risco do documento: simples (consentimento com registro de IP e dispositivo), avançado (com OTP por e-mail/WhatsApp e assinatura visual) ou qualificado (certificado digital ICP-Brasil A1, padrão PAdES). Pré-requisitos - Módulo de Contratos habilitado e contrato gerado a partir de um template. - Uma empresa emissora cadastrada (para a auto-assinatura). Para o nível qualificado, ela precisa de certificado A1 válido. - Para enviar o link aos signatários externos, um canal nativo (WhatsApp ou e-mail) e os dados de contato dos signatários. Passo a passo 1. No contrato, defina os signatários (a parte contratada e os signatários externos). 2. Escolha o nível de assinatura (simples, avançado ou qualificado). 3. Envie para assinatura: cada signatário externo recebe, na conversa dele, um card com o resumo do contrato, o link de assinatura no texto da mensagem e o PDF em anexo. Nos canais que suportam, o link também aparece como botão. Quando o signatário só tem e-mail, o convite vai por e-mail com o mesmo link e o mesmo PDF. 4. A parte contratada assina automaticamente (auto-assinatura do lado do servidor). 5. Cada signatário externo abre a página pública, revisa o documento e assina. 6. No nível avançado, o signatário valida um código OTP e registra sua assinatura visual (desenhada, digitada ou enviada como imagem). 7. Concluídas todas as assinaturas, o PDF final assinado é gerado e o status muda para concluído. Configurações & opções - Níveis de assinatura: - Simples — consentimento com captura de IP, data/hora e dispositivo. - Avançado — OTP por e-mail/WhatsApp + assinatura visual (desenhada, digitada ou por upload). - Qualificado — certificado digital A1 (ICP-Brasil), padrão PAdES. - Canal do código OTP: definido por signatário. Quem está como OTP por e-mail recebe o código no e-mail cadastrado; quem está como OTP por WhatsApp recebe na própria conversa. Se o canal configurado não estiver disponível, o sistema tenta o outro antes de desistir — e, se nenhum existir, avisa em vez de dar o envio por feito. - Link individual: cada signatário tem o seu próprio link, válido só para ele. Um signatário nunca recebe o link de outro. - Auto-assinatura: a parte contratada assina automaticamente com a empresa emissora. - Ordem e múltiplos signatários: defina quem precisa assinar. - Carimbo de tempo (TSA): quando configurado, reforça a validade jurídica da assinatura. - Trilha de auditoria: cada assinatura registra IP, dispositivo, consentimento e timestamp (SHA-256). Casos de uso - Cliente assina pelo WhatsApp com OTP em poucos toques, sem instalar nada. - Contrato de maior valor exige assinatura qualificada com certificado A1. - A empresa contratada assina automaticamente e só aguarda a contraparte. Dicas, limites e boas práticas - Use o nível avançado (OTP) ou qualificado para documentos de maior valor ou risco. - Garanta que os dados de contato dos signatários estejam corretos para a entrega do link. - Para o nível qualificado, mantenha o certificado A1 vigente e, se aplicável, um TSA credenciado configurado. - Acompanhe o status do contrato — ele indica quem já assinou e o que falta. Solução de problemas - O envio foi recusado: quando algum signatário não tem telefone nem e-mail, o contrato não é enviado e a mensagem de erro nomeia quem está sem destino. Complete os dados e envie de novo — o contrato continua como rascunho até que o envio aconteça de verdade. - O signatário não recebeu o link: confirme o canal e os dados de contato; reenvie se necessário. - O código OTP não chega: confira o e-mail/WhatsApp daquele signatário (o código vai para o canal configurado nele, não para a conversa do contrato) e reenvie. - A auto-assinatura falhou no nível qualificado: confira se a empresa emissora tem um certificado A1 válido e dentro da validade. - O contrato não conclui: verifique se todos os signatários assinaram. Veja também - Visão geral de Contratos e Assinatura Eletrônica - Empresas emissoras e certificado digital A1 - Templates, variáveis e auto-preenchimento - Página pública do contrato e validador
Página pública do contrato e validador
Visão geral Cada contrato tem uma página pública segura, acessível por um link, onde os signatários externos revisam o documento e assinam — sem precisar de cadastro ou login. Essa página exibe o conteúdo do contrato com a identidade visual da empresa emissora e conduz o signatário pelo fluxo de assinatura (incluindo OTP e assinatura visual, quando o nível exigir). Depois de assinado, existe também um validador público: uma página de verificação que permite a qualquer pessoa conferir a autenticidade do contrato e do PDF final assinado. O validador mostra informações de verificação de forma mascarada (sem expor dados sensíveis), apoiada na trilha de auditoria imutável (SHA-256, IP, dispositivo, consentimento e timestamp). Pré-requisitos - Um contrato enviado para assinatura (para a página pública de assinatura) ou já assinado (para o validador). - O link correspondente, entregue ao signatário pelos canais nativos ou compartilhado para validação. - Nenhum login é necessário para o signatário externo nem para quem valida. Passo a passo 1. Envie o contrato para assinatura: o signatário recebe o link da página pública. 2. Na página pública, o signatário revisa o documento e segue o fluxo de assinatura. 3. Conforme o nível, ele confirma um OTP e registra a assinatura visual. 4. Concluídas as assinaturas, a plataforma gera o PDF final assinado com o manifesto/certidão. 5. Para comprovar a autenticidade, abra (ou compartilhe) a página do validador público. 6. O validador confirma se o documento é autêntico e exibe os dados de verificação de forma mascarada. Configurações & opções - Identidade visual: a página pública usa logo e cores da empresa emissora. - Fluxo por nível: simples, avançado (OTP + assinatura visual) ou qualificado (A1). - PDF final assinado: gerado ao concluir, com trilha de auditoria e manifesto/certidão. - Validador mascarado: mostra a verificação sem expor dados sensíveis (privacidade/LGPD). - Carimbo de tempo (TSA): quando configurado, aparece na verificação reforçando a validade. Casos de uso - Enviar ao cliente um link de assinatura que abre direto no celular, sem instalação. - Disponibilizar a um terceiro (banco, cartório, auditoria) um link de validação do contrato. - Comprovar a integridade do PDF assinado a qualquer momento, mesmo após o encerramento. Dicas, limites e boas práticas - Compartilhe o validador quando precisar provar autenticidade sem enviar dados sensíveis. - Oriente o signatário a abrir a página pública em um navegador atualizado. - Guarde o PDF final assinado — ele carrega a trilha de auditoria e o manifesto de verificação. - Lembre que o validador é mascarado por padrão para proteger dados pessoais. Solução de problemas - O link da página pública não abre: confirme se o link está completo e se o contrato ainda está ativo (não cancelado/expirado). - O validador diz que não encontrou o documento: verifique se o contrato foi concluído e se o link de validação está correto. - O PDF não corresponde à verificação: o arquivo pode ter sido alterado — use sempre o PDF final assinado gerado pela plataforma. - O signatário não consegue assinar: confira o nível exigido (ex.: OTP) e os dados de contato para o envio do código. Veja também - Visão geral de Contratos e Assinatura Eletrônica - Assinatura interna e externa - Templates, variáveis e auto-preenchimento - Empresas emissoras e certificado digital A1
Gerenciar e acompanhar contratos
Visão geral A área de Contratos reúne todos os documentos da sua conta em uma lista que você pode filtrar e na qual acompanha o ciclo de vida de cada contrato em tempo real. Cada contrato passa por estados bem definidos: - Rascunho — o contrato foi gerado a partir de um template e ainda pode ser editado. - Enviado / em assinatura — o link de assinatura foi entregue e o documento aguarda as partes. - Parcialmente assinado — pelo menos um signatário já assinou; ainda falta(m) outro(s). - Concluído — todas as assinaturas foram coletadas e o PDF final assinado foi gerado. - Anulado — o contrato foi cancelado de forma irreversível depois de enviado. - Expirado — passou da data limite de assinatura sem ser concluído. - Rejeitado / cancelado — um signatário recusou ou o contrato foi encerrado sem efeito. A partir da lista e da tela de um contrato você executa todas as ações de gestão (enviar, lembrar, anular, duplicar, baixar, compartilhar links) e consulta a trilha de auditoria imutável. Pré-requisitos - O módulo de Contratos precisa estar habilitado para a sua conta. Se você não encontra a área de Contratos, fale com um administrador. - Seu usuário precisa ter permissão para acessar e gerenciar Contratos. Anular um contrato é uma ação restrita a administradores. - O contrato já deve ter sido gerado a partir de um template (com signatários definidos) para poder ser enviado para assinatura. Passo a passo 1. Enviar para assinatura — em um contrato em rascunho, use Enviar para assinatura. A plataforma congela o documento, gera um PDF de rascunho, assina automaticamente o lado da empresa contratada e entrega o link aos signatários externos como um card com botão na conversa vinculada. É necessário ter pelo menos um signatário. 2. Reenviar lembrete — use Lembrar para repostar o card com o botão de assinatura na conversa e cutucar os signatários externos pendentes. Se não houver conversa vinculada, a ação não tem efeito. 3. Anular / cancelar — use Anular para cancelar de forma irreversível um contrato já enviado. O status muda para anulado e o documento não pode mais ser assinado. Ação restrita a administradores. 4. Duplicar — use Duplicar para clonar o contrato em um novo rascunho. Os signatários e itens são copiados, um novo código de verificação é gerado e nenhuma assinatura é transportada. 5. Baixar o PDF assinado — use Baixar para obter a URL assinada do documento final mais recente (na ausência dele, o rascunho). O download inclui o hash SHA-256 para conferência de integridade. 6. Copiar / compartilhar os links de assinatura — use Links de assinatura para obter a URL pública de cada signatário externo, caso precise reenviar manualmente o link por outro canal. Partes que assinam automaticamente não têm link público; o token de assinatura nunca é exposto na listagem. Acompanhamento e auditoria - Trilha de auditoria (eventos): cada contrato tem uma linha do tempo forense, somente leitura, com os eventos do ciclo de assinatura — criado, enviado, visualizado, OTP enviado, OTP verificado, assinado, rejeitado, expirado, baixado e anulado. Cada evento registra IP, dispositivo, consentimento, método de autenticação e o hash do documento no momento do evento. A trilha é imutável (append-only): nenhum registro pode ser alterado depois de criado. - Filtrar a lista: você pode filtrar os contratos por status, nível de assinatura e, principalmente, pelos vínculos do atendimento — conversa, contato e negócio do CRM — além da empresa emissora. Assim você encontra rapidamente todos os contratos de um cliente ou de um negócio específico. Arquivar e restaurar contratos - Arquivar tira o contrato da lista padrão sem apagá-lo — útil para organizar documentos antigos ou encerrados. - Restaurar devolve o contrato arquivado à lista ativa. - Um contrato com assinatura real (parcialmente assinado ou concluído) é um registro legal e nunca é excluído — apenas arquivado. A exclusão definitiva só é permitida para um rascunho já arquivado. Integrações com Tarefas e Follow-up A partir do próprio contrato você aciona outros módulos da plataforma (quando habilitados): - Criar uma Tarefa de acompanhamento — gera uma Tarefa já vinculada à conversa, ao contato e ao negócio do CRM do contrato. Requer o módulo de Tarefas habilitado. - Inscrever em uma sequência de Follow-up — inscreve o contato do contrato em uma sequência de follow-up (de forma idempotente, sem duplicar). Requer o módulo de Follow-up habilitado e um contato vinculado ao contrato. Casos de uso - Fechar uma venda no CRM, enviar o contrato na mesma conversa e criar uma tarefa para acompanhar a assinatura. - Reenviar o lembrete para um cliente que abriu mas ainda não assinou o documento. - Anular um contrato enviado por engano e duplicá-lo para corrigir os dados em um novo rascunho. - Baixar o PDF assinado e arquivar o contrato concluído para manter a lista limpa. Dicas, limites e boas práticas - Use a trilha de auditoria para saber exatamente quem visualizou e quem assinou antes de cobrar uma assinatura pendente. - Anular é irreversível — confirme antes de usar. Para apenas corrigir dados, prefira duplicar e enviar a nova versão. - Sempre confira o hash SHA-256 ao baixar o documento final quando precisar comprovar integridade. - Mantenha a lista organizada arquivando contratos concluídos e antigos. Solução de problemas - O status ficou parado em "parcialmente assinado": ainda falta alguém assinar. Confira na trilha de auditoria quem já assinou e use Lembrar ou Links de assinatura para cobrar os pendentes. - O signatário não recebeu / não assinou o link: confirme o canal (WhatsApp/e-mail) e os dados de contato; reenvie pelo botão Lembrar ou copie a URL de assinatura do signatário e envie por outro meio. - O contrato expirou: a data limite de assinatura passou. Duplique o contrato para gerar um novo rascunho e reenvie. - Não consigo anular o contrato: a anulação é restrita a administradores e só vale para contratos já enviados. - Não consigo excluir o contrato: contratos com assinatura real nunca são excluídos — arquive; a exclusão definitiva só é permitida para um rascunho que já esteja arquivado. Veja também - Visão geral de Contratos e Assinatura Eletrônica - Assinatura interna e externa - Templates, variáveis e auto-preenchimento - Página pública do contrato e validador
Automatizar contratos com Automações, Macros e Flow Builder
Visão geral O módulo de Contratos se integra aos motores de automação da plataforma para que você gere e envie contratos sozinho, sem clicar a cada atendimento. As mesmas duas ações ficam disponíveis em três lugares: - Automações de conversa — disparam por evento/condição (ex.: mudou a etapa do negócio). - Macros — você executa a ação manualmente, com um clique, sobre uma conversa. - Flow Builder — o nó Enviar contrato dentro de um fluxo visual. Em todos eles, a plataforma resolve o template, o contato e a conversa a partir do contexto, preenche as variáveis automaticamente, auto-assina a empresa emissora (a parte contratada) e entrega o link de assinatura ao contato quando há uma conversa vinculada. Pré-requisitos - Módulo de Contratos habilitado e usuário com permissão para gerenciar contratos. - Pelo menos um template de contrato já criado. - Um contato (e, de preferência, uma conversa) no gatilho — é dele que sai o signatário. - Uma empresa emissora cadastrada (usada como contratada padrão e para a auto-assinatura). - Para entregar o link pelos canais, tenha uma Caixa de Entrada de WhatsApp ou e-mail. Passo a passo Automações de conversa 1. Vá em Configurações → Automação e crie ou edite uma regra. 2. Defina o evento e as condições que disparam a regra. 3. Em Ações, escolha uma das ações de contrato: - Enviar contrato a partir de template (send_contract_from_template): cria o contrato a partir do template e já envia para assinatura. - Criar contrato a partir de template (create_contract_from_template): apenas cria o contrato em rascunho para o agente revisar antes de enviar. 4. Informe o template na ação. Salve a regra. Macros 1. Vá em Configurações → Macros e crie uma macro. 2. Adicione a mesma ação de contrato (Enviar ou Criar a partir de template) e escolha o template. 3. Na conversa, execute a macro pelo menu de Macros para gerar/enviar o contrato manualmente. Flow Builder 1. No editor de fluxo, adicione o nó Enviar contrato. 2. Selecione o template (e, opcionalmente, um título). 3. Conecte a saída de sucesso ao próximo passo e a saída de falha a um tratamento alternativo (ex.: notificar um agente). 4. Publique o fluxo. Ao executar, o nó cria o contrato (auto-preenche variáveis, monta signatários/itens e escolhe a emissora padrão) e o envia. Configurações & opções - Parâmetros da ação: template_id é obrigatório. Opcionalmente, company_id (empresa emissora), crm_item_id (negócio do CRM) e title (título do contrato). Quando você omite a empresa, a plataforma usa a emissora padrão; contato e conversa vêm do gatilho. - Mesma execução nos três lugares: Automações e Macros compartilham exatamente o mesmo conjunto de ações, então o comportamento é idêntico — o que muda é só o disparo (automático, manual ou por fluxo). - Condições baseadas em contrato: regras que respondem a eventos de contrato podem filtrar por contract_status (situação), contract_tier (nível de assinatura), contract_company (empresa emissora) e contract_total (soma dos itens, em valores inteiros de reais). Operadores disponíveis: igual a, diferente de, contém, não contém, está preenchido, não está preenchido, maior que, menor que. Uma regra sem condições sempre roda; uma condição mal configurada falha de forma segura (não dispara em tudo). - Saídas do nó do fluxo: sucesso leva adiante (carregando o contract_id gerado); a falha sai por um caminho separado, identificado por contracts_not_enabled, contracts_template_missing, contracts_no_contact ou send_contract_failed. Casos de uso - Negócio ganho no CRM → enviar automaticamente o contrato de prestação de serviço na mesma conversa. - Mudança de etapa (ex.: "Em negociação" → "Fechamento") → criar o contrato em rascunho para o agente revisar antes de enviar. - Atendimento por fluxo: ao final de um Flow Builder de qualificação, o nó Enviar contrato emite o documento e segue para uma etapa de cobrança no sucesso. Dicas, limites e boas práticas - Use Criar quando quiser revisão humana antes do envio; use Enviar quando o fluxo já estiver validado e puder ir direto para a assinatura. - Em Automações e Macros, as ações degradam em silêncio: se o módulo estiver desabilitado, faltar template ou não houver contato no gatilho, a ação simplesmente não faz nada e registra uma linha de log [CONTRACTS_AUTOMATION] — nunca quebra o restante da regra/macro. - No Flow Builder, o mesmo problema não interrompe o fluxo: ele segue pela saída de falha, então sempre conecte esse caminho a um tratamento. - Garanta que os dados de origem (contato, documento, negócio) estejam preenchidos para o auto-preenchimento das variáveis funcionar bem. - Para a auto-assinatura da contratada, mantenha a empresa emissora correta (e o certificado A1 vigente, no caso de assinatura qualificada). Solução de problemas - A regra rodou mas o contrato não apareceu: provavelmente faltou template, faltou contato na conversa ou o módulo está desabilitado. Confira a linha [CONTRACTS_AUTOMATION] no log. - O contrato foi criado mas não enviado: a ação usada foi Criar a partir de template (fica em rascunho). Use Enviar a partir de template para emitir e enviar de uma vez. - O fluxo seguiu pela saída de falha: leia o motivo — contracts_not_enabled (módulo off), contracts_template_missing (template não definido), contracts_no_contact (sem contato) ou send_contract_failed (erro no envio). - O signatário não recebeu o link: confirme que há uma conversa vinculada e que o canal (WhatsApp/e-mail) e os dados de contato estão corretos. Veja também - Visão geral de Contratos e Assinatura Eletrônica - Templates, variáveis e auto-preenchimento - Assinatura interna e externa - Empresas emissoras e certificado digital A1
Configurações do módulo e tema do documento
Visão geral A área de Configurações de Contratos concentra dois grupos de ajustes da conta: os padrões do módulo — valores aplicados aos novos contratos (nível de assinatura, idioma, validade do link, retenção e região) — e a identidade visual dos documentos, definida no designer de tema. No mesmo lugar você carrega o certificado A1 da conta (para a assinatura qualificada) e o logo do cabeçalho dos contratos. As configurações são únicas por conta (um conjunto por conta): o que você define aqui vira o padrão para todos os contratos, e cada contrato pode ajustar pontos específicos caso a caso. Pré-requisitos - Módulo de Contratos habilitado para a conta. - Para editar as configurações, é preciso ter permissão de administrador. Agentes têm acesso somente de leitura (podem visualizar, mas não alterar). - Para usar o nível qualificado, tenha um certificado A1 (.pfx/.p12) vigente e a sua senha — na conta e/ou na empresa emissora. - Para o logo, um arquivo PNG ou JPEG (são os formatos renderizados no PDF). Passo a passo 1. Em Contratos, abra a seção de Configurações. 2. Ajuste os padrões do módulo (nível de assinatura, idioma, validade do link, retenção, região e política de lembretes). 3. (Opcional) Carregue o certificado A1 da conta para habilitar a assinatura qualificada por padrão. 4. Defina a identidade visual: faça o upload do logo do cabeçalho ou reutilize um logo já existente (de uma empresa emissora ou da Biblioteca de Mídia). 5. Abra o designer de tema e ajuste cores, fontes, página, rodapé e assinaturas. 6. Use a pré-visualização ao vivo: a plataforma gera um PDF de amostra com o tema atual, sem salvar nada. 7. Salve. Os ajustes passam a valer para os próximos contratos. Configurações & opções Padrões do módulo | Configuração | O que faz | Padrão | |---|---|---| | Nível de assinatura padrão | Nível aplicado a novos contratos: simples, avançado (com OTP) ou qualificado (A1). | Simples | | Idioma padrão | Idioma do documento gerado. | Inglês | | Validade padrão do link | Dias até o link de assinatura expirar. | 30 dias | | Retenção de documentos | Por quantos anos os documentos assinados ficam guardados. | 5 anos | | Região / marco legal | Região que define o enquadramento legal e a retenção aplicada. | BR | | Política de lembretes | Habilita lembretes automáticos para signatários pendentes e, opcionalmente, vincula uma sequência de follow-up. | Habilitada | Esses são apenas os valores padrão: a plataforma parte das configurações de código e aplica por cima o que você definiu na conta. Ao gerar um contrato, você ainda pode ajustar o nível e os demais pontos individualmente. Certificado A1 da conta Para a assinatura qualificada (ICP-Brasil), é necessário um certificado digital A1 — um arquivo .pfx/.p12 protegido por senha. Você pode carregar um certificado A1 na conta, que funciona como padrão para a operação. Cada empresa emissora também pode ter o seu próprio A1, que prevalece nos contratos emitidos por ela. - O certificado é um dado sensível: é guardado de forma protegida e nunca é exibido de volta em tela. - O certificado A3 (token/cartão em hardware) não é suportado nesta versão — apenas o A1 (arquivo). Identidade visual e logo do cabeçalho O logo que aparece no cabeçalho do contrato segue uma cascata, de cima para baixo: 1. Logo da empresa emissora (se a empresa do contrato tiver um logo próprio). 2. Logo padrão da conta (o que você define aqui nas Configurações). 3. Logo do tema (uma URL externa de logo configurada no designer de tema). O logo padrão da conta pode ser enviado por upload (arquivo) ou reutilizado a partir de um logo já existente — por exemplo, o logo de uma empresa emissora ou um arquivo da Biblioteca de Mídia — sem precisar reenviar os bytes. Ao remover o logo da conta, o cabeçalho volta a usar o logo da empresa ou a URL do tema. O logo é mantido separado do tema em JSON. Designer de tema do documento O designer de tema controla toda a aparência do PDF. O tema efetivo é resolvido como uma cascata: padrão do sistema ← conta ← empresa emissora ← template ← ajustes não salvos do designer. Quando um contrato é enviado, o tema é congelado no documento, de modo que um contrato já assinado nunca muda de aparência depois. Você ajusta, entre outros: - Cabeçalho: posição do logo e exibir/ocultar nome, documento (CNPJ/CPF) e endereço da empresa. - Marca e cores: cor primária, secundária, de destaque, de títulos e de texto; fonte (Helvetica, Times ou Courier) e tamanhos do corpo e do título. - Página: tamanho (A4 ou Carta), orientação, margens, borda e marca d'água. - Rodapé: numeração de página (posição e formato) e aviso legal. - Assinaturas: layout, ordem dos papéis, exibir testemunhas e mostrar o selo A1. A pré-visualização ao vivo renderiza um PDF de amostra (com empresa de exemplo, cláusulas estilizadas, tabela de itens e um conjunto completo de assinaturas) sem salvar nada. Se você indicar uma empresa e/ou um template, o preview reflete a cascata completa, exatamente como sairia em um envio real. Se a geração falhar, o preview degrada para um aviso de uma página — ele nunca deixa de responder. Casos de uso - Padronizar o visual de todos os contratos com a sua marca (cores, fonte e logo). - Habilitar o nível qualificado por padrão em uma operação que sempre exige A1. - Ajustar a validade do link e a política de lembretes para acelerar o fechamento. - Manter logos diferentes por empresa emissora, com o logo da conta como fallback. Dicas, limites e boas práticas - Mantenha o certificado A1 vigente — um certificado expirado impede novas assinaturas qualificadas. - Confira a aparência no preview antes de enviar: o tema de um contrato enviado fica congelado e não muda depois. - Use cores em hexadecimal e mantenha a fonte entre Helvetica, Times ou Courier (sempre seguras no PDF). Logos em PNG ou JPEG. - Apenas administradores alteram estas configurações; agentes têm acesso somente de leitura. Solução de problemas - Não consigo editar as configurações: você precisa de permissão de administrador; agentes só visualizam. - A pré-visualização aparece como um aviso de "indisponível": a geração da amostra falhou; tente novamente e revise os ajustes do tema. - O logo não aparece no contrato: confira a cascata (empresa → conta → URL do tema) e use um arquivo PNG/JPEG válido. - A assinatura qualificada está indisponível: confirme que há um A1 válido na conta ou na empresa emissora selecionada. Veja também - Visão geral de Contratos e Assinatura Eletrônica - Empresas emissoras e certificado digital A1 - Templates, variáveis e auto-preenchimento - Assinatura interna e externa - Página pública do contrato e validador
Configurar as mensagens de contratos
Visão geral Os contratos enviam duas mensagens ao cliente: o pedido de assinatura e a confirmação de assinado. Aqui você personaliza o corpo de cada uma por idioma, sem depender de IA. O que não personalizar continua usando a mensagem embutida da Conversa Labs. Além do corpo, você edita os rótulos auxiliares da mensagem e configura, para cada tipo de mensagem e cada idioma, o modelo aprovado do WhatsApp usado quando a janela de 24h está fechada. Pré-requisitos - Contratos habilitado na conta e permissão de administrador. - Para configurar o envio fora da janela: uma caixa de entrada de WhatsApp Cloud com modelos aprovados na Meta. Passo a passo 1. Abra Contratos → Configurações → Mensagens. 2. Escolha o idioma no seletor do topo. Ele abre no idioma da conta e lista todos os idiomas habilitados na instalação (até 40), mostrando quantos já têm texto seu ("N de M idiomas com conteúdo"). 3. Escreva o corpo do pedido de assinatura e da confirmação em Markdown. Vazio = mensagem padrão do idioma (selo Padrão). 4. Use as variáveis ({x}) para inserir dados do contato, da conta e do próprio contrato. O seletor oferece apenas as variáveis que realmente resolvem naquela mensagem. 5. Abra o bloco Rótulos auxiliares para ajustar os 3 rótulos (legendas e texto do botão). 6. O bloco Fora da janela de 24h (WhatsApp Cloud) aparece aberto, logo abaixo de cada tipo de mensagem. Escolha o modelo aprovado daquele tipo naquele idioma, mapeie os parâmetros {{1}}, {{2}}… e preencha o botão de link, se houver. Se ainda não houver um modelo, use Criar a partir do meu texto para gerá-lo a partir do corpo que você escreveu. 7. Confira a prévia por canal, use Enviar teste se quiser validar numa conversa real e clique em Salvar mensagens — inclusive depois de criar um modelo, porque criar o modelo não grava a configuração. Restaurar padrão remove a personalização no servidor, não só na tela. Configurações & opções Idiomas e fallback O idioma é um seletor com todos os idiomas habilitados na instalação. No envio, a Conversa Labs procura o texto nesta ordem: idioma do contato → mesmo idioma-base (pt_BR ↔ pt) → idioma da conta → mensagem padrão embutida. Rótulos auxiliares São 3 rótulos (legendas e o texto do botão), num bloco recolhível abaixo do corpo. Seguem as mesmas regras de idioma e de restauração. Fora da janela de 24h (WhatsApp Cloud) O bloco aparece aberto e embutido logo abaixo de cada tipo de mensagem — não é uma seção que você precisa expandir. O modelo é por tipo de mensagem e por idioma — pedido e confirmação têm o seu, em vez de um único modelo para o módulo inteiro. Nele você tem: - Escolher o modelo aprovado entre os do catálogo. - Sincronizar da Meta e Criar a partir do meu texto ficam sempre visíveis. Quando a ação não está disponível, o botão aparece desabilitado com o motivo escrito ao lado: a caixa não é WhatsApp Cloud, a conta não tem o WhatsApp Inbox Suite, ou o seu perfil não gerencia caixas de entrada. - Sincronizar da Meta atualiza a lista de modelos aprovados. - Criar a partir do meu texto gera o modelo a partir do texto daquele tipo naquele idioma, enviando-o à Meta como modelo UTILITY, convertendo cada {{ variável }} em {{1}}, {{2}}… e já deixando o mapeamento pronto. Sem texto para gerar, o botão fica desabilitado e a tela pede para escrever o texto primeiro. - Depois do envio, o modelo ainda não está aprovado: ele aparece no seletor marcado como aguardando aprovação e só passa a entregar quando a Meta aprovar e você sincronizar. Enviar de novo com o mesmo nome substitui o rascunho pendente, em vez de falhar. - Criar o modelo não salva a configuração — clique em Salvar mensagens para gravar o mapeamento. - Mapeamento dos parâmetros {{n}} e o campo do botão de link — ideal para levar o cliente direto ao link de assinatura. - Entrega: escolhe de qual caixa do WhatsApp o catálogo de modelos aprovados é consultado. O envio continua saindo pela caixa da própria conversa. Tudo que depende dessa caixa — por que sincronizar/criar está indisponível, quantos modelos ficaram de fora, o link para gerenciá-los e o botão Sincronizar da Meta — aparece uma vez ali, e não repetido embaixo de cada mensagem. - Botão nativo "Assinar": o pedido de assinatura sai com um botão de verdade no WhatsApp (Cloud e Web). Antes o link ia como uma segunda linha de texto solta — o botão que a tela prometia nunca chegou ao cliente. Você desliga em Entrega → Botões nativos; o texto do botão e a linha acima dele continuam editáveis em Rótulos auxiliares, por idioma. Modelos cujo cabeçalho exige mídia ou uma variável não entram nesta lista — este envio não tem como preencher esse cabeçalho — e a tela informa quantos ficaram de fora. Eles continuam utilizáveis pela aba Modelos da própria caixa de entrada, com link direto a partir desta tela. Observações: WhatsApp Web (WazMeow) não tem janela de 24h (o bloco nem aparece); 360dialog pode selecionar um modelo, mas não criar; a Meta casa nome + idioma + aprovado, então um modelo no idioma errado é sinalizado na tela e seria recusado no envio. Prévia e envio de teste A prévia é renderizada no servidor, por canal, e mostra só os canais que a conta realmente tem. Também exibe o modelo resolvido para fora da janela, com os valores que cada parâmetro vai carregar. O Enviar teste manda a mensagem para uma conversa escolhida respeitando a janela de 24h: com a janela fechada e sem modelo configurado, o teste é pulado com o motivo escrito na tela. Variáveis de contrato Além de contato, conta, conversa, caixa de entrada, agente, CRM e organização — que agora renderizam de verdade —, estas mensagens oferecem os dados do contrato: | Variável | Substituída por | |---|---| | {{ contract.title }} | Título do contrato | | {{ contract.status }} | Situação atual | | {{ contract.signature_tier }} | Nível de assinatura exigido | | {{ contract.expires_at }} | Prazo para assinar | | {{ contract.counterparty }} | Contraparte | | {{ contract.sign_url }} | Link para assinar | | {{ contract.verification_url }} | Link de verificação do documento | Relação com as configurações do módulo Estas mensagens são distintas das configurações do módulo (assinatura padrão, retenção, certificado A1) — aqui você mexe só no texto ao cliente. Dicas, limites e boas práticas - Markdown por canal: anexos somem em LINE/TikTok/X; HTML some no e-mail/widget; *negrito* no WhatsApp vira um par de asteriscos. - Configure o modelo fora da janela no mesmo idioma do corpo — são pares, não uma configuração única. - No pedido de assinatura, inclua sempre {{ contract.sign_url }} (ou use-o no botão de link do modelo) e o prazo em {{ contract.expires_at }}. - Depois de "Criar a partir do meu texto", o modelo fica aguardando aprovação na Meta — use Sincronizar da Meta para ver quando ele for aprovado e passar a entregar. Solução de problemas - Saiu no padrão: o tipo estava vazio (selo Padrão) naquele idioma, ou o idioma do contato não tem texto e o fallback chegou ao padrão embutido. - Fora da janela não enviou: confirme o modelo aprovado daquele tipo naquele idioma. - O modelo aparece sinalizado: está num idioma diferente do da mensagem — troque por um aprovado no idioma certo. - "Criar a partir do meu texto" está desabilitado: o motivo aparece escrito ao lado do botão — a caixa não é WhatsApp Cloud (em 360dialog você escolhe um modelo já aprovado), a conta não tem o WhatsApp Inbox Suite, seu perfil não gerencia caixas de entrada, ou não há texto naquele tipo e idioma para gerar o modelo. - Criei o modelo, mas ele não aparece / não é usado: logo após o envio ele fica aguardando aprovação — só entrega depois que a Meta aprovar e você usar Sincronizar da Meta. E confirme que clicou em Salvar mensagens: criar o modelo não grava a configuração. - Não encontro um modelo na lista: modelos com cabeçalho de mídia ou com variável no cabeçalho não são listados aqui; use-os pela aba Modelos da própria caixa de entrada. - O envio de teste foi pulado: a conversa estava fora da janela de 24h e a mensagem não tinha modelo configurado — a tela informa o motivo. Veja também - Configurações do módulo de Contratos - WhatsApp Inbox Suite: Templates, Flows e Chamadas