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

[2] Autentique — Criar documento

[3] Autentique — Webhooks