Skip to main content
Custom nodes permitem executar lógica personalizada nos seus próprios servidores, integrando o Triglit completamente com sua infraestrutura.

O que são Custom Nodes?

Custom nodes são nodes que executam em seus próprios servidores via webhooks. Quando um custom node é executado:
  1. O Triglit faz uma requisição HTTP para seu endpoint
  2. Seu servidor processa a requisição
  3. Você retorna o resultado
  4. O Triglit continua a execução do workflow

Configuração

1. Registrar Custom Node

No dashboard do Triglit, registre seu custom node:

2. Configurar Endpoint

Seu endpoint deve aceitar requisições POST:

Estrutura da Requisição

Quando o Triglit chama seu custom node:

Estrutura da Resposta

Seu endpoint deve retornar:

Resposta de Erro

Autenticação

O Triglit envia autenticação no header:
Valide a assinatura:

Exemplo Completo

Node de Processamento de Pagamento

Usar no Workflow

Timeout e Retries

Timeout

Configure timeout no node:

Retries

O Triglit retenta automaticamente em caso de falha:

Idempotência

Torne seus custom nodes idempotentes:

Boas Práticas

Sempre valide dados de entrada antes de processar.
Torne nodes idempotentes para permitir retries seguros.
Configure timeouts realistas baseados na complexidade da operação.
Sempre retorne erros estruturados e informativos.
Logue todas as execuções para debugging e auditoria.
Valide assinaturas e use HTTPS sempre.

Limitações

  • Timeout máximo: 5 minutos por node
  • Tamanho de payload: 1MB
  • Retries: Máximo de 3 tentativas (configurável)
Para operações longas, considere retornar imediatamente e processar de forma assíncrona, notificando o Triglit via webhook quando concluído.