Automações e Webhooks
O motor de Automações e Webhooks do Goldylocks permite-lhe criar fluxos de trabalho inteligentes que reagem automaticamente a eventos do sistema. Com esta ferramenta, pode desenhar processos automatizados que simplificam a operação diária e integram o Goldylocks com aplicações de terceiros.
As automações podem ser acedidas a partir do menu Gestão -> Tabelas -> Sistema -> Automações / Webhooks.
Ecrã principal de gestão e listagem de automações no Goldylocks.
Funcionalidades Principais
- Gatilhos (Triggers) Diversificados: Inicie fluxos através de eventos internos do sistema ou de chamadas de API externas.
- Editor Visual por Nós (Diagrama): Desenhe as suas automações de forma intuitiva arrastando, ligando e configurando os passos num canvas interativo.
- Gestão de Estados: Ative ou desative fluxos individualmente em qualquer altura através de um comutador rápido.
- Execuções em Simultâneo: Suporte para múltiplas automações a correr em simultâneo com controlo de fila de processamento.
- Ações Avançadas: Envio de emails, SMS, transformações de dados, condições lógicas e chamadas HTTP personalizadas.
Gestão e Monitorização
O painel de controlo das automações disponibiliza uma visão consolidada do estado geral das suas operações:
- Métricas em Tempo Real: Acompanhe o total de automações configuradas, fluxos ativos, volume de execuções nas últimas 24 horas e tarefas em fila de espera.
- Fila de Processamento: Monitorize o histórico e o estado detalhado de cada execução (Pendente, Em curso, Erro ou Sucesso) com registo de data e hora.
Monitorização detalhada das execuções em segundo plano.
O Editor de Fluxos (Canvas)
Para criar ou editar uma automação, o Goldylocks dispõe de um editor visual avançado baseado em diagramas. Pode desenhar o fluxo arrastando e ligando nós diretamente no ecrã.
Interface de edição visual e painel de definições.
Painel de Configuração (Esquerda)
- Nome e Descrição: Identificação funcional do fluxo.
- Retentativas (Retries): Número de tentativas que o sistema deve efetuar em caso de falha de um nó.
- Timeout (s): Tempo limite em segundos para a execução de cada ação.
- Estado: Comutador rápido para ativar/desativar a automação global.
Gatilhos Disponíveis (Triggers)
Qualquer automação inicia-se com um Trigger. O Goldylocks monitoriza eventos específicos na plataforma para despoletar a sequência de ações configurada.
Seleção do evento de início do fluxo.
Eventos de Sistema Suportados:
- Documento terminado (
fechardocumento): Despoleta a ação ao fechar ou concluir um documento. - Estado do documento alterado: Executado quando há transições nos estados de processamento.
- Documento criado / anulado: Reage de imediato à criação ou cancelamento de documentos.
- Cliente criado / actualizado: Sincronize dados de terceiros sempre que a ficha de cliente é modificada.
- Endpoint API chamado / Webhook público (URL externa): Permite que a automação seja executada através de uma chamada externa direta para o Goldylocks.
Tipos de Nós (Ações e Lógica)
Durante a criação do diagrama, pode interligar o gatilho inicial com múltiplos Nós de Fluxo para construir regras de negócio complexas.
Menu de seleção de tipos de nós disponíveis.
| Ícone | Tipo de Nó | Descrição |
|---|---|---|
| 🌐 | HTTP Request | Efetua chamadas HTTP (GET, POST, etc.) para endpoints e APIs externas (Webhooks). |
| 🔀 | Condição | Cria desvios lógicos com base em critérios ("Se isto... então aquilo..."). |
| 🔄 | Transformar | Permite manipular e transformar dados em formato JSON recorrendo a fórmulas. |
| 📄 | Log | Regista informações no histórico de execução para fins de depuração. |
| ✉️ | Enviar Email | Envia mensagens de email automatizadas e parametrizadas. |
| 💬 | Enviar SMS | Permite o envio automático de alertas por SMS de forma nativa. |
| ⚙️ | API Interna | Executa operações e comunicações internas dentro do próprio ecossistema Goldylocks. |
Configuração Avançada de Nós (Exemplo: HTTP Request)
Ao selecionar qualquer nó no Canvas de Fluxo, o painel direito abre as propriedades detalhadas para personalização desse passo. No caso do nó HTTP Request, as capacidades de integração são vastas:
Painel de parametrização avançada do nó HTTP Request.
Principais Opções de Configuração:
- Templates Rápidos: Modelos pré-definidos para preenchimento automático das configurações.
- Variáveis Dinâmicas: Injeção de dados contextuais do documento ou cliente em tempo real utilizando sintaxe dupla chaveta.
- Editor JSON Nativo: Escrita estruturada do corpo (Body) do pedido com destaque de sintaxe e tratamento de dados.
- Chave Secreta (HMAC-SHA256): Envio automático de uma assinatura de segurança no cabeçalho
X-Webhook-Signaturepara validação de integridade do lado do recetor. - Iteração em Arrays (Looping): Capacidade para iterar sobre listas (ex: linhas de artigos ou múltiplos documentos) e executar a ação repetidamente de forma automatizada.