Workflows — Automation Builder (Construtor de Automações)
Seção Albato: Automações → Construtor URL:
/bundle(dentro do iframe Albato)
1. Estrutura da Automação
1.1 Cabeçalho
| Elemento | Descrição |
|---|---|
| Nome | "Automação #XXXXXX" (numeração automática) |
| ID | Identificador único (ex: "762136/384576") |
| Grupo | Dropdown para organizar em grupos (default: "Sem grupo") |
1.2 Tabs do Builder
| Tab | Descrição |
|---|---|
| Construtor | Canvas visual de construção do workflow (default) |
| Histórico | Logs de execuções passadas |
| Análises | Métricas e estatísticas de uso |
2. Canvas Visual (Construtor)
2.1 Tecnologia
- React Flow — Biblioteca de diagramas interativos
- Mini mapa — Navegação do canvas para workflows grandes
- Suporte a teclado: Setas para mover nós, Delete para remover, Escape para cancelar
2.2 Nodes do Canvas
Gatilho (Trigger)
┌──────────────────────────────────────┐
│ Adicionar um gatilho │
│ 1. Este evento acionará uma │
│ automação │
└──────────────────────────────────────┘| Propriedade | Descrição |
|---|---|
| Posição | Primeiro nó do workflow |
| Função | Define o evento que inicia a automação |
| Obrigatório | Sim (apenas 1 por automação) |
Ação (Action)
┌──────────────────────────────────────┐
│ Adicionar ação │
│ 2. Será executado no seu sistema │
└──────────────────────────────────────┘| Propriedade | Descrição |
|---|---|
| Posição | Após o gatilho |
| Função | Operação executada em resposta ao gatilho |
| Múltiplas | Sim (quantas quiser) |
2.3 Conexões (Edges)
- Linhas direcionais conectando nós
- Representam o fluxo de dados entre trigger → actions
- Suportam condições e ramificações
3. Painel: Configurar um Gatilho
Ao clicar em "Adicionar um gatilho", abre um painel lateral:
3.1 Estrutura do Painel
| Seção | Descrição |
|---|---|
| Título | "Configurar um gatilho" |
| Subtítulo | "Escolha um aplicativo que envie os dados, e especifique o evento que inicia a automação." |
3.2 Campos
| Campo | Tipo | Descrição |
|---|---|---|
| Escolha uma app | Textbox + busca | "Buscar ferramenta" — seleciona o app de origem |
| Escolha um evento | Dropdown "Selecionar Evento" | Evento específico que dispara a automação |
| Hint do evento | Texto | "Este é um evento que aciona a transferência de dados. Por exemplo: quando um negócio muda, surge uma novo lead, etc." |
| Parâmetros da Chave de Acesso | Seção | Configurações de autenticação do app |
3.3 Ações
| Ação | Descrição |
|---|---|
| Continuar | Button (desabilitado até configurar app + evento) |
| Fechar | Ícone X para cancelar |
4. Painel: Configurar uma Ação
Similar ao painel de gatilho, mas para definir a operação de saída:
| Campo | Descrição |
|---|---|
| Escolha uma app | App de destino |
| Escolha uma ação | Operação específica (criar, atualizar, enviar, etc.) |
| Mapeamento de campos | Vincula dados do trigger aos campos da ação |
| Parâmetros da Chave de Acesso | Autenticação do app de destino |
5. Barra Inferior (Canvas, Teste, Executar)
| Botão | Descrição |
|---|---|
| Canvas | Modo de edição visual (default) |
| Teste | Executa a automação em modo de teste com dados de exemplo |
| Executar | Ativa/desativa a automação em produção |
6. Cenários (Scenarios)
| Elemento | Descrição |
|---|---|
| Nome | "Default" — cenário padrão |
| Múltiplos cenários | Permite criar variações do mesmo workflow |
| Seletor | Dropdown para alternar entre cenários |
Cada cenário pode ter diferentes configurações de trigger/actions para o mesmo workflow base.
7. Tabs: Histórico e Análises
7.1 Histórico
- Log cronológico de execuções
- Status de cada execução (sucesso, falha, em andamento)
- Dados de entrada/saída de cada execução
7.2 Análises
- Métricas de uso da automação
- Taxa de sucesso/falha
- Volume de execuções por período
8. Fluxo de Criação de Automação
1. Criar Automação → Nome automático (#XXXXXX)
2. Opcional: Atribuir a um Grupo
3. Canvas: Adicionar Gatilho
├── Escolher App (ex: WhatsApp, Gmail, HubSpot)
├── Escolher Evento (ex: Nova mensagem, Novo email, Novo contato)
└── Continuar
4. Canvas: Adicionar Ação(es)
├── Escolher App de destino
├── Escolher Ação (ex: Criar contato, Enviar email, Atualizar planilha)
├── Mapear campos (vinculação de dados)
└── Continuar
5. Adicionar mais ações e/ou condições
6. Criar cenários alternativos (opcional)
7. Testar → Executar → Ativar9. Atalhos de Teclado (Canvas)
| Tecla | Ação |
|---|---|
| Setas | Mover nó selecionado |
| Delete | Remover nó ou conexão |
| Escape | Cancelar seleção/ação |
| Enter/Espaço | Selecionar nó ou conexão |