Integração com a Autentique no HoopCRM

A integração com a Autentique permite que a sua loja gere contratos de venda em formato digital, envie-os para assinatura eletrônica e acompanhe todo o fluxo de assinaturas diretamente dentro do HoopCRM.

Neste artigo, você verá:

• Como funciona a integração entre o HoopCRM e a Autentique
• Como configurar o token e os dados da Autentique no HoopCRM
• Como configurar os webhooks na Autentique
• Como criar modelos de contrato
• Como gerar e enviar contratos para assinatura
• Observações importantes

Como funciona a integração

Você deve possuir sua própria conta na Autentique, fazendo com que a gestão de documentos fique mais organizada, pois cada loja terá o seu próprio painel com todos os seus contratos.
O fluxo funciona assim:

1. Acesse sua conta na Autentique e gere um Token.
2. Crie os webhooks na Autentique para que o HoopCRM receba as atualizações de status.
3. Envie os modelos de contrato para o Hoop (arquivos .docx) com as tags dinâmicas.
4. A partir de um negócio, a loja gera o contrato, revisa e envia para assinatura.
5. O HoopCRM acompanha o status das assinaturas em tempo real pelos webhooks.

💡 Dica: como os custos de assinatura são por loja, utilize o seu plano Autentique de acordo com o seu volume real de contratos para evitar cobranças inesperadas.

Como configurar

Na sua conta Autentique:

1. Acesse a engrenagem (Configurações) → Acesso API → Clique em "Gerar token".
2. Copie o token exibido em "Tokens ativos".
3. Depois, no HoopCRM, cole esse token no campo correspondente na tela de Contratos de Venda.

⚠️ Importante: o token é interno e sensível. Nunca compartilhe ou exiba esse token para terceiros, o vazamento do token compromete a segurança da sua conta Autentique.

No Hoop:

1. Acesse Meu Perfil → Loja → Contratos de venda.
2. Cole o Token copiado da autentique em "Token do Autentique".

E-mail da loja para assinatura

Todo contrato de venda enviado a um cliente também é enviado para a própria loja assinar. O campo "E-mail da loja para assinatura" define o e-mail que receberá o contrato junto com os demais signatários.
O mesmo comportamento vale para os demais tipos de negócio: em negócios com vários papéis, o e-mail é enviado para os signatários (cliente, arquiteto, especificador, construtora) e sempre para o e-mail da loja configurado neste campo.

💡 Exemplo: em um contrato de integração entre a Hoop e uma loja, o e-mail é enviado para o representante da Hoop e para o e-mail da loja que está entrando na plataforma.

Quem pode gerar contratos

Logo abaixo, defina quais funções da loja estão autorizadas a gerar contratos. Você pode habilitar ou desabilitar por função:

• Administrador: sempre autorizado (não pode ser desativado).
• Gerente, Vendedor e Financeiro: podem ser habilitados ou desabilitados conforme a necessidade da loja.

Depois de preencher os campos, clique em Salvar.

Como configurar os webhooks na Autentique

Os webhooks são a última etapa da configuração e ficam dentro do painel da Autentique. Você precisará criar dois endpoints (um para cada tipo de evento), ambos apontando para a mesma URL de webhook que o HoopCRM exibe na tela de Contrato de Venda.

URL de webhook no Hoop

Copie a URL que exibirá no campo abaixo:

Webhook 1: evento de assinatura

1. Na Autentique, acesse Configurações → Webhook.
2. Clique em "Adicionar endpoint" e dê um nome (por exemplo, "Hoop 1").
3. Cole a URL que copiou do Hoop em URL de webhook.
4. Mantenha o formato de payload em JSON.
5. Em tipo de evento, selecione Assinatura.
6. Marque os eventos: criado, atualizado, excluído, aceito e rejeitado.
7. Clique em Salvar.

Este webhook informa o HoopCRM sempre que uma assinatura muda de status (por exemplo, quando o cliente assina e fica faltando apenas a loja assinar).

Webhook 2: evento de documento finalizado

1. Crie um segundo endpoint com um nome diferente (por exemplo, "Hoop 2").
2. Cole a mesma URL do webhook anterior.
3. Mantenha o formato em JSON.
4. Em tipo de evento, selecione Documento.
5. Marque apenas o evento documento finalizado.

Este webhook informa o HoopCRM quando o documento é concluído, ou seja, quando todas as assinaturas foram recolhidas.

💡 Lembrete: os nomes dos endpoints são livres, você pode usar qualquer nome. O que importa são o tipo de evento e a URL correta do HoopCRM.

Como criar modelos de contrato

O que são modelos

Voltando ao Hoop para a área de configuração de contratos em Meu Perfil → Loja → Contratos de venda, todo contrato é gerado a partir de um modelo em formato .docx (documento Word). O documento contém o texto fixo do contrato e tags dinâmicas, que são campos marcados no texto que são substituídos automaticamente pelos dados reais do negócio no momento da criação do contrato.
A grande vantagem do formato .docx é que a formatação original é preservada: negrito, tamanho da fonte, cores e alinhamentos permanecem exatamente como no modelo enviado pela loja. O sistema substitui apenas o conteúdo, mantendo o padrão visual do seu documento.

