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

# Visão Geral do Events

> Conecte o Workstation com qualquer sistema através de notificações em tempo real

**Events** é a solução de integração em tempo real do Workstation que conecta suas tasks automaticamente com qualquer sistema externo. Através de **webhooks**, você recebe notificações instantâneas sobre eventos importantes do **ciclo de vida** das suas tasks, permitindo construir **fluxos de trabalho automatizados** e integrados.

<CardGroup cols={2}>
  <Card title="Automatize Processos" icon="robot">
    Dispare ações em outros sistemas sem intervenção manual
  </Card>

  <Card title="Integre Workflows" icon="link">
    Conecte o Workstation com seus sistemas existentes
  </Card>

  <Card title="Monitore em Tempo Real" icon="gauge">
    Receba atualizações imediatas sobre o status das tasks
  </Card>

  <Card title="Construa Pipelines" icon="diagram-project">
    Crie fluxos de trabalho complexos entre múltiplas plataformas
  </Card>
</CardGroup>

## Eventos Disponíveis

<AccordionGroup>
  <Accordion title="Tasks Finalizadas" icon="circle-check">
    Disparado quando uma task é finalizada e está pronta para revisão
  </Accordion>

  <Accordion title="Tasks Aprovadas" icon="thumbs-up">
    Disparado quando uma task é aprovada
  </Accordion>
</AccordionGroup>

## Como Funciona?

O sistema de Events foi projetado para ser simples de configurar, mas extremamente confiável em produção:

### Configuração Simples

<Steps>
  <Step title="Defina seu endpoint">
    Informe a URL que receberá as notificações
  </Step>

  <Step title="Configure autenticação">
    Adicione headers customizados para autenticar suas requisições
  </Step>

  <Step title="Teste antes de ativar">
    Valide sua configuração com payloads reais antes de ir para produção
  </Step>
</Steps>

## Duas Abordagens Flexíveis

Oferecemos **duas formas flexíveis** de trabalhar com webhooks, permitindo que você escolha a melhor abordagem para cada caso de uso:

<Tabs>
  <Tab title="Interface Visual">
    ### Configuração Permanente via Interface

    **Ideal para**: Integrações de longo prazo, ambientes de produção, múltiplas equipes

    Configure seus webhooks visualmente através da interface do Workstation em poucos cliques e receba os eventos automaticamente:

    * ✅ **Interface intuitiva**: Configure tudo visualmente sem escrever código
    * ✅ **Gestão centralizada**: Veja e gerencie todas as suas integrações em um só lugar
    * ✅ **Headers fixos**: Configure tokens de autenticação e headers que serão enviados automaticamente
    * ✅ **Teste integrado**: Botão de teste permite validar sua configuração antes de ativar

    <Info>**Como acessar**: Configurações do App → Aba "Events" → Habilitar Eventos</Info>
  </Tab>

  <Tab title="API Dinâmica">
    ### Webhooks Dinâmicos via API

    **Ideal para**: Integrações SaaS multi-tenant, endpoints dinâmicos, integrações temporárias

    Envie notificações para endpoints diferentes a cada chamada, sem criar subscrições permanentes:

    * ⚡ **Flexibilidade total**: Cada chamada pode notificar um endpoint diferente
    * ⚡ **Zero configuração prévia**: Comece a usar imediatamente sem setup
    * ⚡ **Headers dinâmicos**: Passe credenciais diferentes para cada cliente/contexto
    * ⚡ **Multi-tenant nativo**: Perfeito para SaaS com múltiplos clientes
    * ⚡ **Webhooks temporários**: Útil para testes, demos ou integrações pontuais

    <Info>**Como usar**: Adicione `webhook_url` no body da sua chamada + headers `x-tela-forward-*` para autenticação</Info>
  </Tab>
</Tabs>

## Próximos Passos

<CardGroup cols={3}>
  <Card title="Configuração" icon="gear" href="/pt/workstation/events/configuration">
    Aprenda a configurar webhooks
  </Card>

  <Card title="Autenticação" icon="key" href="/pt/workstation/events/authentication">
    Proteja suas integrações
  </Card>

  <Card title="Referência de Payload" icon="file-code" href="/pt/workstation/events/payload-reference">
    Entenda o payload do webhook
  </Card>
</CardGroup>