> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orquena.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Automações

> Limites entre o motor nativo de regras e o candidato externo Activepieces.

# Automações

A Nuvexa separa automações críticas de negócio de integrações visuais definidas pelo cliente.

## Motor nativo

O plugin first-party de Automations executará regras tenant-aware a partir de eventos, horários e webhooks.

Exemplos:

* Solicitar confirmação antes de um agendamento.
* Criar um lembrete.
* Abrir uma tarefa após qualificação de lead.
* Transferir uma conversa para humano.
* Desativar respostas automáticas após falhas repetidas.

Essas automações utilizam ações tipadas registradas pelos plugins e passam pelas mesmas permissões e validações dos comandos manuais.

## Activepieces

O **Activepieces** é o candidato principal para uma futura experiência visual de automação e integrações externas.

Características relevantes:

* Código TypeScript.
* Interface React e API Fastify.
* Workers e filas.
* Sandboxes de execução.
* Triggers por webhook e agendamento.
* Grande catálogo de peças de integração.
* Docker Compose para self-hosting.
* Código community MIT fora das áreas enterprise.

## Fronteira de responsabilidade

```text theme={null}
Regra crítica da Nuvexa
→ Automations plugin e domain workers

Integração visual com sistemas externos
→ Activepieces connector opcional
```

Activepieces poderá chamar APIs Nuvexa com credenciais e capabilities limitadas. Não terá acesso direto ao banco principal.

## Exemplos adequados para Activepieces

* Copiar agendamento concluído para planilha.
* Enviar notificação para Slack.
* Criar contato em ferramenta de marketing.
* Chamar webhook de sistema do cliente.
* Sincronizar lead qualificado com aplicativo externo.

## Exemplos que permanecem nativos

* Impedir conflito de agenda.
* Confirmar ou cancelar appointment.
* Persistir mensagem recebida.
* Autorizar ferramenta de IA.
* Aplicar billing e entitlements.
* Processar outbox transacional.

## Segurança

* Deployment e banco separados.
* Credentials criptografadas por organização.
* APIs Nuvexa allowlisted.
* Timeout e limite de payload.
* Idempotência para side effects.
* Detecção de loops.
* Correlação entre evento Nuvexa e execução externa.
* Aprovação humana para ações de alto risco.

## Licença

Activepieces segue modelo open-core. O código community é MIT fora dos diretórios enterprise, que possuem termos separados.

A Nuvexa não poderá tratar recursos enterprise como parte gratuita do connector sem licença específica.

## Critérios antes da adoção

* Self-hosting reproduzível.
* Custom piece Nuvexa com autenticação scoped.
* Retry sem duplicação.
* Disable por organização.
* Auditoria correlacionada.
* Backup e upgrade documentados.
* Revisão da licença para os recursos usados.

## Links oficiais

<CardGroup cols={2}>
  <Card title="Activepieces" icon="workflow" href="https://www.activepieces.com/docs">
    Documentação principal.
  </Card>

  <Card title="Arquitetura" icon="network" href="https://www.activepieces.com/docs/install/architecture/overview">
    App, worker, engine e sandbox.
  </Card>

  <Card title="Criar pieces" icon="blocks" href="https://www.activepieces.com/docs/build-pieces/overview">
    Extensões TypeScript.
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/activepieces/activepieces">
    Código, releases e licença.
  </Card>
</CardGroup>