Ajuda e dicas de utilização

Como começar

1

Escolha um pack com valor claro

Comece por integração entre sistemas, automação interna ou pipeline simples de dados. O importante é ter uma entrada e uma saída fáceis de validar.

2

Defina a entrada

Pense no que deve iniciar o processo: um webhook, uma agenda, um email, uma fila ou um pedido de API.

3

Prepare os dados

Use mappings e regras simples para garantir que a saída fica pronta para o sistema de destino.

4

Teste com exemplos reais

Antes de ativar, valide o comportamento com payloads ou ficheiros parecidos com os que existem em produção e acompanhe a primeira execução até ao fim.

Onde pedir ajuda dentro do produto

Centro de Ajuda: existe uma área de ajuda interna para navegar por tópicos sem sair da aplicação.
Workflows Help: há uma referência por tipos de step e metadata para configuração mais técnica.
AI Assistant: o assistente pode responder sobre o domínio SelfInt e sugerir exemplos de configuração.

Onde validar operação

Execuções: para ver estado, correlação, origem e erro do workflow.
Kafka Monitoring: para auditar eventos Kafka e ligar mensagens a uma execução.
Queues e DLQ: para perceber backlog, falhas e reprocessamentos.

Marketplace e starter packs

O produto já expõe um Marketplace autenticado com packs prontos para acelerar arranque, onboarding e evolução de processos.

No Marketplace pode descobrir soluções por caso de uso e instalar rapidamente.
Os packs prontos ajudam a arrancar sem começar do zero.
Pode adaptar cada pack ao contexto real de dados e integrações da sua equipa.
Um pack bem apresentado deve incluir overview, highlights, imagens, recursos, compatibilidade, requisitos e detalhe operacional, para que o utilizador perceba a solução antes de instalar.
O objetivo do Marketplace não é apenas servir ficheiros: é funcionar como catálogo de soluções do Selfint, com contexto suficiente para avaliação, confiança e onboarding.

Dicas úteis

Estas recomendações ajudam a evitar retrabalho e incidentes desnecessários.

Dê nomes claros

Use nomes que expliquem o objetivo do workflow.
Faça o mesmo com conexões, credenciais e presets de ficheiros.

Separe responsabilidades

Evite workflows demasiado grandes quando puder dividir por etapas.
Uma integração clara é mais fácil de operar e corrigir.

Acompanhe as execuções

Verifique os estados com regularidade.
Use filas de erro e reprocessamento de forma controlada.

Use AI com objetivo claro

Peça à AI para tarefas concretas como extrair campos, classificar ou estruturar resposta.
Quando a decisão for sensível, use guard rails e revisão humana.

Exemplo prático: usar dados de outro step (nao anterior direto)

No step JavaScript, pode buscar dados de qualquer step anterior usando expressoes como ${steps.LIBAX_COMPANY.output.results.0.name}, sem depender apenas do passo imediatamente anterior.

Exemplo de configuracao (resumo):

{
  "value": "${steps.LIBAX_COMPANY.input}",
  "context": {
    "companyName": "${steps.LIBAX_COMPANY.output.results.0.name}"
  },
  "expression": {
    "language": "javascript",
    "code": "const contract = value && typeof value === 'object' ? { ...value } : {};\nconst name = context?.configContext?.companyName == null ? null : String(context.configContext.companyName).trim();\nif (name) contract.companyName = name;\nreturn contract;"
  }
}

Pontos críticos

Use indexacao por ponto: results.0.name (em vez de results[0].name).
Dentro do script, os campos de context sao lidos em context.configContext.
value deve apontar para o payload de trabalho que queres transformar.

Resultado esperado: o output do step passa a incluir, por exemplo, companyName preenchido com o valor vindo do step referenciado.

Perguntas frequentes

Preciso de ser técnico para usar?

Não para perceber o processo e operar o dia a dia. Para configurações mais avançadas pode ser útil apoio de administração ou desenvolvimento.

O Selfint só serve para APIs?

Não. Também trabalha com ficheiros, agendas, webhooks, email, filas internas e mensagens em brokers.

O que acontece quando algo falha?

As execuções ficam registadas, a falha pode ser analisada e muitos casos permitem reprocessamento ou isolamento em DLQ.

Consigo controlar quem vê o quê?

Sim. O produto permite separar acessos por perfis e contexto de utilização.

As credenciais ficam seguras?

O Selfint centraliza credenciais e conexões, evitando expor segredos em vários pontos de configuração.

Dá para adaptar à minha realidade?

Sim. A plataforma suporta regras por cliente, workflows diferentes e conectividade para vários tipos de integração.

Se surgir um problema, veja primeiro

Se a trigger certa está ativa.
Se a conexão e a credencial usadas continuam válidas.
Se a execução falhou num passo específico e qual foi a mensagem de erro.
Se o evento passou pelo monitoring Kafka quando a origem ou o destino usam tópicos.
Se existe algo pendente numa fila ou DLQ.
Se o cliente ou o plano atingiu algum limite de uso.