> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://hoopdecor.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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](#3-como-funciona-a-integracao)
* [Como configurar o token e os dados da Autentique no HoopCRM](#3-como-configurar-no-hoopcrm)
* [Como configurar os webhooks na Autentique](#3-como-configurar-os-webhooks-na-autentique)
* [Como criar modelos de contrato](#3-como-criar-modelos-de-contrato)
* [Como gerar e enviar contratos para assinatura](#3-como-gerar-e-enviar-um-contrato-para-assinatura)
* [Observações importantes](#3-observacoes-importantes)

### Como funciona a integração
Você deve possuir sua própria conta na [Autentique](https://autentique.com.br/), 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**.
| ![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/screenshot1_zv4ifz.png) | ![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/screenshot2_cg7f6p.png) | ![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/screenshot3_1mm114t.png) |
| ---- |
> ⚠️ **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**".

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/token-do-autentique_36apoe.png =793xauto)

###### 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:

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/screenshot4_1ewuv1k.png =711xauto)
### Webhook 1: evento de assinatura
1. Na Autentique, acesse Configurações → Webhook.
2. Clique em "${color}[#248df0](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](https://docs.google.com/document/d/1L7ICilt_D86rWIXLEw1G00pIZAfxk3dty8kD1rGx0Rk/edit?usp=sharing).
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.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/peek1_89350f.gif =974xauto)

### Tags dinâmicas disponíveis
Você pode usar qualquer uma das tags abaixo diretamente no documento Word, no local onde os dados devem aparecer.
| Categoria | Tags |
| Cliente | `${cliente_nome}, ${cliente_cpf_cnpj}, ${cliente_endereco}, ${cliente_email}` |
| Escritório | `${escritorio_nome}, ${escritorio_cpf_cnpj}, ${escritorio_endereco}, ${escritorio_email} ` |
| Especificador | `${especificador_nome}, ${especificador_cpf_cnpj}, ${especificador_endereco}, ${especificador_email}` |
| Construtora | `${construtora_nome}, ${construtora_cpf_cnpj}, ${construtora_endereco}, ${construtora_email}` |
| Pedido | `${pedido_numero}, ${pedido_valor_total}` |
> ⚠️ **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.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/gerar-contrato_1prq7xo.gif =1053xauto)
|| Os campos "Número do pedido" e "Valor total do pedido" não tem possibilidade de edição.
> 💡 **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:

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/screenshot1_nzzic5.png =450xauto)

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:
| Aguardando Assinaturas | Parcialmente Assinado | Assinado |
| ---- |
| ![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/contrato-funil_1c2a692.png =360xauto) | ![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/parcialmente-assinado_j4jgxu.png =346xauto) | ![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/assinado-funil_4kc6mh.png =359xauto) |
> 💡 **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.

Ao clicar em "**Abrir no Autentique**", será aberto uma nova guia redirecionando diretamente para o contrato com as as assinaturas pendentes/realizadas:

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/screenshot1_jveerl.png =419xauto)

### 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.

|| Agora você aprendeu como integrar o HoopCRM com a Autentique, permitindo gerar contratos a partir de modelos, enviar para assinatura eletrónica e acompanhar todo o fluxo de assinaturas com mais controle e organização.