Como criar um modelo

1. Primeiramente, crie um modelo de contrato (podendo utilizar até 4 por loja) em formato .docx.

💡 Dica: Temos um modelo de exemplo que traz todas as tags. Você pode utilizá-lo para ter novas ideias. Clique aqui para vê-lo: Modelo de Contrato Hoop.

2. Dê um nome ao modelo (por exemplo, "Contrato de Venda Padrão").
3. Informe uma categoria, este campo é apenas organizacional, para manter os modelos alinhados.
4. Envie o arquivo .docx com as tags dinâmicas inseridas no texto.
5. Confirme.

Tags dinâmicas disponíveis

Você pode usar qualquer uma das tags abaixo diretamente no documento Word, no local onde os dados devem aparecer.

⚠️ Atenção: se você usar uma tag de um papel que o negócio não possui (por exemplo, ${construtora_nome} em um negócio que só tem o cliente), o campo ficará em branco na geração do contrato. Monte o modelo de acordo com os papéis presentes no tipo de negócio em que ele será usado.

Como gerar e enviar um contrato para assinatura

Como acessar

1. Assim que criou o orçamento e gerou venda, você está apto a inserir o contrato.
2. Vá em Negócios → Funil → Acesse o funil desejado e entre na seção Venda Realizada.
3. Acesse o card do negócio e vá em "Gerar Contrato".

Passo 1: escolher o modelo

Serão exibidos todos os modelos de contratos que a loja salvou. Selecione então modelo desejado.

Passo 2: signatários

O sistema identifica automaticamente os signatários conforme os papéis presentes no negócio. Em um negócio com apenas o cliente, aparecerão o cliente e a loja (o e-mail da loja configurado assina sempre). Em negócios com mais papéis, podem aparecer também arquiteto, especificador e construtora.
Se o cadastro do signatário estiver incompleto, o sistema exibe um alerta pedindo para completar o cadastro antes de avançar. Os campos obrigatórios por signatário são:

• CPF ou CNPJ
• Nome completo
• E-mail
• Endereço

Passo 3: revisão

Na etapa de revisão, o sistema exibe os valores reais que substituirão as tags (nome do cliente, CPF, endereço, e-mail, número do pedido, valor total, etc.). Nesta etapa você pode:

• Atualizar a prévia: regenera a visualização do documento preenchido em tela.
• Baixar o arquivo: baixa a cópia fiel do contrato que será enviado.
• Editar os campos: ajuste manualmente qualquer valor exibido (por exemplo, substituir o nome) e atualize a prévia depois.

💡 Dica: a prévia em tela é aproximada, o arquivo baixado é a cópia fiel do que será assinado. Sempre instrua o cliente a baixar e validar o contrato antes do envio, pois a responsabilidade por um contrato enviado com erro é totalmente da loja.

Enviar para assinatura

Na última etapa, clique em Enviar para Assinatura. Antes de confirmar, o sistema exibe o seguinte aviso:

Após a confirmação, o contrato é enviado para o e-mail de todos os signatários e o status do negócio passa a "Aguardando assinaturas".

⚠️ Importante: depois do envio, não é possível cancelar o contrato pelo HoopCRM. Se precisar de algum ajuste, é necessário cancelar diretamente na Autentique (quando possível) ou gerar um novo contrato, um novo envio sempre cria um segundo contrato.

Como acompanha o status

No painel da Autentique (com o login da loja), o documento aparece em "Meus documentos", e os e-mails de assinatura são enviados automaticamente aos signatários. O signatário recebe o e-mail, acessa o documento e assina.
Conforme cada assinatura ocorre, o webhook de assinatura atualiza o status no HoopCRM, por exemplo, exibindo "cliente assinou, falta a loja assinar". A loja pode concluir a sua assinatura abrindo o documento diretamente no painel da Autentique (se não estiver logada, o sistema pede o login e depois redireciona para o documento). Quando todas as assinaturas são recolhidas, o webhook de documento finalizado conclui o contrato no HoopCRM.

Abaixo mostra a progressão de alguns status:

💡 Lembrete: a tela do HoopCRM não atualiza o status em tempo real. Para ver o status mais recente, feche e reabra a tela do negócio.

Observações importantes

• Cada loja usa a sua própria conta Autentique, com o seu próprio token e custos de uso.
• O token de API é sensível e nunca deve ser vazado.
• São necessários dois webhooks na Autentique: um para eventos de assinatura (criado, atualizado, excluído, aceito, rejeitado) e outro para o evento de documento finalizado.
• Os modelos devem ser arquivos .docx com as tags dinâmicas do HoopCRM.
• Tags de papéis que não existem no negócio ficam em branco na geração.
• Campos obrigatórios do signatário: CPF/CNPJ, nome, e-mail e endereço.
• O arquivo baixado é a cópia fiel do contrato; a prévia em tela é aproximada.
• Após o envio, não é possível cancelar pelo HoopCRM, um novo envio cria um segundo contrato.
• O status no HoopCRM atualiza ao recarregar a tela do negócio.

Atualizado em: 18/08/2026