Package Information
Documentation
Thais™ Assinatura para n8n
O node Thais™ Assinatura integra a Autentique ao n8n para criar documentos, gerenciar signatários, organizar pastas e receber atualizações de assinatura. A comunicação usa diretamente a API GraphQL oficial da Autentique; nenhuma chave é gravada em arquivo pelo pacote. [1]
Instalação
No n8n, acesse Configurações → Community Nodes → Instalar e informe:
n8n-nodes-thais-au
Depois, crie a credencial Thais™ Assinatura usando a chave obtida em Autentique → Perfil → Chaves de API. A chave é enviada no cabeçalho Authorization: Bearer …. [1]
Nós incluídos
| Nó | Finalidade |
|---|---|
| Thais™ Assinatura | Cria e administra documentos, signatários, pastas, organizações e modelos de e-mail. Também permite uma chamada GraphQL autenticada para recursos não tipados. |
| Thais™ Assinatura Trigger | Recebe eventos enviados pela Autentique, como documento criado, atualizado, concluído, assinatura visualizada, aceita ou recusada. |
Criar documento para assinatura
Use o recurso Documentos → Criar Documento para Assinatura. Forneça uma propriedade binária de um nó anterior, o nome do documento e ao menos um signatário.
Por padrão, o node cria documentos com as seguintes políticas:
| Configuração | Valor padrão | Motivo |
|---|---|---|
| Permitir recusa | Não | O documento não será configurado como recusável. |
| Ordem obrigatória de assinatura | Não | Os participantes podem assinar sem ordem fixa. |
| Assinatura qualificada | Não | Não ativa assinatura qualificada automaticamente. |
| Distribuição por WhatsApp | Não | O pacote devolve links individuais; a distribuição é controlada pelo workflow. |
O retorno traz document_id, status: "documento_criado", os dados do documento e signature_links, contendo o link individual de cada participante quando disponível. Trate esses links como informações confidenciais, pois eles dão acesso à assinatura do destinatário. [2]
A Autentique exige upload GraphQL multipart para criar documentos. Por isso, a operação principal recebe arquivo binário de um nó anterior e não uma URL externa como se ela fosse arquivo. [2]
Seleções pesquisáveis
Documentos, pastas e signatários são campos pesquisáveis e também permitem colar um ID retornado por outro nó. Organizações e modelos de e-mail são carregados em dropdown diretamente da conta configurada.
Trigger e webhooks
Crie o Thais™ Assinatura Trigger, copie sua URL de produção e cadastre-a no painel de desenvolvedor da Autentique, selecionando os eventos necessários. O trigger pode filtrar os eventos recebidos e validar a assinatura HMAC SHA-256 do cabeçalho x-autentique-signature usando a credencial opcional Autentique — Segredo do Webhook. A Autentique recomenda resposta rápida 2xx, tratamento de duplicidade e não assumir a ordem de entrega dos eventos. [3]
Chamada GraphQL Personalizada
O recurso Chamada GraphQL Personalizada recebe uma query ou mutation GraphQL completa e variáveis JSON. A mesma credencial do node é aplicada automaticamente. Use-o para endpoints da Autentique que ainda não possuem uma operação visual dedicada.
Limites e observações
A documentação da Autentique informa limite de 60 requisições por minuto. Para acompanhar assinaturas, prefira o Trigger/Webhook em vez de polling frequente. A API também pode restringir tamanho de arquivos conforme o plano contratado. [1] [3]
Referências
[1] Autentique — Introdução da API